README

Binary-Driver 是一套 PHP 工具，用于构建二进制驱动程序。

为什么？

你可能想知道，为什么在可以使用 exec 或 symfony/process 的情况下还要构建库？.

这是一个简单的回答

如果你使用 exec、passthru、system、proc_open 或 PHP 中的任何低级进程处理，你应该看看 symfony/process 组件，它将提供一个面向对象、可移植、可测试和安全的接口来处理这些。一开始看起来很简单，但如果你看看这个组件的单元测试，你会发现简单地处理进程接口很容易变成一场噩梦。
如果你已经使用 symfony/process，并且想构建二进制驱动程序，你将始终有一组相同的方法和对象来配置、记录、调试和生成进程。这个库是实现任何具有这些共同需求的二进制驱动程序的基础。

AbstractBinary

AbstractBinary 提供了一个抽象类来构建二进制驱动程序。它实现了 BinaryInterface。

实现示例

use Alchemy\BinaryDriver\AbstractBinary;

class LsDriver extends AbstractBinary
{
    public function getName()
    {
        return 'ls driver';
    }
}

$parser = new LsParser();

$driver = Driver::load('ls');
// will return the output of `ls -a -l`
$parser->parse($driver->command(array('-a', '-l')));

二进制检测故障排除

如果你在使用 Nginx 与 PHP-fpm，由于 $_ENV['path'] 为空，可执行文件检测可能不起作用。为了避免出现空的 PATH 环境变量，请将以下行添加到你的 fastcgi_params 配置文件中（将 /your/current/path/ 替换为 printenv PATH 的输出）

fastcgi_param    PATH    /your/current/path

日志记录

你可以通过在加载方法中传入作为第二个参数的 Psr\Log\LoggerInterface 来记录事件。

$logger = new Monolog\Logger('driver');
$driver = Driver::load('ls', $logger);

监听器

你可以在进程中添加自定义监听器。监听器是基于 Evenement 构建的，并且必须实现 Alchemy\BinaryDriver\ListenerInterface。

use Symfony\Component\Process\Process;

class DebugListener extends EventEmitter implements ListenerInterface
{
    public function handle($type, $data)
    {
        foreach (explode(PHP_EOL, $data) as $line) {
            $this->emit($type === Process::ERR ? 'error' : 'out', array($line));
        }
    }

    public function forwardedEvents()
    {
        // forward 'error' events to the BinaryInterface
        return array('error');
    }
}

$listener = new DebugListener();

$driver = CustomImplementation::load('php');

// adds listener
$driver->listen($listener);

$driver->on('error', function ($line) {
    echo '[ERROR] ' . $line . PHP_EOL;
});

// removes listener
$driver->unlisten($listener);

捆绑的监听器

调试监听器是一个简单的监听器，用于捕获 stderr 和 stdout 输出；阅读实现以进行自定义。

use Alchemy\BinaryDriver\Listeners\DebugListener;

$driver = CustomImplementation::load('php');
$driver->listen(new DebugListener());

$driver->on('debug', function ($line) {
    echo $line;
});

ProcessBuilderFactory

ProcessBuilderFactory 通过生成 Symfony [Process] (https://symfony.com.cn/doc/master/components/process.html) 对象来简化进程的启动。

use Alchemy\BinaryDriver\ProcessBuilderFactory;

$factory = new ProcessBuilderFactory('/usr/bin/php');

// return a Symfony\Component\Process\Process
$process = $factory->create('-v');

// echoes '/usr/bin/php' '-v'
echo $process->getCommandLine();

$process = $factory->create(array('-r', 'echo "Hello !";'));

// echoes '/usr/bin/php' '-r' 'echo "Hello !";'
echo $process->getCommandLine();

配置

一个简单的配置对象，提供了 ArrayAccess 和 IteratorAggregate 接口。

use Alchemy\BinaryDriver\Configuration;

$conf = new Configuration(array('timeout' => 0));

echo $conf->get('timeout');

if ($conf->has('param')) {
    $conf->remove('param');
}

$conf->set('timeout', 20);

$conf->all();

使用 ArrayAccess 接口的同例

use Alchemy\BinaryDriver\Configuration;

$conf = new Configuration(array('timeout' => 0));

echo $conf['timeout'];

if (isset($conf['param'])) {
    unset($conf['param']);
}

$conf['timeout'] = 20;

许可证

本项目采用 MIT 许可证发布。

mronx / binary-driver

维护者

详细信息