WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / PHP

define()

Die Funktion define legt zur Laufzeit eine Konstante mit dem angegebenen Zeichenkettennamen einschließlich möglichem Namensraum an und unterscheidet Groß- und Kleinschreibung.

Version: PHP 8.4; repository runtime, production runtime not attested

Syntax

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

Die Funktion define legt zur Laufzeit eine Konstante mit dem angegebenen Zeichenkettennamen einschließlich möglichem Namensraum an und unterscheidet Groß- und Kleinschreibung. Erfolg liefert true. Eine erneute Definition meldet E_WARNING, liefert false und behält den alten Wert. Die Option für Groß-/Kleinschreibungsunabhängigkeit erzeugt in PHP 8.4 keine solche Konstante. Bei neuem Namen meldet case_insensitive=true E_WARNING, doch define liefert true und legt eine Konstante mit beachteter Groß- und Kleinschreibung an.

Signatur

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

Ausgabe des Beispiels

[true,3,false]
warning [false,3]
warning [true,true,false]

Beispiele

<?php
$key = "Example\\LEVEL";
echo json_encode([define($key, 3), constant($key), defined("Example\\level")]), PHP_EOL;
set_error_handler(function (int $severity): bool {
    echo $severity === E_WARNING ? "warning " : "other ";
    return true;
});
try {
    $ok = define($key, 9);
    echo json_encode([$ok, constant($key)]), PHP_EOL;
    $fresh = define("FreshKey", 7, true);
    echo json_encode([$fresh, defined("FreshKey"), defined("freshkey")]);
} finally { restore_error_handler(); }

Ergebnis

[true,3,false]
warning [false,3]
warning [true,true,false]

Quellen