(PHP 4, PHP 5, PHP 7)
define — Definiert eine benannte Konstante
Definiert während der Laufzeit eine benannte Konstante.
nameDer 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
(integer, float, string,
boolean, oder NULL) sein. In PHP 7 werden ebenfalls
array Werte akzeptiert.
Obgleich es möglich ist, Konstanten vom Typ Ressource zu definieren, wird dies nicht empfohlen, da es 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 zwischen
Groß- und Kleinschreibung unterschieden, d.h
KONSTANTE und Konstante
repräsentieren unterschiedliche Werte.
Das Definieren von Konstanten, die nicht zwischen Groß- und Kleinschreibung unterscheiden ist von PHP 7.3.0 an missbilligt.
Hinweis:
Groß-/Kleinschreibungsunabhängige Konstanten werden kleingeschrieben gespeichert.
Gibt bei Erfolg TRUE zurück. Im Fehlerfall wird FALSE zurückgegeben.
| Version | Beschreibung |
|---|---|
| 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, wird es nicht empfohlen, 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)