PHP_Exporter

PHPUnit includes a nifty utility for generating human-readable strings based on PHP values. PHP_Exporter is simply a stand-alone version of that utility.

Usage

Exporting simple types:

<?php

require_once __DIR__.'/../vendor/autoload.php';

use PHP_Exporter\Exporter;

// 46
echo Exporter::export(46);

// 4.0
echo Exporter::export(4.0);

// 'hello, world!'
echo Exporter::export('hello, world!');

// false
echo Exporter::export(false);

// NAN
echo Exporter::export(acos(8));

// -INF
echo Exporter::export(log(0));

// null
echo Exporter::export(null);

// resource(13) of type (stream)
echo Exporter::export(fopen('php://stderr', 'w'));

// Binary String: 0x000102030405
echo Exporter::export(chr(0) . chr(1) . chr(2) . chr(3) . chr(4) . chr(5));

Exporting complex types:

<?php

require_once __DIR__.'/../vendor/autoload.php';

use PHP_Exporter\Exporter;

/*
Array &0 (
    0 => Array &1 (
        0 => 1
        1 => 2
        2 => 3
    )
    1 => Array &2 (
        0 => ''
        1 => 0
        2 => false
    )
)
*/
echo Exporter::export(array(array(1,2,3), array("",0,FALSE)));

/*
Array &0 (
    'self' => Array &1 (
        'self' => Array &1
    )
)
*/
$array = array();
$array['self'] = &$array;
echo Exporter::export($array);

/*
stdClass Object &0000000003a66dcc0000000025e723e2 (
    'self' => stdClass Object &0000000003a66dcc0000000025e723e2
)
*/
$obj = new stdClass();
$obj->self = $obj;
echo Exporter::export($obj);

Compact exports:

<?php

require_once __DIR__.'/../vendor/autoload.php';

use PHP_Exporter\Exporter;

// Array ()
echo Exporter::shortenedExport(array());

// Array (...)
echo Exporter::shortenedExport(array(1,2,3,4,5));

// stdClass Object ()
echo Exporter::shortenedExport(new stdClass);

// Exception Object (...)
echo Exporter::shortenedExport(new Exception);

// this\nis\na\nsuper\nlong\nstring\nt...\nspace
echo Exporter::shortenedExport(
<<<LONG_STRING
this
is
a
super
long
string
that
wraps
a
lot
and
eats
up
a
lot
of
space
LONG_STRING
);

Requirements

PHP_Exporter works with PHP 5.3.3 or later.

Installation

The recommended way to install PHP_Exporter is through composer. Just create a composer.json file and run the php composer.phar install command to install it:

{
    "require": {
        "php-exporter/php-exporter": "1.0.*@dev"
    }
}

Tests

To run the test suite, you need composer.

$ php composer.phar install --dev
$ vendor/bin/phpunit

Acknowledgements

This utility was adapted from the PHPUnit project. A special thanks goes to the following people for their contributions:

• sebastianbergmann
• edorian
• LawnGnome
• bschussek

License

PHP_Exporter is licensed under the BSD 3-Clause license.