array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ja', ), 'this' => array ( 0 => 'function.var-export.php', 1 => 'var_export', ), 'up' => array ( 0 => 'ref.var.php', 1 => '変数操作 関数', ), 'prev' => array ( 0 => 'function.var-dump.php', 1 => 'var_dump', ), 'next' => array ( 0 => 'refs.webservice.php', 1 => 'ウェブサービス', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ja', 'path' => 'reference/var/functions/var-export.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
var_export — 変数の文字列表現を出力または返す
var_export() は、 渡された変数に関する構造化された情報を返します。この関数は var_dump() に似ていますが、 返される表現が有効な PHP コードであるところが異なります。
バージョン | 説明 |
---|---|
8.2.0 | クラス名をエクスポートする場合、そのクラス名は完全修飾名になりました。 これより前のバージョンでは、先頭のバックスラッシュが省略されていました。 |
7.3.0 |
stdClass オブジェクトは、
存在しないメソッド stdClass::__setState() を使わず、
配列をオブジェクトにキャストした形
((object) array( ... ) ) でエクスポートされるようになりました。
この変更によって、stdClass がエクスポート可能になり、
このバージョンより前の PHP でもエクスポートした結果が動くようになりました。
|
例1 var_export() の例
<?php
$a = array (1, 2, array ("a", "b", "c"));
var_export($a);
?>
上の例の出力は以下となります。
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
例2 PHP 7.3.0 以降で stdClass をエクスポートする
<?php
$person = new stdClass;
$person->name = 'ElePHPant ElePHPantsdotter';
$person->website = 'https://php.net/elephpant.php';
var_export($person);
上の例の出力は以下となります。
(object) array( 'name' => 'ElePHPant ElePHPantsdotter', 'website' => 'https://php.net/elephpant.php', )
例3 クラスのエクスポート
<?php
class A { public $var; }
$a = new A;
$a->var = 5;
var_export($a);
?>
上の例の出力は以下となります。
A::__set_state(array( 'var' => 5, ))
例4 __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);
?>
上の例の出力は以下となります。
object(A)#2 (2) { ["var1"]=> int(5) ["var2"]=> string(3) "foo" }
注意:
リソース型 の変数は、 この関数ではエクスポートする事ができません。
注意:
var_export() では循環参照を扱うことができません。 循環参照を表す解析可能な PHP コードを生成することは、不可能に近いからです。 配列やオブジェクトを完全な形式で扱いたい場合は serialize() を使用してください。
PHP 8.2.0 より前のバージョンでは、var_export() でオブジェクトをエクスポートするときに、 名前空間を指定したクラスの名前の先頭にあるバックスラッシュは含めませんでした。これは互換性を高めるためでした。
注意:
var_export() が生成する PHP を評価できるようにするためには、 処理対象のすべてのオブジェクトがマジックメソッド __set_state を実装している必要があります。 これの唯一の例外は stdClass です。 stdClass は、配列をオブジェクトにキャストした形でエクスポートされます。