ryansechrest

PHP Style Guide

All rules and guidelines in this document apply to PHP files unless otherwise noted. References to PHP/HTML files can be interpreted as files that primarily contain HTML, but use PHP for templating purposes.

The keywords "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC 2119.

Most sections are broken up into two parts:

1. Overview of all rules with a quick example
2. Each rule called out with examples of do's and don'ts

wojteklu

Code is clean if it can be understood easily – by everyone on the team. Clean code can be read and enhanced by a developer other than its original author. With understandability comes readability, changeability, extensibility and maintainability.

---

General rules

1. Follow standard conventions.
2. Keep it simple stupid. Simpler is always better. Reduce complexity as much as possible.
3. Boy scout rule. Leave the campground cleaner than you found it.
4. Always find root cause. Always look for the root cause of a problem.

Design rules

borjao-dev

Manifesto Pessoal de Programação — COMPLETO

Um guia consolidado de princípios, processos, arquitetura e boas práticas — da concepção do problema até o código em produção. Escrito para ser consultado, não decorado.

Baseado em anotações de estudo acumuladas ao longo da carreira (originalmente com foco em PHP/Laravel), reorganizadas e generalizadas para programação em geral.

Nota sobre a natureza deste documento: o que segue são escolhas pragmáticas de um autor específico, não verdades absolutas nem consenso universal da indústria. Em vários pontos existem escolas de pensamento divergentes igualmente válidas (ex.: quando aplicar SOLID, qual ordem seguir ao construir um sistema). Onde isso for especialmente relevante, o texto sinaliza explicitamente — mas a regra geral vale para o documento inteiro: trate como um ponto de partida sólido para pensar, não como dogma a seguir cegamente.

---