define
(PHP 4, PHP 5, PHP 7, PHP 8)
define — Definiert eine benannte Konstante
Beschreibung
Definiert während der Laufzeit eine benannte Konstante.
Parameter-Liste
-
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
valueein scalarer Wert (int, float, string, bool, odernull) sein. In PHP 7 werden auch Array-Werte akzeptiert.WarnungObgleich 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
truegesetzt, wird bei der Konstante nicht zwischen Groß- und Kleinschreibung unterschieden. In der Voreinstellung wird dazwischen unterschieden, d. h.KONSTANTEundKonstanterepräsentieren unterschiedliche Werte.WarnungDas 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
falseein zulässiger Wert; die Übergabe vontrueerzeugt eine Warnung.Hinweis:
Groß-/Kleinschreibungsunabhängige Konstanten werden kleingeschrieben gespeichert.
Rückgabewerte
Gibt bei Erfolg true zurück. Bei einem Fehler wird false zurückgegeben.
Changelog
| 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. |
Beispiele
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)
Siehe auch
- defined() - Prüft, ob eine benannte Konstante existiert
- constant() - Liefert den Wert einer Konstante
- Das Kapitel über Konstanten
