PHP Konstanten mit const und define

Von Veröffentlicht am Aktualisiert am

Der Steuersatz steht an zwölf Stellen im Shop als 0.19. Dann ändert er sich. Wer jetzt sucht und ersetzt, übersieht garantiert eine Stelle. PHP Konstanten lösen das: Ein Name wie MWST steht für den Wert, festgelegt an genau einem Ort und gegen versehentliches Überschreiben geschützt. Bleibt die Frage, welche der drei Möglichkeiten Sie nehmen: Variable, const oder define().

Das Wichtigste vorab

Für feste Einstellungen nehmen Sie const. define() brauchen Sie nur, wenn die Konstante von einer Bedingung abhängt. Alles, was sich während des Skripts ändern darf, bleibt eine Variable.

Variable und Konstante im Vergleich

VariableKonstante
Schreibweise$mwstMWST
Wert ändernjederzeitnie
In Funktionen sichtbarnur als Parameterüberall
Typischer EinsatzEingaben, Zwischenergebnissefeste Einstellungen

Gegenüberstellung von Variable und Konstante: Eine Variable mit Dollarzeichen lässt sich überschreiben, eine Konstante ohne Dollarzeichen bleibt fest, ein zweiter Zuweisungsversuch wird mit einer Warnung abgelehnt

Die dritte Zeile ist bequem und zugleich eine Warnung. PHP Konstanten gelten global, jede Funktion kann sie lesen, ohne dass Sie sie übergeben. Machen Sie deshalb nur echte Festwerte zu Konstanten, nichts, was je nach Besucher anders ist.

PHP Konstanten mit const

Der Name steht ohne Dollarzeichen und nach fester Konvention in Großbuchstaben:

<?php
const MWST = 0.19;
const SHOP_NAME = "Vereinsladen";
const ERLAUBTE_ENDUNGEN = ['jpg', 'png', 'webp'];

$netto = 100;
echo $netto * (1 + MWST);   // 119
echo SHOP_NAME;             // Vereinsladen

Ein zweiter Versuch, MWST zu belegen, scheitert mit einer Warnung, und der alte Wert bleibt. Genau dafür gibt es Konstanten:

<?php
const MWST = 0.19;
const MWST = 0.07;   // Warning: Constant MWST already defined
echo MWST;           // weiterhin 0.19

Wann define() die bessere Wahl ist

const wird schon beim Einlesen der Datei festgelegt. Es muss deshalb auf oberster Ebene stehen, nicht in einem if. define() läuft erst zur Laufzeit und darf überall stehen:

<?php
const VERSION = "2.1";                 // auf oberster Ebene

if (!defined('DEBUG')) {
    define('DEBUG', false);           // nur define geht in einem if
}

$umgebung = 'live';
define('BASIS_URL', $umgebung === 'live'
    ? 'https://www.example.org'
    : 'http://localhost');

defined('NAME') prüft, ob es eine Konstante schon gibt.

Entscheidungshilfe in drei Fragen

  1. Darf sich der Wert im Lauf des Skripts ändern? Dann ist es eine Variable.
  2. Steht der Wert schon beim Schreiben des Codes fest? Dann const.
  3. Hängt er von einer Bedingung oder einem Wert zur Laufzeit ab? Dann define().

Übung: Welche Variante passt?

Aufgabe: Entscheiden Sie für drei Fälle und schreiben Sie den Code für den ersten: (a) Versandkosten von 4,90 Euro, die Sie im ganzen Shop brauchen. (b) Ein Schalter DEBUG, der nur gesetzt wird, wenn ihn noch niemand gesetzt hat. (c) Die Summe im Warenkorb.

Lösung:

FallWahlGrund
(a) Versandkostenconststeht beim Schreiben fest
(b) DEBUGdefine()entsteht in einer Bedingung
(c) WarenkorbsummeVariableändert sich mit jedem Artikel
<?php
const VERSANDKOSTEN = 4.90;

$warenwert = 25;
$gesamt = $warenwert + VERSANDKOSTEN;
echo number_format($gesamt, 2, ',', '.') . " €";   // 29,90 €

Konstanten in Klassen und eingebaute Konstanten

Arbeiten Sie später mit Klassen, gehören Festwerte meist in die Klasse. Der Zugriff läuft über zwei Doppelpunkte:

<?php
class Bestellung {
    public const STATUS_OFFEN = 'offen';
    public const STATUS_BEZAHLT = 'bezahlt';
}

echo Bestellung::STATUS_OFFEN;   // offen

Ein Tippfehler wie 'bezahlt ' mit Leerzeichen fällt so sofort auf. Wie Klassen funktionieren, zeigt PHP Klassen und Objekte. Einige Konstanten bringt PHP schon mit:

KonstanteInhalt
PHP_VERSIONlaufende Version, etwa „8.3.12“
PHP_EOLZeilenumbruch des Betriebssystems
PHP_INT_MAXgrößte mögliche Ganzzahl
__DIR__Ordner der aktuellen Datei
__LINE__, __FILE__aktuelle Zeile und Datei

Die mit doppelten Unterstrichen heißen „magisch“, weil ihr Wert von der Stelle im Code abhängt. __DIR__ brauchen Sie ständig, um Dateien zuverlässig einzubinden, siehe PHP include und require.

Eine config.php für alle Seiten

In echten Projekten sammeln Sie die Festwerte in einer Datei, die jede Seite am Anfang einbindet:

<?php
// config.php
const SHOP_NAME = "Vereinsladen";
const MWST = 0.19;
const UPLOAD_ORDNER = __DIR__ . '/uploads';

Ändert sich der Steuersatz, ändern Sie eine Zeile. require __DIR__ . '/config.php'; am Anfang jeder Seite genügt.

Zugangsdaten zur Datenbank gehören nicht in den öffentlichen Web-Ordner und nicht in ein Git-Repository. Legen Sie sie eine Ebene höher ab, also neben htdocs statt darin, und binden Sie sie mit require __DIR__ . '/../zugang.php'; ein. Viele Hoster bieten alternativ Umgebungsvariablen im Kundenmenü an. Die Verbindung selbst zeigt PHP und MySQL mit PDO.

FAQ

Warum wird MWST in meinem Text nicht ersetzt?

In doppelten Anführungszeichen setzt PHP nur Variablen ein, keine Konstanten. Schreiben Sie "Satz: " . MWST.

Ich habe $MWST geschrieben, warum ist der Wert leer?

Mit Dollarzeichen ist es eine Variable, keine Konstante. Konstanten stehen immer ohne $.

Was passiert bei einer Konstante, die es nicht gibt?

Seit PHP 8 bricht das Skript mit einem Fehler ab. Früher gab es nur eine Warnung.

Darf eine Konstante ein Array enthalten?

Ja, mit const und mit define.

Konstanten und Variablen landen oft mitten in Texten, etwa „Versand: 4,90 €“. Wie Sie Texte zusammensetzen und Werte hineinbringen: jetzt mit Strings in PHP weitermachen. Einen Überblick über Datentypen bietet Typen in PHP.