PHP怎么执行Shell命令？exec与shell_exec区别说明

PHP 调用 Shell 命令的常见需求

在 PHP 项目中，部分功能无法仅靠语言本身完成，需要借助操作系统提供的命令能力。例如批量整理文件、调用系统工具完成格式转换、读取磁盘或网络状态、执行诊断脚本等场景，都可能要求 PHP 程序与 Shell 交互。PHP 提供了多个与外部命令相关的函数，其中 exec 与 shell_exec 使用频率较高。它们都能执行外部命令，但返回方式、参数设计和适用场景并不相同，理解这些差异有助于写出更稳定、更易维护的代码。

在选择函数之前，需要先明确当前任务真正需要什么样的结果。如果只需要命令输出的最后一行，或者需要判断命令是否成功结束，exec 往往更合适；如果需要一次性拿到完整输出文本，并且后续会按字符串处理，shell_exec 会更直接。把需求说清楚后，函数之间的差异就不再只是文档上的文字，而会变成具体的编码选择。

除了功能差异，实际运行环境也会直接影响命令能否执行成功。Web 服务通常以固定用户身份运行，这个用户可能没有访问某些目录或执行某些命令的权限；同时，生产环境为了安全也可能禁用部分外部命令函数。因此，讨论 exec 与 shell_exec 时，不能只关注语法，还要把安全、权限和可用性纳入考虑范围。

exec 的执行模型与典型用法

exec 的核心特点是：默认只返回命令输出的最后一行，并且可以通过引用参数接收更多执行信息。它的第一个参数是要执行的命令字符串，第二个参数用于接收按行拆分的输出，第三个参数用于接收命令退出状态码。正因为具备这些参数，exec 既能用于简单取值，也能用于需要判断执行结果的场景。

使用 exec 时，最容易产生误解的地方是返回值。如果只传入命令，它不会返回全部输出，而只会返回最后一行；如果命令失败，则可能返回 false。如果需要完整输出，就必须传入一个数组变量，让 PHP 把每一行输出写入该数组。若还需要判断命令是否成功，则继续传入一个整型变量，用来保存退出状态码。这样设计的好处是，开发者可以按行处理结果，也可以明确区分“执行成功但没有输出”和“执行失败”等情况。

下面的示例演示了两种常见用法：第一种只获取最后一行输出，第二种同时获取按行输出和返回状态码。示例中的命令用于列出目录内容，实际项目中可以替换为其他合法命令，但拼接用户输入时必须注意安全转义。

<?php
// 执行命令并获取最后一行输出
$command = 'ls -l /tmp';
$lastLine = exec($command);

if ($lastLine !== false) {
    echo "最后一行输出：" . $lastLine . PHP_EOL;
} else {
    echo "命令执行失败" . PHP_EOL;
}

// 同时接收按行输出和退出状态码
$output = [];
$returnCode = 0;
exec($command, $output, $returnCode);

echo "所有输出：" . PHP_EOL;
foreach ($output as $line) {
    echo $line . PHP_EOL;
}
echo "返回状态码：" . $returnCode . PHP_EOL;
?>

从示例可以看出，exec 的第二个参数和第三个参数都是以引用方式传递的，这意味着传入的变量会在函数执行后被修改。开发者在调用前应初始化好这些变量，避免依赖未定义状态。对于多行输出，使用数组遍历通常比手动拆分字符串更清晰，也更容易控制每一行的后续处理逻辑。

shell_exec 的执行模型与典型用法

shell_exec 的接口比 exec 更简单，它只接收一个命令字符串，并把命令执行后的全部输出作为字符串返回。这种设计适合那些希望直接拿到完整文本结果的场景，例如读取一段配置信息、获取某个工具的输出、拼接后续业务逻辑等。由于返回内容是一个连续字符串，开发者不需要关心数组下标，可以直接进行字符串查找、替换或输出。

不过，shell_exec 的返回值有三种情况需要区分：命令执行成功且产生输出时返回字符串；命令执行成功但没有输出时返回 null；命令执行失败时返回 false。在业务代码中，最好使用严格比较来判断这三种状态，避免把空字符串、null 和 false 混为一谈。若命令输出包含多行内容，shell_exec 不会自动拆分成数组，需要开发者自行按换行符处理。

与 exec 相比，shell_exec 无法直接获取命令退出状态码。如果业务逻辑必须判断命令是否成功，通常可以改用 exec，或者在命令层面追加能够反映执行结果的信息。对于大多数只需要完整输出的场景，shell_exec 仍然非常简洁，能够减少不必要的数组初始化和遍历代码。

下面的示例展示了如何安全地处理 shell_exec 的三种返回状态。示例中先判断是否执行失败，再判断是否没有输出，最后才输出完整内容，这样可以让日志和界面提示更加准确。

<?php
// 执行命令并获取完整输出
$command = 'ls -l /tmp';
$result = shell_exec($command);

if ($result === false) {
    echo "命令执行失败" . PHP_EOL;
} elseif ($result === null) {
    echo "命令执行成功，但没有产生输出" . PHP_EOL;
} else {
    echo "命令全部输出：" . PHP_EOL;
    echo $result;
}
?>

这个示例的关键在于使用严格比较。由于 shell_exec 可能返回 null，如果只用普通判断，容易把“没有输出”误认为“执行失败”。明确区分这些状态后，代码在异常场景下也能给出更可靠的反馈，便于后续排查问题。

exec 与 shell_exec 的关键差异和选择策略

两者最直观的区别是返回值不同。exec 默认返回最后一行输出，而 shell_exec 返回完整输出字符串。这个差异会直接影响代码结构：如果只需要最后一行，exec 更省事；如果需要全部文本，shell_exec 更直观。若用 exec 获取全部输出，则必须依赖第二个参数；若用 shell_exec 获取最后一行，则需要自己从字符串中截取，反而增加复杂度。

第二个关键差异是输出处理方式和状态码获取能力。exec 可以通过数组参数获得按行拆分后的结果，也可以通过第三个参数获得退出状态码，适合需要逐行处理或判断执行结果的场景。shell_exec 返回的是完整字符串，适合整体读取，但不能直接拿到状态码。若命令失败时没有输出，仅靠 shell_exec 的返回值可能不够，需要结合其他机制判断。

基于这些差异，可以形成比较明确的选择策略：当需要退出状态码、需要逐行处理输出、或者只需要最后一行结果时，优先使用 exec；当只需要完整输出文本，且不需要复杂的状态判断时，优先使用 shell_exec。下表从几个常见维度对两者进行了对比，方便在实际编码时快速判断。

在实际项目中，选择函数时还要考虑代码可读性。如果团队中多人维护同一段代码，过于依赖字符串拆分可能让后续维护者不容易理解输出格式；而使用 exec 的数组参数时，输出结构更明确。反过来，如果命令输出本身就是一段完整文本，使用 shell_exec 可以减少不必要的转换步骤。关键不是哪个函数更高级，而是哪个函数更贴合当前需求。

安全、权限与运行环境注意事项

执行 Shell 命令时，命令注入是最常见的安全问题。如果直接把用户输入拼接到命令字符串中，恶意用户可能通过特殊字符追加额外命令，导致程序执行非预期操作。因此，永远不要未经处理地把请求参数、表单数据或其他外部输入直接拼入命令。若必须使用外部输入，应先验证其格式，再使用 escapeshellarg 等函数进行转义，确保它只作为普通参数参与命令执行。

escapeshellarg 适合对单个参数进行转义，转义后的值会作为整体交给 Shell 解析，从而降低参数被拆成多个命令片段的风险。对于更复杂的命令，还需要明确哪些部分允许用户输入，哪些部分必须固定。能减少 Shell 元字符参与时，应尽量减少；能固定命令结构时，也应尽量固定。安全目标不是简单地把输入包一层函数，而是从命令设计源头降低风险。

除了命令注入，函数可用性和权限也是常见问题。部分服务器环境会通过 disable_functions 禁用 exec、shell_exec 等函数，使用前应先确认函数是否可用。即使函数可用，PHP 进程运行的用户也可能没有执行目标命令或访问目标目录的权限，导致命令失败。遇到这类问题时，需要检查运行用户、目录权限、命令路径以及系统安全策略，而不是只修改 PHP 代码。

下面的示例展示了如何对请求参数进行转义后再拼接命令。示例中的文件名来自 GET 参数，先进行空值检查，再使用 escapeshellarg 处理，最后才调用 shell_exec 执行命令。这种写法虽然比直接拼接多了几行代码，但能显著降低命令注入风险。

<?php
// 对来自请求参数的文件名进行转义后再拼接
$userInput = $_GET['filename'] ?? '';

if ($userInput === '') {
    echo "未提供文件名" . PHP_EOL;
    exit;
}

$safeInput = escapeshellarg($userInput);
$command = 'ls -l ' . $safeInput;
$result = shell_exec($command);

if ($result === false) {
    echo "命令执行失败" . PHP_EOL;
} else {
    echo $result;
}
?>

另一个示例用于检查 exec 是否被禁用。通过读取 disable_functions 配置，可以在运行前判断函数是否可用，避免在不可用环境中直接调用导致错误。实际项目中，这类检查可以封装成统一的工具方法，供多个业务模块复用。

<?php
// 检查 exec 是否被 disable_functions 禁用
$disabled = explode(',', ini_get('disable_functions'));
$disabled = array_map('trim', $disabled);

if (in_array('exec', $disabled, true)) {
    echo "exec 当前不可用" . PHP_EOL;
} else {
    echo "exec 当前可用" . PHP_EOL;
}
?>

总结与使用建议

回顾全文，exec 与 shell_exec 都是 PHP 调用 Shell 命令的重要函数，但设计重点不同。exec 更适合需要获取退出状态码、按行处理输出或只取最后一行结果的场景；shell_exec 更适合只需要完整输出字符串、追求调用简洁的场景。理解它们的返回值差异，是避免误用和写出稳定代码的基础。

在实际开发中，建议遵循三个原则：第一，先明确业务需要哪种输出形式和判断方式，再选择函数；第二，任何外部输入进入命令前都必须经过严格校验和必要转义；第三，部署前确认函数可用、权限足够，并对失败状态给出清晰处理。做到这些后，PHP 调用 Shell 命令才能既方便又安全。

PHPexecshell_execShell命令执行修改时间：2026-07-12 18:45:20