[扩展推荐] Terminal —— 封装 Symfony Process,优雅地在 PHP 中调用 Linux 命令

Terminal 是 Titas Gailius 提供的一个简洁的 PHP 扩展包,它封装了 “Symfony 的 Process 组件”,并且拥有流畅的接口。这使得执行终端命令更加轻松便捷。
Terminal::in(storage_path('sites/123'))
->timeout(120)
->retries(3)
->run('wp cli update');
最简单的使用方式,可以像下面这样执行一个命令。这样去除了大量样板和symfony process组件中的低层次信息:
$response = Terminal::run('rm -rf vendor');
下面是一些可以对响应结果做的一些操作:
$response->code() : int;
$response->ok() : bool;
$response->successful() : bool;
$response->lines() : array;
$response->output() : string;
(string) $response: string;
// 抛出终端可以捕获的异常
$response->throw();
// 您可以访问 symfony 进程
$response->process();
// 所有在响应上找不到的调用都会被传递到 Symfony 进程
// \Symfony\Component\Process\Process::isRunning()
$response->isRunning();
下面是一些简洁的示例:
// 给命令传递参数
Terminal::with([
'firstname' => 'John',
'lastname' => 'Doe',
])->run('echo Hello, {{ $firstname}} {{ $lastname }}');
// 每次重试之间的重试次数和持续时间
Terminal::retries(3, 100)->run('rm -rf vendor');
// 环境变量
Terminal::withEnvironmentVariables([
'APP_ENV' => 'testing',
])->run('rm -rf $DIRECTORY');
您可以在TitasGailius/terminal 了解更多关于这个包的信息、完整的安装说明或者查看源代码。
本文中的所有译文仅用于学习和交流目的,转载请务必注明文章译者、出处、和本文链接
我们的翻译工作遵照 CC 协议,如果我们的工作有侵犯到您的权益,请及时联系我们。
本帖已被设为精华帖!
关于 LearnKu
牛,这个也封装成链式操作了
如果项目使用的是 php8 版本,而系统默认的 php -v 是 7 版本,而又有其他项目需要默认的7 版本,不能切换成 8 版本,这时候执行 Terminal::run() 命令,即时是命令中指定了各种命令的绝对地址,也会失败,因为 composer 会进行check,只需要在 compser.json 中添加 "config": { "platform-check": false // 不进行平台检查 } 即可,也可以将动态命令写入到一个文件中,定时通过 crontab 执行 shell,或者通过 php 本身打开一个进程单独进行执行