var_export

(PHP 4 >= 4.2.0, PHP 5, PHP 7)

var_exportAfișează sau întoarce o reprezentare string, ce poate fi prelucrată, a unei variabile

Descrierea

var_export ( mixed $expression , bool $return = false ) : mixed

var_export() poate obține informația structurată despre variabila dată. Este similară cu var_dump() cu o singură excepție: reprezentarea întoarsă este cod PHP valid.

Parametri

expression

Variabila pe care doriți să o exportați.

return

Dacă este utilizat și stabilit în true, var_export() va întoarce reprezentarea variabilei în loc să o afișeze.

Valorile întoarse

Întoarce reprezentarea variabilei când parametrul return este utilizat și evaluează în true. În caz contrar, această funcție va întoarce null.

Note

Notă:

Când este utilizat parametrul return, această funcție efectuează buferizarea internă a ieșirilor, de aceea nu poate fi utilizată în interiorul funcției de apel invers (callback) ob_start().

Istoricul schimbărilor

Versiune Descriere
7.3.0 Acum exportă obiecte stdClass ca un tablou transformat în obiect ((object) array( ... )), dar nu utilizează metoda neexistentă stdClass::__setState(). Efectul practic este că acum stdClass este exportabil și codul-sursă ce rezultă va funcționa chiar și pe versiuni anterioare ale PHP.

Exemple

Example #1 Exemple var_export()

<?php
$a 
= array (12, array ("a""b""c"));
var_export($a);
?>

Exemplul de mai sus va afișa:

array (
  0 => 1,
  1 => 2,
  2 =>
  array (
    0 => 'a',
    1 => 'b',
    2 => 'c',
  ),
)
<?php

$b 
3.1;
$v var_export($btrue);
echo 
$v;

?>

Exemplul de mai sus va afișa:

3.1

Example #2 Exportarea stdClass (începând cu PHP 7.3.0)

<?php
$person 
= new stdClass;
$person->name 'ElePHPant ElePHPantsdotter';
$person->website 'https://php.net/elephpant.php';

var_export($person);

Exemplul de mai sus va afișa:

(object) array(
   'name' => 'ElePHPant ElePHPantsdotter',
   'website' => 'https://php.net/elephpant.php',
)

Example #3 Exportarea claselor (începând cu PHP 5.1.0)

<?php
class { public $var; }
$a = new A;
$a->var 5;
var_export($a);
?>

Exemplul de mai sus va afișa:

A::__set_state(array(
   'var' => 5,
))

Example #4 Utilizarea __set_state() (începând cu PHP 5.1.0)

<?php
class A
{
    public 
$var1;
    public 
$var2;

    public static function 
__set_state($an_array)
    {
        
$obj = new A;
        
$obj->var1 $an_array['var1'];
        
$obj->var2 $an_array['var2'];
        return 
$obj;
    }
}

$a = new A;
$a->var1 5;
$a->var2 'foo';

eval(
'$b = ' var_export($atrue) . ';'); // $b = A::__set_state(array(
                                            //    'var1' => 5,
                                            //    'var2' => 'foo',
                                            // ));
var_dump($b);
?>

Exemplul de mai sus va afișa:

object(A)#2 (2) {
  ["var1"]=>
  int(5)
  ["var2"]=>
  string(3) "foo"
}

Note

Notă:

Variabile de tip resource nu pot fi exportate cu această funcție.

Notă:

var_export() nu prelucrează referințe circulare, deoarece ar fi aproape imposibil de a genera cod PHP prelucrabil în acest caz. Dacă doriți să faceți ceva cu reprezentarea deplină a unui tablou sau obiect, utilizați serialize().

Avertizare

Când var_export() exportă obiecte, în denumirea clasei nu se include backslash-ul din față (pentru clasele cu spații de nume), pentru a maximiza compatibilitatea.

Notă:

Pentru a putea evalua codul PHP generat de var_export(), toate obiectele procesate trebuie să implementeze metoda magică __set_state. Unica excepție este stdClass, care este exportată utilizând un tablou cu tipul schimbat în obiect.

A se vedea și

  • print_r() - Afișează informație lizibilă de om despre o variabilă
  • serialize() - Generează o reprezentare ce poate fi stocată a unei valori
  • var_dump() - Afișează informația despre o variabilă