(PHP 4, PHP 5, PHP 7, PHP 8)
compact — Erstellt ein Array mit Variablen und deren Werten
Erstellt ein Array mit Variablen und deren Werten.
Für jede dieser Variablen sucht compact() nach einer Variablen in der aktuellen Symboltabelle, und fügt diese dem zurückzugebenden Array hinzu, wobei der Variablenname als Schlüssel, und der Inhalt der Variablen als Wert gespeichert wird. Kurz gesagt, diese Funktion tut das Gegenteil von extract().
Hinweis:
Vor PHP 7.3 wurden Strings, welche nicht gesetzt sind, stillschweigend ignoriert.
var_namevar_namescompact() übernimmt eine variable Anzahl von Parametern. Jeder Parameter kann entweder ein String mit einem Variablennamen, oder ein Array mit Variablennamen sein. Dieses Array kann auch andere Arrays mit Variablennamen enthalten; compact() behandelt sie rekursiv.
Gibt ein Array mit allen Variablen zurück.
compact() erzeugt eine Fehlermeldung der Stufe E_WARNING, wenn sich ein gegebener String auf eine nicht gesetzte Variable bezieht.
| Version | Beschreibung |
|---|---|
| 8.0.0 | Wenn ein gebener String auf eine nicht gesetzte Variable verweist, wird nun ein Fehler der Stufe E_WARNING erzeugt. |
| 7.3.0 | compact() erzeugt nun eine Fehlermeldung der Stufe E_NOTICE, wenn sich ein gegebener String auf eine nicht gesetzte Variable bezieht. Zuvor wurden solche Strings stillschweigend ausgelassen. |
Beispiel #1 compact()-Beispiel
<?php
$city = "San Francisco";
$state = "CA";
$event = "SIGGRAPH";
$location_vars = array("city", "state");
$result = compact("event", $location_vars);
print_r($result);
?>Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
Array ( [event] => SIGGRAPH [city] => San Francisco [state] => CA )
Hinweis: Achtung
Weil variable Variablen in Funktionen nicht mit PHPs superglobalen Arrays verwendet werden dürfen, können die superglobalen Arrays nicht an compact() übergeben werden.