宝塔面板一键搭建PHP环境必须同步完成三件事：选对版本（如TP6用PHP8.0、禁用8.3）、勾全opcache/fileinfo/pdo_mysql/mbstring/openssl/curl/gd等7个关键扩展、手动绑定到具体站点并设对运行目录和伪静态，缺一即致500/502/白屏。
选对 PHP 版本，别被“最新版”带偏
PHP 版本不是越高越好。WordPress、Discuz、Typecho 等老项目在 PHP 8.2+ 下常报 Deprecated: Function get_magic_quotes_gpc() 或直接 Fatal error: Call to undefined function mysql_connect()；ThinkPHP 6.x 推荐 PHP 8.0，TP 8.x 要求 ≥8.1；Laravel 10/11 才真正需要 PHP 8.1 起步。生产环境禁用 PHP 8.3（宝塔中仍属测试版）。
操作上：进【软件商店】→ 搜索 PHP → 取消默认勾选的最新版 → 手动点击目标版本（如 PHP 7.4 / 8.0 / 8.1）进入安装页。多个站点需混用不同版本？务必提前开启【PHP 多版本共存】，否则切换全局版本会连带崩掉其他站。
装全 7 个关键扩展，少一个都可能挂
这些扩展不是可选项，是多数主流框架和 CMS 的硬性依赖：
- opcache：不启用，Laravel/ThinkPHP 首次加载慢一倍以上，还容易内存溢出
-
fileinfo：缺失会导致
Storage::put()上传失败、mime_content_type()函数不存在 - pdo_mysql、mbstring、openssl、curl：WordPress、TP6、Laravel 运行基础
- gd 或 imagick：后者需服务器先装 ImageMagick 库，否则安装时会静默跳过
注意：别全选“所有扩展”——snmp、pspell 等冷门扩展可能因系统缺依赖导致整个安装中断。升级 PHP 版本后，旧版本装过的扩展不会自动迁移，切版本前务必记下当前【已安装扩展】列表，新版本里得重新勾选安装。
立即学习“PHP免费学习笔记（深入）”；
绑定到站点，面板显示“运行中”≠真在用
装完 PHP 后，面板显示“运行中”，但你的网站很可能还在用旧版或纯静态模式。必须手动确认：
- 进【网站】→ 点你的站点 →【PHP 版本】下拉框，确认已设为刚装的那个版本（如 PHP 8.0）
- 检查【网站目录】里的【运行目录】：ThinkPHP/Laravel/Symfony 必须设为 /public，否则 403、白屏、路由全乱
- 伪静态规则必须匹配框架：TP6/8 选【thinkphp】模板，Laravel/Symfony 用
location / { try_files $uri $uri/ /index.php?$query_string; }
常见故障排查路径：
- 看
/www/wwwlogs/你的站点_error.log：出现 Primary script unknown 是根目录路径设错；Permission denied 是 www 用户没权限读 index.php - 终端执行
ps aux | grep php-fpm：若只看到 master 进程、没有对应版本的 worker，大概率是www.conf里listen.owner和宝塔用户不一致 - 检查 Nginx 是否已启动（绿色状态），且已重载配置（保存伪静态或网站设置后要勾选【重载Nginx配置】）
