Zend_Serializer

導入

Zend_Serializer はさまざまな機関による保存可能な PHP 型表現の簡潔な生成と回復のインターフェイスに基づく アダプターを提供します。

Example #1 Zend_Serializer の動的なインターフェイスの使用

シリアライザーをインスタンス化するにはアダプター名に基づいたファクトリーメソッド を使用しなければなりません:

  1. $serializer = Zend_Serializer::factory('PhpSerialize');
  2. // この時 $serializer は Zend_Serializer_Adapter_AdapterInterface のインスタンスです,
  3. // すなわち Zend_Serializer_Adapter_PhpSerialize です
  4.  
  5. try {
  6.     $serialized = $serializer->serialize($data);
  7.     // この時 $serialized は文字列です
  8.  
  9.     $unserialized = $serializer->unserialize($serialized);
  10.     // now $data == $unserialized
  11. } catch (Zend_Serializer_Exception $e) {
  12.     echo $e;
  13. }

serialize() メソッドは 保存できる文字列を生成します。 再生成するにはシリアライズされたデータ unserialize()メソッドを簡単にコールできます。

シリアル化またはアンシリアライズにてエラーに遭遇した際は常に Zend_SerializerZend_Serializer_Exception をスローします。

特定されたシリアライザーアダプターの設定をするために、配列か Zend_Configfactoryserialize()unserialize() メソッドに任意に追加できます:

  1. $serializer = Zend_Serializer::factory('Wddx', array(
  2.     'comment' => 'serialized by Zend_Serializer',
  3. ));
  4.  
  5. try {
  6.     $serialized = $serializer->serialize(
  7.         $data,
  8.         array('comment' => 'change comment')
  9.     );
  10.  
  11.     $unserialized = $serializer->unserialize(
  12.         $serialized,
  13.         array(/* options for unserialize */)
  14.     );
  15. } catch (Zend_Serializer_Exception $e) {
  16.     echo $e;
  17. }

factory()に与えらえたオプションはインスタンス化されたオブジェクトにとって妥当なものです。 setOption(s)メソッドを用いてこれらのオプションを 変更できます。単発の呼び出しだけをするために一つか それ以上の変更をするには、 serialize() または unserialize() を第二引数として渡します。

Example #2 Zend_Serializer の静的なインターフェイスの使用

Zend_Serializerとともに使用するのに特別なシリアライザーを標準のシリアル化 アダプターとして登録できます。デフォルトでは PhpSerialize アダプターが 登録されているでしょうが、静的メソッド setDefaultAdapter() を使用してこのオプションを変更できます。

  1. Zend_Serializer::setDefaultAdapter('PhpSerialize', $options);
  2. // or
  3. $serializer = Zend_Serializer::factory('PhpSerialize', $options);
  4. Zend_Serializer::setDefaultAdapter($serializer);
  5.  
  6. try {
  7.     $serialized   = Zend_Serializer::serialize($data, $options);
  8.     $unserialized = Zend_Serializer::unserialize($serialized, $options);
  9. } catch (Zend_Serializer_Exception $e) {
  10.     echo $e;
  11. }

Zend_Serializer