frankenphp 1.2 报“命令找不到”通常是因php运行时环境变量未正确配置，导致系统无法定位php可执行文件或扩展路径，多见于自定义构建、alpine镜像或非标准安装路径场景。
FrankenPHP 1.2 报“命令找不到”，通常不是 FrankenPHP 本身缺失，而是它依赖的 PHP 运行时环境变量未正确配置，导致系统无法定位 php 可执行文件或扩展路径。这类问题多出现在自定义构建、Alpine 镜像、或非标准安装路径场景中。
确认 PHP 是否在系统 PATH 中
FrankenPHP 启动时（尤其在 worker 模式或调用 exec 类操作时）会尝试调用系统 php 命令。若报 command not found: php 或类似错误，先验证：
- 进入容器或终端，运行
which php或command -v php—— 若无输出，说明 PHP 二进制未加入 PATH； - 检查 PHP 实际安装位置，常见路径有：
/usr/bin/php、/usr/local/bin/php、/opt/php/bin/php； - 临时修复：运行
export PATH="/usr/local/bin:$PATH"（替换为你的实际路径），再试启动； - 永久修复：在 shell 配置文件（
/etc/profile、~/.bashrc）或 Dockerfile 的ENV PATH中追加路径。
检查 PHP 扩展与 ini 文件路径是否生效
FrankenPHP 内嵌 PHP SAPI，但部分功能（如 opcache、pdo_mysql）仍需加载对应扩展。若提示 Extension 'xxx' not loaded，说明 php.ini 未被读取或扩展路径错误：
- 运行
php --ini查看加载的配置文件路径，确认extension_dir指向正确的模块目录（如/usr/lib/php/extensions/no-debug-non-zts-20230831/）； - 检查
php -m | grep pdo是否列出关键扩展； - 若使用
--php-ini参数指定配置，确保该 ini 文件存在且语法合法（extension=opcache.so路径必须绝对且可读）； - Alpine 用户注意：musl libc 下扩展名常为
.so，但部分包可能装成.a或未启用动态链接，需重装带so的版本。
验证 FrankenPHP 构建时的 PHP 环境一致性
如果你用 frankenphp build 打包了应用，而运行时报命令找不到，大概率是构建机与运行机的 PHP 环境不一致：
- 构建时 FrankenPHP 会扫描当前
php -v和php --ini结果，并将扩展逻辑“快照”进二进制； - 若构建机有
php-curl，但运行机没装对应共享库（如libcurl.so.4），就会在运行时触发command not found或undefined symbol错误； - 解决方法：统一使用静态链接的 PHP（如官方 FrankenPHP Alpine 镜像自带的 PHP），或在运行机补全所有构建时用到的系统库；
- 快速验证：在运行机上运行
ldd $(which php) | grep "not found"，查缺失的动态库。
排查 .env 或启动脚本覆盖了 PATH
某些部署脚本或 .env 文件会意外重写 PATH，导致原始 PHP 路径丢失：
- 检查
.env文件是否含PATH=...行——FrankenPHP 不解析它，但你的启动脚本（如start.sh）可能用了set -a; source .env，从而污染环境； - 在入口脚本顶部加一行
echo "PATH=$PATH" > /tmp/start.log，确认启动时 PATH 是否被截断； - 避免在
.env中设置 PATH；如需定制，改用 Docker 的ENV PATH=...或 systemd 的Environment=PATH=...。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
