PHP源码怎么用宝塔部署？新手必看超详细教程

我们把PHP源码用宝塔部署的全流程，拆解成「环境检查-数据库创建-源码上传-配置调整-故障排查」5大步，每一步都配了清晰的操作说明——比如创建数据库要选utf8mb4字符集，上传源码后要改网站根目录，权限得给www用户……连新手常踩的「502错误」「路径不对」「权限不足」这些坑，都帮你标了红并附解决办法。

不管你是第一次用宝塔，还是之前部署失败过，跟着这篇超详细教程走，10分钟就能把PHP源码成功跑起来，再也不用到处查零散攻略啦！

你有没有过这种情况？拿着PHP源码兴冲冲打开宝塔面板，结果点了半天不知道从哪下手，传完源码要么显示“PHP版本不兼容”，要么数据库连不上，最后对着“502错误”发呆？我去年帮我弟部署他的PHP博客时，就把这些坑全踩了一遍——从环境没搭对到数据库字符集错了，从源码解压路径不对到部署完打不开，折腾了3小时才搞定。今天我把踩过的坑揉成这套“笨办法”，没学过技术也能跟着做，亲测10个新手里9个能一次成。

第一步：先把宝塔环境搭对，别上来就传源码

我发现很多新手的第一个错，就是跳过“环境检查”直接传源码——就像你要煮面，得先确认锅里有水、火开了，不然面扔进去也是生的。宝塔的“环境”核心就两个：PHP版本和web服务器（Nginx/Apache），这俩得跟你的PHP源码匹配，不然肯定出问题。

先讲PHP版本怎么查。比如你拿的是WordPress源码，官方说支持PHP7.4-8.2；要是Discuz! X3.5，得用7.2-8.1；我弟那回用的是老版PHPCMS，只支持PHP7.3。怎么看宝塔里的PHP版本？打开宝塔面板，左边点「软件商店」，找到「PHP」模块，你会看到“已安装”的版本——比如默认可能是8.1，但你源码要7.4，这时候就得切换版本：点PHP模块右边的「切换版本」，选7.4，等个1-2分钟安装完成就行。

这里插个我整理的常见PHP源码与版本兼容表，你对着查不用瞎猜：

除了PHP版本，还要确认web服务器是不是开着——宝塔里默认装的是Nginx，一般不用改，但要是你源码需要Apache（比如某些老论坛），可以在「软件商店」里装Apache，然后在「网站」设置里切换。我之前帮一个做本地论坛的朋友改过，他的源码只能用Apache，切换后立马就能访问了。

第二步：数据库+源码上传，踩过的坑我帮你避了

环境搭对了，接下来是数据库创建和源码上传——这俩是“连体婴儿”，少一个都不行。我弟之前就漏了数据库，传完源码直接访问，结果显示“无法连接数据库”，急得直找我。

先讲数据库怎么建。记住：数据库名、用户名、密码一定要复制保存好，等下改配置文件要用到。步骤超简单：

填完点「提交」，数据库就建好了。接下来传源码，我推荐用压缩包上传——比FTP快10倍！比如你把PHP源码压缩成zip文件（别用rar，宝塔解压可能出问题），然后：

传完源码，还要改配置文件——大部分PHP源码都有个“config”开头的文件，比如WordPress是「wp-config.php」，Typecho是「config.inc.php」。以WordPress为例：

define( ‘DB_NAME’, ‘数据库名’ );

define( ‘DB_USER’, ‘用户名’ );

define( ‘DB_PASSWORD’, ‘密码’ );

第三步：部署完打不开？这3个常见问题我替你排过雷

我帮人部署过10多次，最常遇到的就是“部署完打不开”——别慌，90%的问题都是这3个，我替你排过雷：

这个错我遇到过3次，原因很简单：切换PHP版本后没重启PHP-FPM（就是PHP的“服务员”，负责处理请求）。解决办法：

我弟第一次部署就遇到这问题，后来发现是「网站目录」设错了。检查方法：

有些源码需要开启特定的PHP扩展，比如Discuz!需要fileinfo，WordPress需要gd（处理图片）。怎么开？

其实部署PHP源码真没那么难，我 下来就一句话：先搭对环境，再建数据库传源码，最后排故障。我帮过的新手里，最快的10分钟就部署好了，最慢的也就半小时——关键是别跳过步骤，别乱点按钮。

如果你按我讲的步骤试了，不管成功还是遇到新问题，都可以在评论区告诉我——我帮你看看，毕竟这些坑我都踩过，比你自己瞎琢磨省时间。对了，要是部署成功了，记得回来报个喜，我替你开心～

PHP源码和宝塔的PHP版本不匹配怎么办？

先查你的PHP源码要求的版本，比如WordPress官方支持7.4-8.2，Discuz! X3.5要7.2-8.1，老版PHPCMS只兼容7.3。然后打开宝塔面板，左边点「软件商店」找到「PHP」模块，看已安装的版本——如果不匹配，点模块右边的「切换版本」，选源码需要的版本安装就行，等1-2分钟切换完成，环境就对上了。

创建数据库时字符集选什么？为什么？

一定要选「utf8mb4」，排序规则选「utf8mb4_general_ci」。我之前踩过坑：选utf8的话，博客里的emoji会变成问号，后来才知道utf8mb4能存emoji，而utf8不行。现在每次建数据库我都直接选这个，再也没出现过字符乱码的问题。

PHP源码解压后有一层文件夹，访问时显示404怎么办？

很多源码解压后会包一层文件夹（比如WordPress解压后有个「wordpress」文件夹），这时候得把文件夹里的所有文件全选，拖到网站根目录（比如「/www/wwwroot/你的域名」）。我弟第一次没这么做，结果打开网站显示「找不到页面」，我远程帮他把文件移到根目录后，立马就能访问了。

部署完显示「502 Bad Gateway」是什么原因？怎么解决？

大多是切换PHP版本后没重启PHP-FPM（负责处理PHP请求的“服务员”）。解决方法超简单：宝塔左边点「服务」，找到「PHP-FPM」点「重启」，等30秒再刷新网站——我自己遇到过3次这个问题，重启后都搞定了。

部署后显示「PHP扩展未开启」怎么处理？

不同源码需要的扩展不一样，比如Discuz!要fileinfo（上传图片用），WordPress要gd（处理图片缩略图）。打开宝塔「软件商店」，找到已安装的PHP版本（比如7.4），点「设置」→「安装扩展」，找到需要的扩展点「安装」，等几分钟重启PHP-FPM就行。我之前帮朋友开了fileinfo，他的论坛终于能正常上传图片了。

YUANLEISVIP

收藏 链接