This guide extends and expands the basic coding standard PSR-1.

The intent of this guide is to reduce cognitive friction when scanning code from different authors. It does so by enumerating a shared set of rules and expectations about how to format PHP code.

• The code MUST follow PSR-1.
• the code MUST use 4 spaces for indenting, not tabs.
• There MUST NOT be a hard limit on line length; the soft limit MUST be 120 characters; lines SHOULD be 80 characters or less.
• There MUST be one blank line after the namespace declaration, and there MUST be one blank line after the block of use declarations.
• Opening braces for classes MUST go on the next line, and closing braces MUST go on the next line after the body.
• Opening braces for methods MUST go on the next line, and closing braces MUST go on the next line after the body.
• Visibility MUST be declared on all properties and methods; abstract and final MUST be declared before the visibility; static MUST be declared after the visibility.
• Control structure keywords MUST have one space after them; method and function calls MUST NOT.
• Opening braces for control structures MUST go on the same line, and closing braces MUST go on the next line after the body.
• Opening parentheses for control structures MUST NOT have a space after them, and closing parentheses for control structures MUST NOT have a space before.

This example encompasses some of the rules below as a quick overview: <PHP> <?php namespace Vendor\Package;

use FooInterface; use BarClass as Bar; use OtherVendor\OtherPackage\BazClass;

class Foo extends Bar implements FooInterface {

  public function sampleFunction($a, $b = null)
  {
      if ($a === $b) {
          bar();
      } elseif ($a > $b) {
          $foo->bar($arg1);
      } else {
          BazClass::bar($arg2, $arg3);
      }
  }

  final public static function bar()
  {
      // method body
  }

} </PHP>

The code MUST follow all rules outlined in PSR-1.

• All PHP files MUST use the Unix LF (linefeed) line ending.
• All PHP files MUST end with a single blank line.
• The closing ?> PHP tag MUST be omitted from files containing only PHP.

• There MUST NOT be a hard limit on line length.
• The soft limit on line length MUST be 120 characters; automated style checkers MUST warn but MUST NOT error at the soft limit.
• Lines SHOULD NOT be longer than 80 characters; lines longer than that SHOULD be split into multiple subsequent lines of no more than 80 characters each.
• There MUST NOT be trailing whitespace at the end of non-blank lines.
• Blank lines MAY be added to improve readability and to indicate related blocks of code.
• There MUST NOT be more than one statement per line.

Code MUST use an indent of 4 spaces, and MUST NOT use tabs for indenting.

Using only spaces, and not mixing spaces with tabs, helps to avoid problems with diffs, patches, history, and annotations. The use of spaces also makes it easy to insert fine-grained sub-indentation for inter-line alignment.

• PHP keywords MUST be in lower case.
• The PHP constants true, false, and null MUST be in lower case.

• When present, there MUST be one blank line after the namespace declaration.
• When present, all use declarations MUST go after the namespace declaration.
• There MUST be one use keyword per declaration.
• There MUST be one blank line after the use block.

For example: <PHP> <?php namespace Vendor\Package;

use FooClass; use BarClass as Bar; use OtherVendor\OtherPackage\BazClass;

… additional PHP code … </PHP> ===== Classes, Properties, and Methods ===== The term 'class' refers to all classes, interfaces, and traits. ==== Extends and Implements ==== The extends and implements keywords MUST be declared on the same line as the class name. The opening brace for the class MUST go on its own line; the closing brace for the class MUST go on the next line after the body. <PHP> <?php namespace Vendor\Package; use FooClass; use BarClass as Bar; use OtherVendor\OtherPackage\BazClass; class ClassName extends ParentClass implements \ArrayAccess, \Countable { constants, properties, methods } </PHP> Lists of implements MAY be split across multiple lines, where each subsequent line is indented once.
When doing so, the first item in the list MUST be on the next line, and there MUST be only one interface per line. <PHP> <?php namespace Vendor\Package;

use FooClass; use BarClass as Bar; use OtherVendor\OtherPackage\BazClass;

class ClassName extends ParentClass implements

  \ArrayAccess,
  \Countable,
  \Serializable

{

  // constants, properties, methods

} </PHP>

• Die Sichtbarkeit MUSS für alle Eigenschaften angegeben werden.
• Das Schlüsselwort var DARF NICHT zur Deklaration von Eigenschaften benutzt werden.
• Es DARF NICHT mehr als eine Eigenschaft je Statement deklariert werden.
• Eigenschaftennamen DÜRFEN NICHT zur Kennzeichnung von private oder protected einen _ als Vorzeichen erhalten.

Beispiel einer Eigenschaftendeklaration: <PHP> <?php namespace Vendor\Package;

class ClassName {

  public $foo = null;

} </PHP>

• Die Sichtbarkeit MUSS für alle Methoden angegeben werden.
• Methodennamen DÜRFEN NICHT zur Kennzeichnung von private oder protected einen _ als Vorzeichen erhalten.
• Nach dem Methodennamen DÜRFEN NICHT Leerstellen eingefügt werden. Die öffnende, geschweifte Klammer MUSS alleine in einer eigenen Zeile stehen und die schließende Klammer MUSS in der nächsten Leeren Zeile nach dem Methodenkörper stehen. Nach der öffnenden und vor der schließenden Klammer der Argumentenliste DÜRFEN NICHT Leerstellen eingefügt werden.

Beispiel einer Methodendeklaration. Beachten Sie die Anordnung von Klammern, Leerstellen, Kommata etc. <PHP> <?php namespace Vendor\Package;

class ClassName {

  public function fooBarBaz($arg1, &$arg2, $arg3 = [])
  {
      // method body
  }

} </PHP>

• In der Argumentenliste DARF NICHT eine Leerstelle vor einem Komma sein, aber es MUSS eine Leerstelle nach jedem Komma folgen.
• Methodenargumente mit Vorgabewerten(default) MÜSSEN an das Ende der Liste.

<PHP> <?php namespace Vendor\Package;

class ClassName {

  public function foo($arg1, &$arg2, $arg3 = [])
  {
      // method body
  }

} </PHP>

• Argumentenlisten KÖNNEN über mehrere Zeilen gesplittet werden, wenn jede Unterzeile um eine Stufe eingerückt wird. Wenn so verfahren wird, MUSS das erste Element in die nächste Zeile und es DARF NICHT mehr als ein Argument je Zeile angegeben werden.
• Wenn eine Argumentenliste gesplittet wird, so MUSS die schließende Klammer und die öffnende geschweifte Klammer mit einer Leerstelle dazwischen in eine eigene Zeile.

<PHP> <?php namespace Vendor\Package;

class ClassName {

  public function aVeryLongMethodName(
      ClassTypeHint $arg1,
      &$arg2,
      array $arg3 = []
  ) {
      // method body
  }

} </PHP>

• Wenn vorhanden, MÜSSEN die Deklarationen für abstract und final vor der Sichtbarkeitsdeklaration eingefügt werden.
• Wenn vorhanden, MUSS die Deklarationen für static nach der Sichtbarkeitsdeklaration eingefügt werden.

<PHP> <?php namespace Vendor\Package;

abstract class ClassName {

  protected static $foo;

  abstract protected function zim();

  final public static function bar()
  {
      // method body
  }

} </PHP>

Bei einem Methoden- oder Funktionsaufruf DARF NICHT zwischen dem Methoden- oder Funktionsnamen und der öffnenden Klammer eine Leerstelle sein; Es DARF NICHT eine Leerstelle nach der öffnenden Klammer und es DARF NICHT eine Leerstelle vor der schließenden Klammer eingefügt werden. In der Argumentenliste DARF NICHT eine Leerstelle vor einem Komma stehen und es MUSS eine Leerstelle nach jedem Komma eingefügt werden. <PHP> bar(); $foo→bar($arg1); Foo::bar($arg2, $arg3); </PHP>

• Argumentenlisten KÖNNEN über mehrere Zeilen gesplittet werden, wenn jede Unterzeile um eine Stufe eingerückt wird. Wenn so verfahren wird, MUSS das erste Element in die nächste Zeile und es DARF NICHT mehr als ein Argument je Zeile angegeben werden.
• Wenn eine Argumentenliste gesplittet wird, so MUSS die schließende Klammer und das Semikolon ohne eine Leerstelle dazwischen in eine eigene Zeile.

<PHP> $foo→bar(

  $longArgument,
  $longerArgument,
  $muchLongerArgument

); </PHP>

Für alle Kontrollstrukturen gelten erst einmal folgende, allgemeine Regeln:

• Es MUSS ein Leerzeichen hinter dem Schlüsselwort der Kontrollstruktur sein.
• Es DARF NICHT ein Leerzeichen nach der öffnenden Klammer stehen.
• Es DARF NICHT ein Leerzeichen vor der schließenden Klammer stehen.
• Es MUSS ein Leerzeichen zwischen der schließenden Klammer und der öffnenden, geschweiften Klammer stehen.
• Der Strukturkörper MUSS um eine Stufe eingerückt werden.
• Die schließende, geschweifte Klammer MUSS in der Zeile nach dem Kontrollkörper stehen.

Der Körper einer Struktur MUSS in geschweifte Klammern eingeschlossen werden. Diese Standardisierung verhindert Fehler, falls zufällig Leerzeilen im Körper eingefügt werden.

Eine if-Struktur sieht wie nachfolgend aus. Beachten Sie die Plazierung von Klammern, Leerstellen und geschweiften Klammern. Die Schlüsselwörter else und elseif MÜSSEN sich mit einer Leerstelle Abstand auf der selben Zeile befinden, wie die schließende, geschweifte Klammer des vorhergehenden Strukturkörpers. <PHP> if ($expr1) {

  // if body

} elseif ($expr2) {

  // elseif body

} else {

  // else body;

} </PHP> Das Schlüsselwort elseif SOLLTE anstelle von else if so dass alle Schlüsselworte wie einzelne Worte aussehen.

Eine switch-Struktur sieht wie nachfolgend aus. Beachten Sie die Plazierung von Klammern, Leerstellen und geschweiften Klammern. Das case-Statement MUSS eine Stufe ab switch eingerückt werden und das break Schlüsselwort (oder ein anderes, abschließendes Schlüsselwort) MUSS auf die selbe Ebene eingerückt werden, wie der case-Körper. Es MUSS ein Kommentar wie // no break eingefügt werden, wenn ein 'durchfallen' zum nächsten case erwünscht ist. <PHP> switch ($expr) {

  case 0:
      echo 'First case, with a break';
      break;
  case 1:
      echo 'Second case, which falls through';
      // no break
  case 2:
  case 3:
  case 4:
      echo 'Third case, return instead of break';
      return;
  default:
      echo 'Default case';
      break;

} </PHP>

Ein while-Statement sieht wie nachfolgend aus. Beachten Sie die Plazierung von Klammern, Leerstellen und geschweiften Klammern. <PHP> while ($expr) {

  // structure body

} </PHP> ebenso sieht ein do while-Statement wie nachfolgend aus. Beachten Sie die Plazierung von Klammern, Leerstellen und geschweiften Klammern. <PHP> do {

  // structure body;

} while ($expr); </PHP>

Ein for-Statement sieht wie nachfolgend aus. Beachten Sie die Plazierung von Klammern, Leerstellen und geschweiften Klammern. <PHP> for ($i = 0; $i < 10; $i++) {

  // for body

} </PHP>

Ein foreach-Statement sieht wie nachfolgend aus. Beachten Sie die Plazierung von Klammern, Leerstellen und geschweiften Klammern. <PHP> foreach ($iterable as $key ⇒ $value) {

  // foreach body

} </PHP>

Ein try catch-Statement sieht wie nachfolgend aus. Beachten Sie die Plazierung von Klammern, Leerstellen und geschweiften Klammern. <PHP> try {

  // try body

} catch (FirstExceptionType $e) {

  // catch body

} catch (OtherExceptionType $e) {

  // catch body

} </PHP>

• Closures MÜSSEN mit einem Leerzeichen nach denm Schlüsselwort function und je einem Leerzeichen vor und nach dem Schlüsselwort use deklariert werden.
• Die öffnende, geschweifte Klammer MUSS in der selben Zeile wie das Schlüsselwort function sein und die schließende Klammer MUSS in der nächsten Zeile nach dem Funktionskörper sein.
• Nach der öffnenden Klammer der Argumentenliste DARF NICHT ein Leerzeichen stehen und vor der schließenden Klammer DARF NICHT ein Leerzeichen sein.
• In der Argumentenliste und der Variablenliste DARF NICHT ein Leerzeichen vor einem Komma stehen und nach einem Komma MUSS ein Leerzeichen sein.
• Closure Argumente mit Vorgabewerten (default) MÜSSEN an das Ende der Argumentenliste.

Eine Closure Deklaration sieht wie nachfolgend aus. Beachten Sie die Plazierung von Klammern, Leerstellen und geschweiften Klammern. <PHP> $closureWithArgs = function ($arg1, $arg2) {

  // body

};

$closureWithArgsAndVars = function ($arg1, $arg2) use ($var1, $var2) {

  // body

}; </PHP>

• Argumenten- und Variablenlisten KÖNNEN über mehrere Zeilen gesplittet werden, wenn jede Unterzeile um eine Stufe eingerückt wird. Wenn so verfahren wird, MUSS das erste Element in die nächste Zeile und es DARF NICHT mehr als ein Argument oder Variable je Zeile angegeben werden.
• Wenn eine Argumenten- oder Variablenliste gesplittet wird, so MUSS die schließende Klammer und die öffnende geschweifte Klammer mit einer Leerstelle dazwischen in eine eigene Zeile.

Beispiele von Closures mit und ohne Argumentenliste und Variableliste die über mehrere Zeilen gesplittet sind. <PHP> $longArgs_noVars = function (

  $longArgument,
  $longerArgument,
  $muchLongerArgument

) {

 // body

};

$noArgs_longVars = function () use (

  $longVar1,
  $longerVar2,
  $muchLongerVar3

) {

 // body

};

$longArgs_longVars = function (

  $longArgument,
  $longerArgument,
  $muchLongerArgument

) use (

  $longVar1,
  $longerVar2,
  $muchLongerVar3

) {

 // body

};

$longArgs_shortVars = function (

  $longArgument,
  $longerArgument,
  $muchLongerArgument

) use ($var1) {

 // body

};

$shortArgs_longVars = function ($arg) use (

  $longVar1,
  $longerVar2,
  $muchLongerVar3

) {

 // body

}; </PHP> Beachten Sie, dass die Formatierungsregeln auch greifen, wenn ein Closure direkt in einem Funktions- oder Methodenaufruf als Argument eingesetzt ist. <PHP> $foo→bar(

  $arg1,
  function ($arg2) use ($var1) {
      // body
  },
  $arg3

); </PHP>