PHP执行外部程序时路径错误应通过四种方式解决：一、exec内联cd切换目录；二、先chdir再exec；三、proc_open显式指定cwd；四、封装runInDir函数自动回滚路径。
如果您在PHP中使用exec、shell_exec等函数执行外部程序，但发现命令因路径错误而无法定位文件或产生意外行为，则很可能是当前工作目录与预期不符。以下是解决此问题的步骤：
一、在exec命令中内联切换目录
该方法通过将cd命令与目标命令用&&连接，在同一shell上下文中完成目录切换与执行，确保命令运行时的工作目录已变更。此方式不依赖PHP进程级目录状态，适用于单次调用场景。
1、定义目标目录路径，例如/var/www/app/data；
2、使用escapeshellarg()对目录路径进行安全转义，防止命令注入；
立即学习“PHP免费学习笔记（深入）”；
3、构造完整命令字符串："cd " . escapeshellarg($targetDir) . " && your_command"；
4、调用exec()并传入该字符串，同时捕获输出与返回码；
5、检查返回码是否为0，确认目录切换与命令均成功执行。
二、先调用chdir()再执行外部程序
该方法修改PHP脚本自身的当前工作目录，后续所有基于相对路径的exec调用都将以此目录为基准。适用于需多次执行不同命令且共享同一工作目录的场景，但需注意其影响范围覆盖整个脚本生命周期。
1、调用getcwd()获取并保存原始工作目录路径；
2、使用chdir($targetDir)切换至目标目录；
3、验证切换结果：若返回false，说明目录不存在或权限不足；
4、执行exec("your_command")，此时命令中的相对路径（如./script.sh或input.txt）将基于新目录解析；
5、如需恢复原始路径，调用chdir($originalPath)。
三、使用proc_open并显式指定cwd选项
该方法通过proc_open的descriptor spec机制，在进程启动时直接设定子进程的工作目录，完全隔离于PHP主进程的当前目录状态，是最精确、最可控的方式，尤其适合需要精细控制I/O流和环境变量的复杂外部调用。
1、构建描述符数组，例如["pipe", "r"]用于stdin；
2、准备options数组，其中包含"cwd" => "/var/www/app/output"键值对；
3、调用proc_open($command, $descriptors, $pipes, null, null, $options)；
4、检查返回资源是否为有效resource，否则表示进程创建失败；
5、通过stream_get_contents($pipes[1])读取stdout，并用proc_close()回收进程。
四、封装runInDir函数统一管理目录上下文
该方法将目录切换、命令执行与自动恢复封装为可复用函数，利用try-finally结构确保无论执行是否成功，原始工作目录均被还原，避免路径污染扩散至后续逻辑，适用于中大型项目中高频调用外部程序的模块。
1、定义函数function runInDir(string $dir, callable $callback): mixed；
2、在函数开头调用$original = getcwd()保存起始路径；
3、执行if (!chdir($dir)) throw new RuntimeException("Cannot chdir to $dir")；
4、在try块中调用$callback()执行业务命令逻辑；
5、在finally块中强制执行chdir($original)，确保路径回滚。
