流程组件
编辑该页面警告:你浏览的文档欧宝官网下载appob娱乐下载Symfony 4.3,不再维护。
读这个页面的更新版本Symfob娱乐下载ony 6.2(当前的稳定版本)。
流程组件
在子过程中流程组件执行命令。
安装
1
美元作曲家需要symfony /过程ob娱乐下载请注意
如果你安装这个组件之外的Symfony应用程序,你必须要求ob娱乐下载供应商/ autoload.php文件在你的代码,使作曲家提供的类加载机制。读这篇文章为更多的细节。
使用
的过程类在子流程执行一个命令,照顾操作系统之间的差异和逃避参数来防止安全问题。它取代PHP函数执行,passthru,shell_exec和系统:
1 2 3 4 5 6 7 8 9 10 11 12
使用ob娱乐下载\组件\过程\异常\ProcessFailedException;使用ob娱乐下载\组件\过程\过程;美元过程=新过程([“ls”,“文理学院”]);美元过程- >run ();/ /命令完成后执行如果(!美元过程- >isSuccessful ()) {扔新ProcessFailedException (美元过程);}回声美元过程- >getOutput ();的getOutput ()方法总是返回命令的标准输出的整个内容getErrorOutput ()错误输出的内容。或者,getIncrementalOutput ()和getIncrementalErrorOutput ()方法返回新的输出自上次电话。
的clearOutput ()清除输出的内容和方法clearErrorOutput ()清除错误输出的内容。
您还可以使用过程类的每个构建时生成的输出。默认情况下,循环等待新的输出到下一个迭代之前:
1 2 3 4 5 6 7 8 9 10
美元过程=新过程([“ls”,“文理学院”]);美元过程- >开始();foreach(美元过程作为美元类型= >美元数据){如果(美元过程::出= = =美元类型){回声“从stdout \ nRead:“。美元数据;}其他的{/ /流程:美元:呃= = = $类型回声“从stderr \ nRead:“。美元数据;}}提示
内部流程组件使用一个PHP迭代器输出时生成。迭代器是通过公开getIterator ()方法允许自定义其行为:
1 2 3 4 5 6
美元过程=新过程([“ls”,“文理学院”]);美元过程- >开始();美元迭代器=美元过程- >getIterator (美元过程::ITER_SKIP_ERR |美元过程::ITER_KEEP_OUTPUT);foreach(美元迭代器作为美元数据){回声美元数据。“\ n”;}的mustRun ()方法是相同的run (),除了它将抛出一个ProcessFailedException如果进程无法成功执行(即过程与一个非零退出代码):
1 2 3 4 5 6 7 8 9 10 11 12
使用ob娱乐下载\组件\过程\异常\ProcessFailedException;使用ob娱乐下载\组件\过程\过程;美元过程=新过程([“ls”,“文理学院”]);试一试{美元过程- >mustRun ();回声美元过程- >getOutput ();}抓(ProcessFailedException美元异常){回声美元异常- >getMessage ();}从OS Shell使用特性
推荐的方法是使用数组的参数定义的命令。这样可以避免任何逃离,并允许无缝地发送信号(如停止进程完成之前):
1 2
美元过程=新过程([“/道路/命令”,”,选择“,“参数”,“等等。”]);美元过程=新过程([/道路/ / php的,“——定义”,“memory_limit = 1024”,“/道路/ / script.php”]);如果你需要使用流重定向,有条件执行,或任何其他功能提供的外壳你的操作系统,您还可以使用命令定义为字符串fromShellCommandline ()静态工厂。
每个操作系统提供了一个不同的命令行语法,所以它变成了你的责任逃避和可移植性。
当使用字符串定义命令,变量参数作为环境变量使用第二个参数传递run (),mustRun ()或start ()方法。引用他们也依赖于:
1 2 3 4 5 6 7 8
/ /在类unix操作系统(Linux, macOS)美元过程=过程::fromShellCommandline (“回声“元信息””);/ /在Windows上美元过程=过程::fromShellCommandline (“回声”消息!”);/ /类unix和Windows美元过程- >运行(零,(“消息”= >“输出的东西”]);设置环境变量的过程
的构造函数过程类和它的所有方法执行相关流程(run (),mustRun (),start ()等)允许通过一组环境变量设置在运行过程:
1 2 3
美元过程=新过程([“……”),零,(“ENV_VAR_NAME”= >“价值”]);美元过程=过程::fromShellCommandline (“……”,零,(“ENV_VAR_NAME”= >“价值”]);美元过程- >运行(零,(“ENV_VAR_NAME”= >“价值”]);除了env var通过明确、流程继承系统中定义的所有env var。你可以防止这种通过设置假你想要删除的env var:
1 2 3 4
美元过程=新过程([“……”),零,(“APP_ENV”= >假,“ob娱乐下载SYMFONY_DOTENV_VARS”= >假]);获得实时的过程输出
当执行一个长时间运行的命令(如rsync远程服务器),可以实时反馈给最终用户通过一个匿名函数run ()方法:
1 2 3 4 5 6 7 8 9 10
使用ob娱乐下载\组件\过程\过程;美元过程=新过程([“ls”,“文理学院”]);美元过程- >运行(函数(美元类型,美元缓冲){如果(过程::呃= = =美元类型){回声“呃>”。美元缓冲;}其他的{回声“>”。美元缓冲;}});请注意
此功能无法正常工作在服务器上使用PHP输出缓冲。在这些情况下,禁用output_buffering或使用PHP选项ob_flushPHP函数强迫发送输出缓冲区。
异步运行的流程
你也可以异步启动子流程,然后让它运行,检索输出和状态在你的主要过程中当你需要它。使用start ()开始一个异步的过程,方法正在()方法检查过程和完成getOutput ()方法得到的输出:
1 2 3 4 5 6 7 8
美元过程=新过程([“ls”,“文理学院”]);美元过程- >开始();而(美元过程- >正在()){/ /等待过程完成}回声美元过程- >getOutput ();你也可以等待一个异步过程结束,如果你开始和完成做其他东西:
1 2 3 4 5 6 7 8
美元过程=新过程([“ls”,“文理学院”]);美元过程- >开始();/ /……做其他的事情美元过程- >wait ();/ /……后做事情的过程已经完成了吗请注意
的wait ()方法阻断,这意味着您的代码将在这条线,直到停止外部过程完成。
请注意
如果一个响应发送之前子进程有机会完成,服务器进程就会被杀死(根据您的操作系统)。这意味着你的任务将被停止。运行一个异步的过程是不一样的运行过程,它的父进程。
如果你想让你的进程在请求/响应周期,你可以利用kernel.terminate事件,运行命令同步在这个事件。请注意,kernel.terminate只有你使用PHP-FPM叫做。
谨慎
也要小心,如果你这样做,说PHP-FPM过程将不会提供给任何新的请求,直到子进程结束。这意味着您可以快速块FPM池如果你不够小心。这就是为什么通常方式最好不要做任何花哨的东西即使在发送请求,但是使用一个工作队列。
wait ()接受一个可选参数:一个反复调用回调而进程仍在运行,通过在输出和它的类型:
1 2 3 4 5 6 7 8 9 10
美元过程=新过程([“ls”,“文理学院”]);美元过程- >开始();美元过程- >等待(函数(美元类型,美元缓冲){如果(过程::呃= = =美元类型){回声“呃>”。美元缓冲;}其他的{回声“>”。美元缓冲;}});而不是等到过程完成后,您可以使用waitUntil ()方法继续或停止等待基于一些PHP逻辑。下面的例子开始一个长时间运行的流程,检查其输出等到完全初始化:
1 2 3 4 5 6 7 8 9 10 11
美元过程=新过程([“/ usr / bin / php”,“slow-starting-server.php”]);美元过程- >开始();/ /……做其他的事情/ /等待,直到给定的匿名函数返回true美元过程- >waitUntil (函数(美元类型,美元输出){返回美元输出= = =“准备好了。等待命令……”;});/ /……做事过程后,准备好了吗标准输入流的一个过程
流程开始之前,你可以指定它的标准输入使用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。请阅读信号下面文档欧宝官网下载app找到更多关于信号处理的流程组件:
1 2 3 4 5 6
美元过程=新过程([“ls”,“文理学院”]);美元过程- >开始();/ /……做其他的事情美元过程- >停止(3、信号情报);独立执行的PHP代码
如果你想要执行一些PHP代码隔离,使用PhpProcess而不是:
1 2 3 4 5 6 7
使用ob娱乐下载\组件\过程\PhpProcess;美元过程=新PhpProcess (< < < EOF < ?='Hello World' ?> EOF);美元过程- >run ();过程超时
默认流程有一个60秒的超时,但是你可以改变它通过不同的超时时间(以秒为单位)setTimeout ()方法:
1 2 3 4 5
使用ob娱乐下载\组件\过程\过程;美元过程=新过程([“ls”,“文理学院”]);美元过程- >setTimeout (3600年);美元过程- >run ();如果超时,ProcessTimedOutException抛出。
对于长时间运行的命令,这是你的责任来执行超时定期检查:
1 2 3 4 5 6 7 8 9 10 11
美元过程- >setTimeout (3600年);美元过程- >开始();而(美元条件){/ /……/ /检查是否超时美元过程- >checkTimeout ();usleep (200000年);}过程闲置超时
前款规定的超时相比,闲置超时只考虑时间自上次输出是由过程:
1 2 3 4 5 6
使用ob娱乐下载\组件\过程\过程;美元过程=新过程([“something-with-variable-runtime”]);美元过程- >setTimeout (3600年);美元过程- >setIdleTimeout (60);美元过程- >run ();在上面的案例中,一个过程被认为是超时,当总运行时间超过3600秒,或过程不会产生任何输出60秒。
过程的信号
当异步运行一个程序时,你可以把它与POSIX信号信号()方法:
1 2 3 4 5 6 7
使用ob娱乐下载\组件\过程\过程;美元过程=新过程([“发现”,' / ',“- name”,“兔子”]);美元过程- >开始();/ /将发送SIGKILL过程美元过程- >信号(SIGKILL);过程Pid
1 2 3 4 5 6
使用ob娱乐下载\组件\过程\过程;美元过程=新过程([“/ usr / bin / php”,“worker.php”]);美元过程- >开始();美元pid=美元过程- >getPid ();禁用输出
标准输出和错误输出总是从底层获取过程,它可能是方便禁用输出在某些情况下节省内存。使用disableOutput ()和enableOutput ()这个功能切换:
1 2 3 4 5
使用ob娱乐下载\组件\过程\过程;美元过程=新过程([“/ usr / bin / php”,“worker.php”]);美元过程- >disableOutput ();美元过程- >run ();谨慎
你不能启用或禁用在流程运行时的输出。
如果您禁用输出,你不能访问getOutput (),getIncrementalOutput (),getErrorOutput (),getIncrementalErrorOutput ()或setIdleTimeout ()。
然而,可以通过回调的开始,运行或mustRun方法来处理过程输出流的方式。
找到可执行PHP二进制文件
该组件还提供了一个实用程序类PhpExecutableFinder它返回PHP二进制可执行文件的绝对路径可用服务器上:
1 2 3 4 5
使用ob娱乐下载\组件\过程\PhpExecutableFinder;美元phpBinaryFinder=新PhpExecutableFinder ();美元phpBinaryPath=美元phpBinaryFinder- >find ();/ / $ phpBinaryPath = / usr /地方/ bin / php的(结果将是不同的在你的电脑上)检查TTY支持
该组件提供的另一个工具是一个方法调用isTtySupported ()它返回是否TTY支持当前操作系统:
1 2 3
使用ob娱乐下载\组件\过程\过程;美元过程= (新过程())- >setTty(过程::isTtySupported ());
