宝塔面板一键搭建PHP环境需同步完成三件事：选对版本（生产环境禁用8.3，老项目优选7.4/8.0）、勾全7个关键扩展（opcache、fileinfo、pdo_mysql、mbstring、openssl、curl、gd/imagick）、手动绑定到具体站点，缺一即致500/502/白屏。
宝塔面板一键搭建 PHP 运行环境，核心不是“点安装就完事”，而是必须同步完成三件事：选对 PHP 版本、勾全关键扩展、绑定到具体站点。漏掉任意一项，500、502 或白屏是大概率结果。
PHP 版本选错直接导致网站无法启动
PHP 8.3 在宝塔中仍属测试版，生产环境不要碰；WordPress、Typecho、Discuz 等老项目在 PHP 8.2+ 下常报 Deprecated: Function get_magic_quotes_gpc() 或直接 Fatal error: Uncaught Error: Call to undefined function mysql_connect()。Laravel 10/11、ThinkPHP 6.3+ 才真正需要 PHP 8.1 起步。
- 进宝塔「软件商店」→ 搜索 PHP → 手动取消默认勾选的最新版，单击进入目标版本（如
PHP 7.4或PHP 8.0）安装页 - 多个站点需混用不同 PHP 版本？必须提前开启「PHP 多版本共存」，否则切换全局版本会连带崩掉其他站
- 装完后别只看面板显示「运行中」——进【网站】→ 点你的站点 →【PHP 版本】下拉框，确认已手动设为刚装的那个版本
扩展没装全，Composer 和框架功能直接失效
opcache 不开，Laravel/ThinkPHP 首次加载慢一倍以上且易内存溢出；fileinfo 缺失，Storage::put() 上传失败，mime_content_type() 函数不存在；pdo_mysql + mbstring + openssl + curl 是 WordPress、TP6、Laravel 的硬性依赖。
- 安装 PHP 时弹窗里的扩展列表，只勾这 7 个：
opcache、fileinfo、pdo_mysql、mbstring、openssl、curl、gd（或imagick，后者需服务器先装ImageMagick库） - 别全选“所有扩展”——
snmp、pspell这类冷门扩展可能因系统缺依赖中断整个安装流程 - 升级 PHP 版本后，旧版本装过的扩展不会自动迁移——切版本前，记下当前「已安装扩展」列表，新版本里得重新勾选安装
网站打不开？先查这三处日志和进程
宝塔界面显示 PHP「运行中」≠ 你的站点真在用它。很多故障卡在连接链路中间，而非 PHP 本身。
立即学习“PHP免费学习笔记（深入）”；
- 看
/www/wwwlogs/你的站点_error.log：出现Primary script unknown是根目录路径设错；Permission denied是www用户没权限读index.php - 终端执行
ps aux | grep php-fpm：若只看到master进程、没有对应版本的worker，大概率是www.conf里listen.owner和宝塔用户不一致 - 检查伪静态是否启用：ThinkPHP/Laravel 必须配置对应规则，否则路由 404；没设运行目录（如 TP6 要设为
/public）也会导致入口文件找不到
最常被忽略的点：MySQL 安装后默认 root 密码为空，但宝塔不会强制你改——不改就等于把数据库裸奔在公网，这是高危漏洞。进 phpMyAdmin 修改密码这事，不能拖到上线前才做。
