Download the PHP package dale/phpickle without Composer
On this page you can find all versions of the php package dale/phpickle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download dale/phpickle
More information about dale/phpickle
Files in dale/phpickle
Package phpickle
Short Description PHP package for support python pickle format
License MIT
Informations about the package phpickle
Phpickle is a set of PHP classes that allow you to read and write the python pickle format. It is useful for integrating python and php applications together, for example to read django session data from a php application.
==============Basic usage:
require_once "phpickle.php";
$data = phpickle::loads($pickled_string);
If you want to unpickle from something that can be treated as a php stream, then:
require_once "phpickle.php";
$data = phpickle::load_stream("pickled_file.pickle"); $data = phpickle::load_stream("http://www.pickler.com/mydata"); // and others
If you want to unpickle data that was stored by the default django session handler, then:
require_once "phpickle.php";
$data = phpickle::loads_django_session($data_from_django_session_db);
If you want to pickle data, then:
require_once "phpickle.php";
$string = phpickle::dumps($data_to_pickle);
===============Current status:
Well, unpickling simple types, lists, tuples, dicts, ints, double, strings works. Unpickling class instances also works, but of course the instances are not the same as the ones in python. Instead stdClass instances are created, with all the data properties that are in the pickle and a few extra ones as well:
$inst->__python_class = "main.test"; $inst->python_construct_args__ = array();
__python_class is the package.class name for the python class that this instance represents. python_construct_args__ are the contructor arguments for creating the class instance in python.
Of course, referencing really python specific things, line REDUCE op that gives it's argument to a python method to produce a result cannot be supported.
Pickling support is there for simple types and arrays. Experimental support for objects is also there. Pickling back from previously unpickled data should produce the same result most of the time, but needs better test coverage.
===============Code setup:
tests folder has phpunit based tests for some of the modules.
Pickle is a very simple stack based language, the interpreter is in phpickle_unpickle.php and the read/write handlers for different opcodes are in the phpickle_op_handlers.pck. To generate the interpreter files, run make gen, that will generate phpickle_gen_read_ops.php and phpickle_gen_write_ops.php
To debug unpickling, call phpickle_unpickler->set_debug(true) and in the read handler code, just to if ($debug). In the handler code, you can read data from the $stream, using phpickle_stream methods and push results into $stack that is a phpickle_stack instance. $memo is for memorizing things.