Kategorie: PHP / Datenbanken - Seite 5 - Design · PHP

Es ist eine gute Praxis, PHP Code mit aussagekräftigen Kommentaren zu versehen, damit man auch noch nach einigen Monaten die Gedankengänge nachvollziehen kann und auch andere nachvollziehen können, wie der Code aufgebaut ist. Es ist viel einfacher einen Kommentar zu lesen als jeweils die einzelnen Zeilen Code zu analysieren.

Kommentare können auch dazu benutzt werden, einen Teil des Codes zeitweise zu deaktivieren. Man spricht dann von „Code auskommentieren“.

Es gibt in PHP drei verschiedene Arten zu kommentieren.

Eine einzelne Zeile kann wie folgt kommentiert werden:

a) Die Zeile beginnt mit zwei Slashes

// hier der Kommentar, der von PHP ignoriert wird

b) Die Zeile beginnt mit einer Raute

# auch dies ist ein einzeiliger Kommentar, der von PHP nicht ausgelesen wird

Ein Kommentar kann auch am Ende einer Zeile eingefügt werden, z.B.

$Hauptstadt = 'Berlin'; // diese Variable speichert den Namen der Hauptstadt

ebenso kann man auch mit der Raute am Ende der Zeile einen Kommentar einfügen:

$Land = 'Deutschland'; # diese Variable speichert den Namens des Landes

Mehrere Zeilen werden ebenso wie in CSS mit einem /* … */ eingeschlossen

/* Dies ist ein mehrzeiliger Kommentar,
   diese Zeilen werden von PHP ignoriert. */

Ebenso kann man Kommentare dazu verwenden, Code auszukommentieren, ohne ihn löschen zu müssen.

Leerzeichen bei der Bezeichnung einer Variablen spielen bei der Ausgabe eines Variablennamens keine Rolle. Sie werden ignoriert. Das Semicolon bezeichnet das Ende der Variablenbezeichnung.

$Hauptstadt = 'Berlin';

wird genauso ausgegeben wie

$Hauptstadt =

'Berlin';

Auch wenn Leerzeichen wie in diesem Beispiel keinen großen Sinn machen, so können Leerzeichen in einer Datei bei Bedarf für eine bessere Lesbarkeit verwendet werden.

In diesem Kapitel geht es um Variablen und grundsätzliche Regeln, die beim Benennen der Variablen zu berücksichtigen sind.

Eine Variable ist ein Platzhalter für einen Wert, den man entweder noch nicht kennt oder der sich ändern kann. Beispiele einer Variablen aus dem täglichen Leben sind z.B. die Begriffe „Name“, „Summe“. Der Wert der Variablen kann sich je nach dem Umfeld, in dem sie gebraucht wird, verändern. Der Bezeichnung der Variablen bleibt immer gleich.

Die Summe einer Rechnung ändert sich je nachdem, was ich gekauft habe. Die Bezeichnung der Variablen „Summe“ bleibt immer die gleiche.

In PHP gibt es ein paar Grundsatzregeln für Variablen, die man beachten muss.

Variablen beginnen immer mit einem Dollarzeichen $

Das erste Zeichen nach dem Dollarzeichen darf keine Zahl sein

Eine Variable darf keine Leerstellen, Satzzeichen oder Sonderzeichen enthalten mit Ausnahme des Unterstrichs _. Es sind jedoch auch Buchstaben aus dem internationalen Alphabet möglich wie Umlaute, Buchstaben mit Akzent oder z.B. Buchstaben aus dem skandinavischen Alphabet wie ø oder å.

Für die Bezeichnung einer Variablen sind nur Buchstaben, Zahlen und der Unterstrich erlaubt.

Variablenbezeichnungen sind case sensitive, d.h. es wird zwischen Groß- und Kleinschreibung unterschieden.

Eine Variable mit der Bezeichnung $Vorname mit groß geschriebenen V ist eine andere Variable als $vorname , bei der das v klein geschrieben wird.

Bei der Bezeichnung von Variablen gibt es einige Ausnahmen, die nicht genutzt werden können.

Die Variable $this ist bereits von php für objektorientierte Scripts reserviert.

Weiterhin sind die sogenannten Superglobals reserviert

$GLOBALS
$_SERVER
$_GET
$_POST
$_FILES
$_COOKIE
$_SESSION
$_REQUEST
$_ENV

$GLOBALS //Referenziert alle Variablen, die im globalen Gültigkeitsbereich vorhanden sind
$_SERVER //Informationen über Server und Ausführungsumgebung
$_GET //HTTP GET-Variablen
$_POST  //HTTP POST-Variablen
$_FILES //HTTP Dateiupload-Variablen
$_REQUEST //HTTP Request-Variablen
$_SESSION //Sessionvariablen
$_ENV //Umgebungsvariablen
$_COOKIE //HTTP Cookies
$php_errormsg //Die vorangegangene Fehlermeldung
$HTTP_RAW_POST_DATA //Raw POST-Daten
$http_response_header //HTTP Response-Header
$argc //Die Anzahl der an das Skript übergebenen Argumente
$argv //Array der an das Skript übergebenen Argumente

siehe auch: http://www.php-resource.de/handbuch/reserved.variables.htm

In der Praxis ist es am hilfreichsten, wenn die Variablenbezeichnung bereits etwas über den Zweck der Variablen aussagt, um auch später noch leicht nachvollziehen zu können, wofür die Variable verwendet wird. Gut gewählte Variablenbezeichnungen machen es einfacher, den Code zu verstehen und auch später bei Bedarf zu bearbeiten oder zu aktualisieren.

Bei Variablenbezeichnung, die aus zusammengesetzten Worten bestehen, macht es Sinn, die Worte durch Großbuchstaben oder einen Unterstrich voneinander zu trennen, z.B.: $firstName oder $first_name

PHP: Kommentare

PHP: Variablen