PHP Coding Standard |
Bezeichner von Variablen, Funktionen, Klassen und so weiter sollten in Englisch definiert werden. Alle Kommentare und Dokumentation sollte ebenfalls in Englisch erfolgen.
Es ist absolut notwendig und unumgänglich Source-Code zu dokumentieren. Wenn keine zwingenden Gründe dagegen sprechen, sollten als Projektsprache Englisch genommen werden, um Personen aus anderen Ländern einen möglichst einfachen Zugang zum Projekt zu gewähren.
Unbedingt zu vermeiden ist eine Mischung der englischen und der deutschen Sprache, gerade wenn es um die Benennung von Variablen geht. Siehe dazu auch mehr bei den Regeln zur Benennung von Variablen.
Ein Team entscheidet sich dazu, Deutsch als Projektsprache zu nehmen. Damit entsteht nahezu automatisch das Problem der Sprachmischungen:
$select_maximum = 'SELECT MAX(id) FROM tabelle'; $result_maximum = mysql_query($select_maximum); $eine_ganz_andere_variable = TRUE;
Wie man unschwer sehen kann, muss man in einer deutschen Sprachumgebung auf Variablen wie
verzichten und sich geeignete Äquivalente ausdenken. Auf Englisch als Projektsprache sollte nur verzichtet werden, wenn die Englischkenntnisse des Teams "im negativen Bereich" liegen oder der Fehlerquotient einen zweistelligen Wert hat.