流程组件
编辑该页面警告:你浏览的文档欧宝体育电话欧宝娱乐app下载地址Symfony 3.3,不再维护。
读这个页面的更新版本Symf欧宝娱乐app下载地址ony 6.2(当前的稳定版本)。
流程组件
在子过程中流程组件执行命令。
安装
您可以安装组件在两个不同的方面:
- 安装它通过作曲家(
欧宝娱乐app下载地址symfony /过程
在Packagist); - 使用官方的Git存储库(https://github.com/欧宝娱乐app下载地址symfony/process)。
然后,需要供应商/ autoload.php
文件,使作曲家提供的半自动的机制。否则,您的应用程序无法找到这个Symfony组件的类。欧宝娱乐app下载地址
使用
的过程类允许您执行一个命令子流程:
1 2 3 4 5 6 7 8 9 10 11 12
使用欧宝娱乐app下载地址\组件\过程\过程;使用欧宝娱乐app下载地址\组件\过程\异常\ProcessFailedException;美元过程=新过程(ls lsa的);美元过程- >run ();/ /命令完成后执行如果(!美元过程- >isSuccessful ()) {扔新ProcessFailedException (美元过程);}回声美元过程- >getOutput ();
组件负责不同的平台之间的细微差别,当执行该命令。
的getOutput ()
方法总是返回命令的标准输出的整个内容getErrorOutput ()
错误输出的内容。或者,getIncrementalOutput ()和getIncrementalErrorOutput ()方法返回新的输出自上次电话。
的clearOutput ()清除输出的内容和方法clearErrorOutput ()清除错误输出的内容。
您还可以使用过程类与foreach构造时生成的输出。默认情况下,循环等待新的输出到下一个迭代之前:
1 2 3 4 5 6 7 8 9 10
美元过程=新过程(ls lsa的);美元过程- >开始();foreach(美元过程作为美元类型= >美元数据){如果(美元过程::出= = =美元类型){回声“从stdout \ nRead:“。美元数据;}其他的{/ /流程:美元:呃= = = $类型回声“从stderr \ nRead:“。美元数据;}}
提示
内部流程组件使用一个PHP迭代器输出时生成。迭代器是通过公开getIterator ()
方法允许自定义其行为:
1 2 3 4 5 6
美元过程=新过程(ls lsa的);美元过程- >开始();美元迭代器=美元过程- >getIterator (美元过程::ITER_SKIP_ERR |美元过程::ITER_KEEP_OUTPUT);foreach(美元迭代器作为美元数据){回声美元数据。“\ n”;}
3.2
的getIterator ()
方法是在Symfony 3.2中引入的。欧宝娱乐app下载地址
的mustRun ()
方法是相同的run ()
,除了它将抛出一个ProcessFailedException如果进程无法成功执行(即过程与一个非零退出代码):
1 2 3 4 5 6 7 8 9 10 11 12
使用欧宝娱乐app下载地址\组件\过程\异常\ProcessFailedException;使用欧宝娱乐app下载地址\组件\过程\过程;美元过程=新过程(ls lsa的);试一试{美元过程- >mustRun ();回声美元过程- >getOutput ();}抓(ProcessFailedException美元e){回声美元e- >getMessage ();}
获得实时的过程输出
当执行一个长时间运行的命令(如rsync-ing文件到远程服务器),你可以给实时反馈给最终用户通过一个匿名函数run ()方法:
1 2 3 4 5 6 7 8 9 10
使用欧宝娱乐app下载地址\组件\过程\过程;美元过程=新过程(ls lsa的);美元过程- >运行(函数(美元类型,美元缓冲){如果(过程::呃= = =美元类型){回声“呃>”。美元缓冲;}其他的{回声“>”。美元缓冲;}});
异步运行的流程
你也可以异步启动子流程,然后让它运行,检索输出和状态在你的主要过程中当你需要它。使用start ()开始一个异步的过程,方法正在()方法检查过程和完成getOutput ()方法得到的输出:
1 2 3 4 5 6 7 8
美元过程=新过程(ls lsa的);美元过程- >开始();而(美元过程- >正在()){/ /等待过程完成}回声美元过程- >getOutput ();
你也可以等待一个异步过程结束,如果你开始和完成做其他东西:
1 2 3 4 5 6 7 8
美元过程=新过程(ls lsa的);美元过程- >开始();/ /……做其他的事情美元过程- >wait ();/ /……后做事情的过程已经完成了吗
请注意
的wait ()方法阻断,这意味着您的代码将在这条线,直到停止外部过程完成。
请注意
如果一个响应
发送之前子进程有机会完成,服务器进程就会被杀死(根据您的操作系统)。这意味着你的任务将被停止。运行一个异步的过程是不一样的运行过程,它的父进程。
如果你想让你的进程在请求/响应周期,你可以利用kernel.terminate
事件,运行命令同步在这个事件。请注意,kernel.terminate
只有你使用PHP-FPM叫做。
谨慎
也要小心,如果你这样做,说PHP-FPM过程将不会提供给任何新的请求,直到子进程结束。这意味着您可以快速块FPM池如果你不够小心。这就是为什么通常方式最好不要做任何花哨的东西即使在发送请求,但是使用一个工作队列。
wait ()接受一个可选参数:一个反复调用回调而进程仍在运行,通过在输出和它的类型:
1 2 3 4 5 6 7 8 9 10
美元过程=新过程(ls lsa的);美元过程- >开始();美元过程- >等待(函数(美元类型,美元缓冲){如果(过程::呃= = =美元类型){回声“呃>”。美元缓冲;}其他的{回声“>”。美元缓冲;}});
标准输入流的一个过程
流程开始之前,你可以指定它的标准输入使用setInput ()方法或4参数的构造函数。所提供的输入可以是一个字符串,流资源或可反驳的对象:
1 2 3
美元过程=新过程(“猫”);美元过程- >setInput (“foobar”);美元过程- >run ();
当这个输入完全写入子进程的标准输入,相应的管道关闭。
为了写子进程的标准输入运行时组件提供了InputStream类:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
美元输入=新InputStream ();美元输入- >写(“foo”);美元过程=新过程(“猫”);美元过程- >setInput (美元输入);美元过程- >开始();/ /……阅读过程输出或做其他事情美元输入- >写(“酒吧”);美元输入- >close ();美元过程- >wait ();/ /将回声:foobar回声美元过程- >getOutput ();
的write ()方法接受标量、流资源或可反驳的对象作为参数。在上面的示例中所示,您需要显式地调用close ()方法当你完成写作到子进程的标准输入。
使用PHP作为进程的标准输入流
流程的输入也可以定义使用PHP流:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
美元流= fopen (php: / /临时的,“w +”);美元过程=新过程(“猫”);美元过程- >setInput (美元流);美元过程- >开始();写入文件(美元流,“foo”);/ /……阅读过程输出或做其他事情写入文件(美元流,“酒吧”);fclose (美元流);美元过程- >wait ();/ /将回声:“foobar”回声美元过程- >getOutput ();
停止一个进程
任何异步过程可以停在任何时间stop ()方法。该方法接受两个参数:一个超时和一个信号。一旦超时,信号发送到正在运行的进程。默认的信号发送到一个过程SIGKILL
。请阅读信号下面文档欧宝体育电话找到更多关于信号处理的流程组件:
1 2 3 4 5 6
美元过程=新过程(ls lsa的);美元过程- >开始();/ /……做其他的事情美元过程- >停止(3、信号情报);
独立执行的PHP代码
如果你想要执行一些PHP代码隔离,使用PhpProcess
而不是:
1 2 3 4 5 6 7
使用欧宝娱乐app下载地址\组件\过程\PhpProcess;美元过程=新PhpProcess (< < < EOF < ?php echo“Hello World”;? > EOF);美元过程- >run ();
让你的代码在所有平台上做得更好,你可能想要使用ProcessBuilder类:
1 2 3 4
使用欧宝娱乐app下载地址\组件\过程\ProcessBuilder;美元构建器=新ProcessBuilder (数组(“ls”,“文理学院”));美元构建器- >getProcess ()- >run ();
如果你正在构建一个二进制驱动程序,您可以使用setPrefix ()方法前缀的所有命令生成的过程。
下面的例子将生成两个过程焦油二进制适配器的命令:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
使用欧宝娱乐app下载地址\组件\过程\ProcessBuilder;美元构建器=新ProcessBuilder ();美元构建器- >setPrefix (“/ usr / bin /焦油”);/ /“/ usr / bin /焦油”“列表——”“——文件= archive.tar.gz”回声美元构建器- >setArguments (数组(“——列表”,“——文件= archive.tar.gz”))- >getProcess ()- >getCommandLine ();/ / / usr / bin /焦油的‘-xzf’‘archive.tar.gz’回声美元构建器- >setArguments (数组(“-xzf”,“archive.tar.gz”))- >getProcess ()- >getCommandLine ();
过程超时
您可以限制过程需要完成的时间通过设置一个超时(秒):
1 2 3 4 5
使用欧宝娱乐app下载地址\组件\过程\过程;美元过程=新过程(ls lsa的);美元过程- >setTimeout (3600年);美元过程- >run ();
如果超时,RuntimeException抛出。
对于长时间运行的命令,这是你的责任来执行超时定期检查:
1 2 3 4 5 6 7 8 9 10 11
美元过程- >setTimeout (3600年);美元过程- >开始();而(美元条件){/ /……/ /检查是否超时美元过程- >checkTimeout ();usleep (200000年);}
过程闲置超时
前款规定的超时相比,闲置超时只考虑时间自上次输出是由过程:
1 2 3 4 5 6
使用欧宝娱乐app下载地址\组件\过程\过程;美元过程=新过程(“something-with-variable-runtime”);美元过程- >setTimeout (3600年);美元过程- >setIdleTimeout (60);美元过程- >run ();
在上面的案例中,一个过程被认为是超时,当总运行时间超过3600秒,或过程不会产生任何输出60秒。
过程的信号
当异步运行一个程序时,你可以把它与POSIX信号信号()方法:
1 2 3 4 5 6 7
使用欧宝娱乐app下载地址\组件\过程\过程;美元过程=新过程(“查找/ - name“兔子”);美元过程- >开始();/ /将发送SIGKILL过程美元过程- >信号(SIGKILL);
谨慎
由于一些限制在PHP中,如果你使用信号流程组件,你的命令,你可能需要前缀执行。请阅读欧宝娱乐app下载地址Symfony的问题# 5759和PHP错误# 39992要理解为什么这是发生。
POSIX信号不可用在Windows平台上,请参考PHP文欧宝体育电话档可用的信号。
过程Pid
1 2 3 4 5 6
使用欧宝娱乐app下载地址\组件\过程\过程;美元过程=新过程(“/ usr / bin / php worker.php”);美元过程- >开始();美元pid=美元过程- >getPid ();
谨慎
由于一些限制在PHP中,如果你想获得一个symfony的pid的过程,你可能需要前缀你的命令欧宝娱乐app下载地址执行。请阅读欧宝娱乐app下载地址Symfony的问题# 5759要理解为什么这是发生。
禁用输出
标准输出和错误输出总是从底层获取过程,它可能是方便禁用输出在某些情况下节省内存。使用disableOutput ()和enableOutput ()这个功能切换:
1 2 3 4 5
使用欧宝娱乐app下载地址\组件\过程\过程;美元过程=新过程(“/ usr / bin / php worker.php”);美元过程- >disableOutput ();美元过程- >run ();
谨慎
你不能启用或禁用在流程运行时的输出。
如果您禁用输出,你不能访问getOutput ()
,getIncrementalOutput ()
,getErrorOutput ()
,getIncrementalErrorOutput ()
或setIdleTimeout ()
。
然而,可以通过回调的开始
,运行
或mustRun
方法来处理过程输出流的方式。
3.1
这些方法能够传递一个回调在Symfony 3.1中增加了禁用输出时。欧宝娱乐app下载地址