Navel Piercing Madness

    php-serialization

    0.0.4 • Public • Published

    php-serialization

    Javascript tool to unserialize php serialized data, or to serialize data the way php does. This was originally used in manipulating php session stored in redis server.

    This also supports Laravel extended php session serialization (can be used to serialize/unserialize Laravel session) Installation

    Node.js

    Install from npm:

    npm install php-serialization

    Usage

    Unserialize

    var unserialize=require("php-serialization").unserialize;
    var result=unserialize("a:1:{s:3:\"key\";s:11:\"hello world\"}");
    console.log(result.key);
    //hello world

    Serialize

    var serialize=require("php-serialization").serialize;
    var Class=require("php-serialization").Class;
    var c=new Class("") //array
    var o=new Class("MongoId") //object
    o.__addAttr__("_value","string","123efa21bc123","string");
    o.__addAttr__("_private_value","string","i'm private","string","private");
    o.__addAttr__("_protected_value","string","i'm protected","string","protected");
    c.__addAttr__("_id","string",o,"object");
    console.log(serialize(c,"array"));
    //a:1:{s:3:"_id";O:7:"MongoId":3:{s:6:"_value";s:13:"123efa21bc123";s:23:"MongoId_private_value";s:11:"i'm private";s:19:"*_protected_value";s:13:"i'm protected";}}

    Notes

    This project was originally used in manipulating sessions between Nodejs and Laravel 4. So certain code complexities were added to implement all Laravel 4 session serialization feature.

    Breif introduction of the serialization format

    *normal php session will work the same.
    B       [01]
    D       [0-9]
    S       [a-zA-Z0-9_]
    K       integer|string
    V       integer|string+|float|boolean|null|class|array|object
    integer i:<D+>;                                 //i:<value>;
    float   d:<D+.D+>;                              //d:<value>;
    string  s:<D+>:"<S+>";                          //s:<length of string>:"<string>";
    boolean b:<B>;                                  //b:<true of false>; notice that it can only be either 1 or 0;
    null    n;                                      //
    class   c:<D+>:"<S+>":<D+>:{<S+>}               //c:<length of class name>:<class name>:<length of value>:{<value>}   notice that this is a general class, it presents the serialized valye of a class (reasons are still unknown,only seen in laravel). For general meaning class,please see *Object*
    array   a:<D+>:{<[KV]+>}                        //a:<size of properties>:{<property_key><property_value>......}
    object  o:<D+>:"<S+>":<D+>:{<[KV]+>}            //o:<length of object/class name>:"<object/class name>":<size of properties>:{<property_key><property_value>......}
    resource r:<D+>;                                //r:<resource id>;
    

    API References

    unserialize(str:string);

    serialize(obj:*,type:string);

    type is the value from above format list;
    

    new Class(name:string);

    if name is null,it means it's a normal array/object (not a class)
    

    Class.__has__(key:string);

    Class.__addAttr__(key:*,keyType:string,value:*,valueType:string,scope:string="public",getter:Function=default,setter:Function=default);

    notice that *key* can only be integer or string;
    *keyType* and *valueType* indicates the type of key/value;
    *scope* can be public,protected,private ;
    *getter* and *setter* are called when getting/setting this value. default setter/getter are provided,which would be simple return/set values.(eg,without typechecking,etc);
    

    Class.__typeOf__(key:string);

    Class.__keyTypeOf__(key:string);

    Class.__scopeOf__(key:string);

    Install

    npm i php-serialization

    DownloadsWeekly Downloads

    1,242

    Version

    0.0.4

    License

    BSD-2-Clause

    Last publish

    Collaborators

    • joesonw