PHP Coding Standard

Logo: PHP
5. Regel 2: Dateien, die inkludiert werden sollten, mit "*.inc.php" enden oder in einem Unterverzeichnis liegen

Es ist besser ein Unterverzeichnis ("include" oder "inc") für die Dateien anzulegen, die per include() oder ähnlichen Befehlen inkludiert werden. Oft werden hier Verzeichnisse wie "lib" oder "class" verwendet. Das widerspricht jedoch dem Prinzip der Einfachheit, weil der Name "include" für jeden PHP-Programmierer eine eindeutige Verbindung zum gleichnamigen PHP-Befehl herstellt. Das INCLUDE-Verzeichnis kann auch für CSS- und JavaScript-Dateien verwendet werden. Empfohlen wird jedoch ein eigenes Unterverzeichnis (zum Beispiel: "css_javascript").

Möchte man, aus welchen Gründen auch immer, alle INCLUDE-Dateien im Hauptpfad ablegen, so muss die Dateiendung "*.inc.php" verwendet werden. "*.inc" reicht nicht aus, weil diese Dateiendung standardmäßig nicht geparst wird und demnach alle Informationen der Datei (auch Passwörter) im Klartext vorliegen.

Ausnahme zu Regel 2: Wenn das Team sich für eine Struktur entscheidet, die jedem Mitglied intuitiv und einfach erscheint, sollte diese Struktur verwendet werden.