library libphutil

mtrunkat/libphutil

Composer compatible version (not official) of Libphutil library.

Composer compatible version of Facebook's Libphutil library

This is not offical port. I created this mainly to use Futures so the rest of the library may not work correctly., _(*1)

Script that I use for conversion can be found here mtrunkat/php-libphutil-composer-convertor., _(*2)

For more information about Libphutil check Github repository and official documentation., _(*3)

Installation

Add this (Packagist) library into you composer.json:, _(*4)

{
    "require" : {
        "mtrunkat/lbphutil" : "dev-master"
    }
}

And install it via php composer.phar install or php composer.phar update., _(*5)

Example use

All the classes of original library are moved into Facebook\Libphutil namespace and each function [functionname] located in some file [filename].php is converted into static method Facebook\Libphutil\Functions[filename]::[functionname]., _(*6)

So for example in original library you use Futures this way:, _(*7)

<?php

require_once 'path/to/libphutil/src/__phutil_library_init__.php';

$futures = array();
$futures['test a'] = new ExecFuture('ls');
$futures['test b'] = new ExecFuture('ls -l -a');

foreach (Futures($futures) as $dir => $future) {
    list($stdout, $stderr) = $future->resolvex();

    print $stdout;
}

But in Composer version of library you have to specify namespace for classes and convert functions into static methods:, _(*8)

<?php

require_once 'vendor/autoload.php';

use Facebook\Libphutil\ExecFuture;
use Facebook\Libphutil\Functions\functions;

$futures = array();
$futures['test a'] = new ExecFuture('ls');
$futures['test b'] = new ExecFuture('ls -l -a');

foreach (functions::Futures($futures) as $dir => $future) {
    list($stdout, $stderr) = $future->resolvex();

    print $stdout;
}

You can see that class ExecFuture in now in Facebook\Libphutil namespace and function Futures() originally located in file functions.php is now static method of class Facebook\Libphutil\Functions\functions., _(*9)