Php/docs/function.system

• PHP Manual
• 程序执行函数
• 执行外部程序，并且显示输出

system

(PHP 4, PHP 5, PHP 7)

system — 执行外部程序，并且显示输出

说明

system ( string $command [, int &$return_var ] ) : string

同 C 版本的 system() 函数一样， 本函数执行 command 参数所指定的命令， 并且输出执行结果。

如果 PHP 运行在服务器模块中， system() 函数还会尝试在每行输出完毕之后， 自动刷新 web 服务器的输出缓存。

如果要获取一个命令未经任何处理的 原始输出， 请使用 passthru() 函数。

参数

command

要执行的命令。

return_var

如果提供 return_var 参数， 则外部命令执行后的返回状态将会被设置到此变量中。

返回值

成功则返回命令输出的最后一行， 失败则返回 false

范例

Example #1 system() 例程

<?phpecho '<pre>';// 输出 shell 命令 "ls" 的返回结果// 并且将输出的最后一样内容返回到 $last_line。// 将命令的返回值保存到 $retval。$last_line = system('ls', $retval);// 打印更多信息echo '</pre><hr />Last line of the output: ' . $last_line . '<hr />Return value: ' . $retval;?>

注释

Warning 当用户提供的数据传入此函数，使用 escapeshellarg() 或 escapeshellcmd() 来确保用户欺骗系统从而执行任意命令。

Note:

如何程序使用此函数启动，为了能保持在后台运行，此程序必须将输出重定向到文件或其它输出流。否则会导致 PHP 挂起，直至程序执行结束。

参见

• exec() - 执行一个外部程序
• passthru() - 执行外部程序并且显示原始输出
• popen() - 打开进程文件指针
• escapeshellcmd() - shell 元字符转义
• pcntl_exec() - 在当前进程空间执行指定程序
• 执行操作符