mtrbean/mongo-json

A helper library for serializing MongoDB types to JSON string

MongoJson

A small library that JSON encode an Mongo document that contains MongoDB-specific types (e.g. MongoDate)., _(*1)

If you just use json_encode(), you will get some PHP specific results that makes it very difficult to interface with other part of your program. This library attempts to implement the 'strict mode' and also the 'javascript (JSONP) mode' defined in http://docs.mongodb.org/manual/reference/mongodb-extended-json/, _(*2)

Installation using Composer

Create a composer.json file in your project root:, _(*3)

{
    "require": {
        "mtrbean/mongo-json": "1.*"
    }
}

Install via composer:, _(*4)

php composer.phar install

P.S. If you haven't already been using composer for managing your dependency, you can install it via:, _(*5)

curl -sS https://getcomposer.org/installer | php

Autoload

You can have the class MongoJson autoloaded using the mechanism provided by composer:, _(*6)

require 'vendor/autoload.php';

Usage

Strict Mode

$doc = array("dt" => new MongoDate);
echo MongoJson::strict($doc);

will print:, _(*7)

{"dt":{"$date":1371525158000}}

Extended Mode

$doc = array("dt" => new MongoDate);
echo MongoJson::extended($doc);

will print:, _(*8)

{"dt":new Date(1371525158000)}

Options

You can pass extra options that you can normally use with json_encode(), _(*9)

$doc = array("_id" => new MongoId, "regex" => new MongoRegex('/^acme.*corp/i'));
echo MongoJson::extended($doc, JSON_PRETTY_PRINT); // will prettify the JSON string

will print:, _(*10)

{
    "_id": {
        "$oid": "51bfcdd71ede01d61a000000"
    },
    "regex": /^acme.*corp/i
}

License

MIT, _(*11)

Contribute

Feel free to fork and submit pull requests!, _(*12)