README

Ruby PHP Serializer

=============

This module provides two methods: PHP.serialize() and PHP.unserialize(), both of which should be compatible with the similarly named functions in PHP.

Basic usage:

 require 'php_serialize'
 in = {'foo' => 'bar'}
 php = PHP.serialize(in)
 # pass string to PHP unserialize() to get array('foo' => 'bar')
 out = PHP.unserialize(php) # => {'foo' => 'bar'}

PHP.unserialize can also read PHP sessions, which are collections of named serialized objects. These can be reserialized using PHP.serialize_session(), which has the same semantics as PHP.serialize(), but which only supports Hash and associative Arrays for the root object.

Acknowledgements

==========

TJ Vanderpoel, initial PHP serialized session support.

Philip Hallstrom, fix for self-generated Structs on unserialization.

Edward Speyer, fix for assoc serialization in nested structures.

Author: Thomas Hurst <tom@hur.st>, hur.st/ WWW: www.aagh.net/projects/ruby-php-serialize