大网数据广告活动
PHP 语言与运行手册

system · 执行外部程序,并且显示输出

· 52CE 我爱测

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

system

(PHP 4, PHP 5, PHP 7, PHP 8)

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

说明

function system(string $command, int &$result_code = null): string|false

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

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

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

参数

command

要执行的命令。

result_code

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

返回值

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

示例

示例 #1 system() 示例

<?php
echo '<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;
?>

注释

警告

当传入用户提供的数据到本函数时,应使用 escapeshellarg() 或 escapeshellcmd() 来防止用户欺骗系统执行任意命令。

注意:

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

参见

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。