不能直接用 php-shell-exec 安装，因其并非 Packagist 官方收录的稳定包，实际应使用广泛维护的 symfony/process；它支持超时控制、环境隔离、数组传参防注入，并默认禁用 shell 解析以保障安全。
为什么不能直接用 php-shell-exec 这个包名安装
你在 Packagist 上搜 php-shell-exec，会发现没有这个官方库——它不是 Composer 官方收录的稳定包，也不是主流维护项目。实际能用的、有基本安全防护的同类库是 symfony/process，它被 Laravel、Drupal 等广泛依赖，且持续更新。直接搜错名字会导致 composer require php-shell-exec 报 Package not found 错误，浪费时间还引入未知来源的 fork。
用 symfony/process 替代：基础执行与输出捕获
它不叫“shell exec”，但功能更可靠：支持命令超时、环境隔离、输入/输出流控制，且默认禁用 shell 解析（避免注入）。安装后，最简用法如下：
use Symfony\Component\Process\Process;
$process = new Process(['ls', '-la', '/tmp']);
$process->run();
if ($process->isSuccessful()) {
echo $process->getOutput(); // 标准输出
} else {
echo $process->getErrorOutput(); // 错误输出
}
- 必须传数组形式的命令参数（
['ls', '-la', '/tmp']），不能拼接字符串，否则绕过安全机制 -
$process->run()是同步阻塞调用；如需非阻塞，改用start()+wait() - 默认不启用 shell（即不经过
/bin/sh -c），所以管道|、重定向>无法直接使用
需要管道或重定向时，如何安全启用 shell 模式
如果你非得用 grep 或 awk 链式处理，必须显式启用 shell，但要严格过滤输入：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
$cmd = sprintf('ls -la /tmp | grep "%s"', escapeshellarg($userInput));
$process = Process::fromShellCommandline($cmd);
$process->run();
-
escapeshellarg()是关键，它对每个变量做转义，比escapeshellcmd()更适合单个参数 - 禁止把用户输入拼进命令前半部分（比如
ls -la ' . $userInput），否则../etc/passwd可能逃逸 - 启用 shell 后，
timeout和idle_timeout更重要，防止恶意命令长期占用资源
常见踩坑：权限、路径和 Windows 兼容性
本地开发能跑，上线就失败，大概率是这几个点没对齐：
立即学习“PHP免费学习笔记（深入）”；
- Web 服务器用户（如
www-data）可能没权限执行目标命令，用$process->mustRun()能快速暴露权限错误 -
PATH环境变量在 CLI 和 Web 环境中不同，建议用绝对路径：['/usr/bin/git', '--version'] - Windows 下
symfony/process默认用cmd.exe，但escapeshellarg()行为和 Linux 不同；跨平台命令尽量避免依赖 shell 特性 - 不要在循环里反复 new Process，复用对象或设好
timeout防止进程堆积
真正难的不是调用函数，而是界定清楚：哪些输入可控、哪些命令允许、超时设几秒、失败后怎么降级。这些不在代码里，而在你的业务逻辑边界上。
