(PHP 4, PHP 5, PHP 7, PHP 8)
define — Definiert eine benannte Konstante
Definiert während der Laufzeit eine benannte Konstante.
constant_name
Der Name der Konstante.
Hinweis:
Es ist möglich, Konstanten mit reservierten oder gar ungültigen Namen mittels define() zu definieren, deren Wert (nur) mittels constant() gelesen werden kann. Allerdings wird dies nicht empfohlen.
value
Der Wert der Konstante. In PHP 5 muss value
ein scalarer Wert (int, float, string, bool, oder null
) sein. In PHP 7 werden auch Array-Werte akzeptiert.
Obgleich es möglich ist, Konstanten vom Typ Ressource zu definieren, wird dies nicht empfohlen, da es ein unvorhersagbares Verhalten des Programms zur Folge haben kann.
case_insensitive
Falls auf true
gesetzt, wird bei der Konstante nicht zwischen Groß- und Kleinschreibung unterschieden. In der Voreinstellung wird dazwischen unterschieden, d. h. KONSTANTE
und Konstante
repräsentieren unterschiedliche Werte.
Das Definieren von Konstanten, die nicht zwischen Groß- und Kleinschreibung unterscheiden, wird von PHP 7.3.0 an missbilligt. Seit PHP 8.0.0 ist nur false
ein zulässiger Wert; die Übergabe von true
erzeugt eine Warnung.
Hinweis:
Groß-/Kleinschreibungsunabhängige Konstanten werden kleingeschrieben gespeichert.
Version | Beschreibung |
---|---|
8.0.0 | Die Übergabe von true an case_insensitive gibt nun einen Fehler der Stufe E_WARNING aus; die Übergabe von false ist weiterhin erlaubt. |
7.3.0 | case_insensitive ist missbilligt und wird in Version 8.0.0 entfernt. |
7.0.0 | Array-Werte sind erlaubt. |
Beispiel #1 Konstanten definieren
<?php
define("KONSTANTE", "Hallo Welt.");
echo KONSTANTE; // gibt "Hallo Welt." aus
echo Konstante; // gibt "Konstante" aus und erzeugt eine Warnung
define("BEGRUESSUNG", "Hallo Du.", true);
echo BEGRUESSUNG; // gibt "Hallo Du." aus
echo Begruessung; // gibt "Hallo Du." aus
// Funktioniert ab PHP 7
define('ANIMALS', array(
'Hund',
'Katze',
'Maus'
));
echo ANIMALS[1]; // gibt "Katze" aus
?>
Beispiel #2 Konstanten mit reservierten Namen
Dieses Beispiel verdeutlich die Möglichkeit, eine Konstante mit dem selben Namen wie eine magische Konstante zu definieren. Da das resultierende Verhalten offensichtlich verwirrend ist, ist es nicht empfehlenswert, dies in der Praxis zu tun.
<?php
var_dump(defined('__LINE__'));
var_dump(define('__LINE__', 'test'));
var_dump(constant('__LINE__'));
var_dump(__LINE__);
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
bool(false) bool(true) string(4) "test" int(5)