Alpine Linux 下运行 PHP 脚本需安装对应版本的 php83-cli 包（如 apk add php83-cli），因 php 命令由该包提供而非元包 php83；扩展需单独安装（如 php83-json）并自动启用；Shebang 应写为 #!/usr/bin/php，不可用 /usr/bin/env php。
Alpine Linux 下运行 PHP 脚本，核心前提是装对包、用对命令、避开 musl libc 和扩展兼容性坑。直接上结论：用 apk add php83-cli（或对应版本）安装 CLI 运行时，再用 php script.php 执行，别默认指望 php 命令存在——它得手动装。
为什么 php 命令在 Alpine 里经常报 “command not found”
Alpine 的 PHP 包是拆分的：php83 是元包，不自带可执行文件；php83-cli 才提供 php 二进制。只装 php83 或 php83-fpm，php 命令就不可用。
- 验证方式：
which php返回空，说明 CLI 未安装 - 正确安装命令（以 PHP 8.3 为例）：
apk add php83-cli - 如果同时需要 Web 服务，再加
apk add php83-fpm nginx，但 CLI 运行脚本不需要 FPM - 注意版本一致性：
php82-cli和php83-cli不能混用，php -v显示的版本必须与所装包名匹配
php script.php 报错 “Class not found” 或 “undefined function” 怎么办
Alpine 默认只装最精简的 PHP 核心，常见扩展如 mbstring、json、curl 都得手动启用。不是“没安装”，而是“没加载”。
- 先查已启用模块：
php -m | grep -E "(mbstring|json|curl)" - 若无输出，装对应扩展：
apk add php83-mbstring php83-json php83-curl - Alpine 不依赖
php.ini中的extension=行——扩展装完即自动启用（通过/etc/php83/conf.d/下的 .ini 文件） - GD、MySQLi 等需图像或数据库支持的扩展，要额外装底层库：
apk add libpng-dev libjpeg-turbo-dev mariadb-dev，再装php83-gd php83-mysqli
想直接 ./script.php 运行？Shebang 必须写对路径
Alpine 的 php 可执行文件路径是 /usr/bin/php（不是 /usr/local/bin/php），且必须用对应版本的 CLI 包提供该路径。
立即学习“PHP免费学习笔记（深入）”；
- 脚本第一行写：
#!/usr/bin/php（别写成#!/usr/bin/env php—— Alpine 的env查不到php，除非你手动改了 PATH） - 赋权：
chmod +x script.php - 运行：
./script.php—— 若报 “Permission denied”，检查是否用了 overlayfs 挂载或容器 rootless 模式，这类环境可能禁用 Shebang - 调试技巧：用
strace -e trace=execve ./script.php看系统实际尝试调用哪个解释器路径
最容易被忽略的是：Alpine 的 PHP 扩展名带版本号（php83-xxx），而官方 Docker 镜像如 php:8.3-cli-alpine 已预装好 CLI 和常用扩展，直接 php script.php 就能跑；但裸 Alpine 系统必须自己配全，漏一个扩展，json_encode() 都会报 fatal error。
