array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.define.php', 1 => 'define', 2 => 'Definiert eine benannte Konstante', ), 'up' => array ( 0 => 'ref.misc.php', 1 => 'Sonstige Funktionen', ), 'prev' => array ( 0 => 'function.constant.php', 1 => 'constant', ), 'next' => array ( 0 => 'function.defined.php', 1 => 'defined', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/misc/functions/define.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

define

(PHP 4, PHP 5, PHP 7, PHP 8)

define — Definiert eine benannte Konstante

Beschreibung

define(string $constant_name, mixed $value, bool $case_insensitive = false): bool

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.

Warnung

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.

Warnung

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.

Rückgabewerte

Gibt bei Erfolg true zurück. Bei einem Fehler wird false zurückgegeben.

Changelog

Version Beschreibung
8.1.0 value kann nun ein Objekt sein.
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.

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