宝塔面板安装PHP应优先选用软件商店的极速安装方式,按站点指定版本,确保PHP-FPM与Web服务器通过正确socket或端口通信,并依据项目需求选择兼容的PHP版本(如老项目用7.2–7.4,新项目可用8.0+)。

宝塔面板里装 PHP 不需要从源码编译,直接用内置软件商店一键安装即可,但装完不等于能用——常见问题基本都出在版本选择、服务状态、网站配置三处。
怎么选对 PHP 版本?
不是越新越好。PHP 8.0+ 对 Laravel 9+、WordPress 6.0+ 友好,但老项目(比如 Discuz X3.2、ThinkPHP 3.2)大概率只认 PHP 7.2–7.4。装错版本会直接报 Parse error: syntax error 或 Class not found。
- 先看项目
composer.json或phpinfo()要求的最低/推荐版本 - 宝塔软件商店里 PHP 安装项带「极速安装」和「编译安装」两种:选「极速安装」,1–2 分钟完成;「编译安装」仅在需要自定义扩展(如
redis、swoole)且极速版没提供时才用 - 装完别急着切版本:进「网站」→ 点击对应站点 →「PHP 版本」下拉框里切换,不是全局改,是按站指定
PHP 进程起不来?检查这三处
装完点「启动」没反应,或状态显示「已停止」,大概率是端口冲突、配置错误或扩展加载失败。
- 看日志:
/www/wwwlogs/php-fpm.log最顶上几行通常有明确报错,比如failed to load extension 'xxx'或Address already in use - 确认没和其他 PHP 服务抢 9000 端口:执行
netstat -tunlp | grep :9000,如果被php-fpm外的进程占了,要么杀掉它,要么进「PHP 设置」→「配置修改」→ 把listen = 127.0.0.1:9000改成listen = /tmp/php-cgi-74.sock(推荐) - 扩展启用后记得重启 PHP:光勾选「安装扩展」不生效,必须点「重载配置」或「重启」服务
网站打不开,但 PHP 显示运行中?查 Nginx/Apache 配置
PHP 服务跑着,不代表网站能解析 PHP 文件——Web 服务器得把请求正确转发给 PHP-FPM。
立即学习“PHP免费学习笔记(深入)”;
- 进「网站」→ 点击站点 →「配置文件」,确认里面有没有这段(Nginx 示例):
location ~ \.php(.*)$ {其中
fastcgi_pass unix:/tmp/php-cgi-74.sock;
fastcgi_index index.php;
include fastcgi.conf;
}php-cgi-74.sock必须和当前 PHP 版本一致(74=7.4,80=8.0) - Apache 用户注意:
libphp.so模块已淘汰,宝塔默认用proxy_fcgi模式,确保LoadModule proxy_fcgi_module modules/mod_proxy_fcgi.so已启用 - 上传的
index.php如果只显示源码,说明 Web 服务器根本没交给 PHP 解析,优先查上面那段 location 或SetHandler配置
真正卡住的地方往往不是“怎么装”,而是“装完谁调用谁”——PHP 是后台进程,Nginx/Apache 是前台门卫,两者靠 socket 或端口连通,中间断一环,页面就空白或下载源码。多看 php-fpm.log 和 Web 服务器的 error log,比反复重装快得多。











