(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
var_export — Devuelve el código PHP utilizado para generar una variable
var_export() devuelve datos estructurados sobre la variable dada. Es el mismo principio que var_dump() pero con una excepción: el resultado devuelto es código PHP válido.
valueLa variable que se desea exportar.
return
Si se utiliza y se establece a true, var_export() devolverá
la representación de la variable en lugar de mostrarla.
Devuelve la representación de la variable cuando el parámetro
return se utiliza y se evalúa a true. De lo contrario,
esta función devolverá null.
| Versión | Descripción |
|---|---|
| 8.2.0 | Los nombres de clase exportados son ahora completamente calificados. Anteriormente, la barra invertida inicial era omitida. |
| 7.3.0 |
Exporta ahora los objetos stdClass como
un array convertido a un objeto ((object) array( ... )),
en lugar de utilizar el método no existente
stdClass::__set_state().
El efecto práctico es que ahora stdClass es
exportable, y que el código resultante funcionará incluso en versiones
anteriores de PHP.
|
Ejemplo #1 Ejemplo con var_export()
<?php
$a = array (1, 2, array ("a", "b", "c"));
var_export($a);
?>El ejemplo anterior mostrará :
array (
0 => 1,
1 => 2,
2 =>
array (
0 => 'a',
1 => 'b',
2 => 'c',
),
)
<?php
$b = 3.1;
$v = var_export($b, true);
echo $v; // 3.1
?>El ejemplo anterior mostrará :
3.1
Ejemplo #2 Exportar stdClass (a partir de PHP 7.3.0)
<?php
$person = new stdClass;
$person->name = 'ElePHPant ElePHPantsdotter';
$person->website = 'https://php.net/elephpant.php';
var_export($person);El ejemplo anterior mostrará :
(object) array( 'name' => 'ElePHPant ElePHPantsdotter', 'website' => 'https://php.net/elephpant.php', )
Ejemplo #3 Exportar clases
<?php
class A { public $var; }
$a = new A;
$a->var = 5;
var_export($a);
?>El ejemplo anterior mostrará :
\A::__set_state(array( 'var' => 5, ))
Ejemplo #4 Uso de __set_state
<?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($a, true) . ';'); // $b = A::__set_state(array(
// 'var1' => 5,
// 'var2' => 'foo',
// ));
var_dump($b);
?>El ejemplo anterior mostrará :
object(A)#2 (2) {
["var1"]=>
int(5)
["var2"]=>
string(3) "foo"
}
Nota:
Las variables de tipo resource no pueden ser exportadas por esta función.
Nota:
var_export() no maneja referencias circulares ya que sería imposible generar código PHP analizable para este tipo de datos. Si se desea hacer algo con la representación completa de un array o un objeto, se debe utilizar la función serialize().
Anterior a PHP 8.2.0, cuando var_export() exportaba objetos, la barra invertida inicial no era incluida en el espacio de nombres de la clase y esto, para un máximo de compatibilidad.
Nota:
Para poder evaluar el PHP generado por var_export(), todos los objetos analizados deben implementar el método mágico __set_state. La única excepción es stdClass; que es exportada utilizando un cast de un array a un objeto.