var_export
var_export($value, $return)
Affiche une valeur sous forme de code PHP valide qu’on peut recoller dans un script. Avec le second paramètre à true, elle la renvoie sous forme de chaîne. Elle est utile pour générer des fichiers de configuration.
Paramètres
- $value – la valeur à afficher.
- $return – facultatif, false par défaut. Avec true, la fonction renvoie le code sous forme de chaîne.
Exemples
var_export(array("a" => 1, "b" => true)); // array ( 'a' => 1, 'b' => true, )
// chaînes entre apostrophes, correctement échappées
var_export("O'Neil"); // 'O\'Neil'
var_export(1.0); // 1.0
var_export(null); // NULL
// un objet simple (depuis PHP 7.3)
$o = new stdClass;
$o->a = 1;
var_export($o); // (object) array( 'a' => 1, )
// le code d'un tableau pour un fichier de configuration
$settings = array("couleur" => "bleu", "nombre" => 5);
$code = '$settings = ' . var_export($settings, true) . ';';
echo $code; // $settings = array ( 'couleur' => 'bleu', 'nombre' => 5, );
Points d’attention
- Elle ne peut pas afficher un tableau qui se contient lui-même (référence à lui-même) et se termine par un avertissement.
- Elle affiche les objets de vos propres classes comme un appel de \ClassName::__set_state(…). Seule une classe dotée de cette méthode statique peut les recharger.
- Stockez un fichier de code généré à partir de données hors du dossier public du site et n’y mettez jamais de données autrement que par var_export.
- Pour transférer des données entre systèmes, json_encode() convient mieux.
Fonctions associées :
var_dump()
print_r()
serialize()