宝塔面板“网站→设置→php版本”仅支持整站切换，因其实质是全局配置fastcgi_pass指向单一php-fpm实例；如需按目录切换（如/api/用php 8.2、/admin/用php 7.4），须手动编辑nginx配置文件，在对应location块中显式指定fastcgi_pass及socket路径，并重载配置。
为什么网站设置里只能选“PHP版本”，不能按目录切？
宝塔面板的「网站 → 设置 → PHP版本」下拉菜单，本质是为整个站点配置 fastcgi_pass 指向某个 PHP-FPM 实例（如 /tmp/php-cgi-81.sock），它作用于该站点全部 .php 请求。没有“按子目录指定PHP版本”的图形界面选项——这不是功能缺失，而是 Nginx/Apache 的常规限制：PHP 解释器由后端进程（php-fpm）提供，前端 Web 服务器只负责把请求转发过去，不参与解释逻辑。
用 location 块手动绑定不同目录到不同 PHP-FPM 实例
想让 /api/ 走 PHP 8.2，而 /admin/ 走 PHP 7.4，必须直接编辑站点的 Nginx 配置文件，在 location 块中显式覆盖 fastcgi_pass。操作前确认：目标 PHP 版本已安装且 php-fpm 正在运行；各版本监听地址互不冲突（推荐用 socket，路径如 /tmp/php-cgi-74.sock、/tmp/php-cgi-82.sock）。
以 Nginx 为例，在站点配置中添加：
location ^~ /api/ {
fastcgi_pass unix:/tmp/php-cgi-82.sock;
include /www/server/php/82/etc/php-fpm.conf; # 注意：此处仅作示意，实际应 include fastcgi_params
}
location ^~ /admin/ {
fastcgi_pass unix:/tmp/php-cgi-74.sock;
}
-
^~前缀确保前缀匹配优先于正则，避免被通用location ~ \.php$拦截 - 不要复制粘贴整段
include行——宝塔默认已有include enable-php.conf，你只需覆盖fastcgi_pass - 改完必须点击面板右上角「重载配置」，否则 Nginx 不加载新规则
- 若用 TCP 端口（如
127.0.0.1:9001），需确认该端口未被其他服务占用
为什么改了 location 还是 502？常见卡点
502 错误几乎都指向后端不可达，和目录路由无关。重点检查三件事：
- 对应 PHP 版本的 php-fpm 是否真在运行：
ps aux | grep php-fpm-74应看到 master 进程，且配置路径指向/www/server/php/74/etc/php-fpm.conf - socket 文件是否存在且权限正确：
ls -l /tmp/php-cgi-74.sock输出中用户组应为www:www，否则 Nginx worker 进程无法连接 - 目录路径是否被伪静态规则绕过：比如 ThinkPHP 的
try_files $uri $uri/ /index.php?$query_string;会把所有请求兜底给/index.php，导致/api/xxx实际仍走主fastcgi_pass——此时需调整伪静态或把入口脚本移出通用匹配范围
CLI 场景下按目录调用不同 PHP 版本？不存在的
终端执行 php script.php 与网站目录完全无关，它只取决于 $PATH 和 /usr/bin/php 软链接指向。如果你在 /www/wwwroot/myapp/api/ 下运行命令，它不会自动切到 PHP 8.2。要精准控制，必须用绝对路径：/www/server/php/82/bin/php script.php。别名（alias php82='/www/server/php/82/bin/php'）可简化输入，但别动系统软链，否则宝塔后台任务（如定时备份、日志切割）可能失败。
真正容易被忽略的是 OPcache：即使 location 路由正确、php-fpm 启动正常，若旧版本的 OPcache 缓存了脚本字节码，你看到的仍是老行为。每次切换 PHP-FPM 实例后，进「PHP管理」→ 找对应版本 → 「设置」→ 「清除OPcache缓存」，比单纯重启服务更可靠。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
