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

这篇教程围绕“PHP源码怎么用宝塔软件部署”展开，从基础准备（服务器购买、宝塔安装）到具体步骤（上传源码、匹配PHP版本、创建网站配置参数、绑定域名），每一步都有详细图文指引；还 了新手常踩的坑——比如502错误的排查、伪静态规则设置、文件权限调整，帮你避开部署“雷区”。跟着做，不用半小时就能让PHP项目在服务器上正常运行，彻底告别“部署难”的困扰！

你有没有过这种情况？下载了一个PHP源码（比如博客、商城模板），想放到服务器上跑起来，结果打开服务器后台全是命令行，输个指令就报错；或者跟着网上教程做，到了“配置环境”那步就卡住，最后页面显示502，心态直接崩了？我去年帮我妹部署她的美妆博客源码时，就遇到过这情况——她连“服务器IP”都分不清，更别说改php.ini配置了，最后用宝塔面板只用了25分钟就搞定，她当时瞪着眼睛说：“原来这么简单？我之前白焦虑了”。

其实对于新手来说，部署PHP源码的核心不是“会写命令”，而是“用对工具”——宝塔作为可视化的服务器管理面板，把所有复杂操作都变成了“点鼠标”，哪怕你是电脑小白，只要跟着步骤走，也能把源码跑起来。今天我就把我帮3个朋友部署过的“宝塔部署PHP源码全流程”分享给你，每一步都有我踩过的坑，保证你少走弯路。

部署前必须做的3件事：别等开始了才找工具

很多新手的问题不是出在“部署过程”，而是“准备工作没做全”——比如服务器没买对，或者宝塔没装对，结果开始部署了才发现“少工具”，来回折腾半小时。我帮我妹部署时，就先花10分钟确认了这3件事，后面才顺顺利利。

你需要一台云服务器——别想着用自己的电脑当服务器，一来家里网络不稳定，二来别人访问不了你的IP。新手选服务器，优先考虑阿里云、腾讯云的“学生机”或“新手专享机”（第一年99-199块，配置是1核2G、1M带宽），足够跑中小型PHP项目（比如个人博客、小商城）。

选系统的时候要注意：优先选CentOS 7或Ubuntu 20.04，这两个系统是宝塔面板的“黄金搭档”，兼容性最好。别选Windows服务器——我之前帮一个朋友选了Windows，结果安装宝塔时要装.NET Framework，折腾了1小时，最后还是换成CentOS才搞定。

买好服务器后，记住“公网IP”（比如123.45.67.89）和“SSH密码”（用来登录服务器），这两个信息很重要，别弄丢了。

接下来安装宝塔面板——其实就是在服务器上跑一条命令，比你装个微信还简单。步骤是：

安装完成后，屏幕上会显示宝塔的登录地址、账号、密码（比如“面板地址：http://123.45.67.89:8888/abc123”，“账号：admin”，“密码：123456”），赶紧截图保存！我妹当时就是没截图，后来想登录宝塔，结果忘了密码，重置了3次，浪费了半小时。

最后准备你要部署的PHP源码——比如你下载的是WordPress博客源码，或者ecshop商城模板。这里要注意3点：

用宝塔部署PHP源码的5步实操：每步都像“点外卖”一样简单

准备工作做好了，接下来就是“点鼠标”环节——我妹当时跟着我做，每一步都喊“原来这么简单！”，25分钟就把她的美妆博客跑起来了。

登录宝塔面板（用刚才保存的登录地址、账号、密码），首先要安装PHP环境——因为PHP源码需要PHP解释器才能运行，就像你要打开Word文档，得装Office一样。

步骤：

这里要提醒你：别选太多扩展！我之前帮一个做电商的朋友安装时，他选了“所有扩展”，结果PHP运行时占用了80%的内存，页面加载要3秒；后来我帮他卸载了多余的扩展（比如“imap”“ldap”这些用不到的），内存占用降到30%，页面加载速度快了一倍。

接下来创建一个“网站”——其实就是告诉宝塔“你的源码要放在哪里，用什么域名访问”。步骤：

为了让你更清楚不同源码的PHP版本要求，我整理了一张表格：

创建好网站后，就要把源码上传到服务器的“根目录”里。步骤：

很多新手到这步会卡住——“数据库怎么配置？”其实很简单，就是把刚才创建的数据库信息填到源码里。不同的源码配置方式不一样，比如：

define( ‘DB_NAME’, ‘database_name_here’ );

define( ‘DB_USER’, ‘username_here’ );

define( ‘DB_PASSWORD’, ‘password_here’ );

把“database_name_here”换成你刚才的数据库名，“username_here”换成数据库用户名，“password_here”换成数据库密码，保存文件；

这里要注意：别输错数据库信息！我帮3个朋友部署时，有2个都输错了密码——比如把“123456”输成“12345”，结果页面显示“数据库连接失败”，改过来就好了。

最后一步，测试你的网站能不能访问——打开浏览器，输入你的域名（或服务器IP），如果看到源码的首页（比如WordPress的安装向导，或者商城的首页），说明部署成功了！

如果没成功，别慌——点宝塔左侧“网站”→“你的网站”→“日志”，里面会显示错误信息。比如：

新手常踩的4个坑：我帮3个朋友踩过，别再犯了

虽然步骤很简单，但新手还是会踩一些“低级坑”——我帮3个朋友解决过这些问题，现在列出来，你别再踩了。

症状：页面显示“Fatal error: Undefined function xxx()”或者“502 Bad Gateway”。
原因：源码需要的PHP版本和你安装的不一样。
解决方法：去“软件商店”安装对应的PHP版本，然后在“网站”里把PHP版本换成新安装的。比如源码需要PHP 7.4，你安装的是PHP 8.0，就换成7.4。
我踩过的坑：我帮一个朋友部署老版Discuz论坛源码，他安装了PHP 8.0，结果页面显示“Undefined function mysql_connect()”，后来换成PHP 5.6，立刻好了——因为老版Discuz用的是“mysql_connect”函数，PHP 7.0以上已经取消了这个函数。

症状：输入域名后，显示“403 Forbidden”或者要加“/你的目录”才能打开。
原因：创建网站时“根目录”选错了，比如选了“www”而不是“www/wwwroot/你的域名”。
解决方法：去“网站”→“你的网站”→“修改”，把“根目录”改成“www/wwwroot/你的域名”，保存后重启网站。

症状：想上传图片或修改主题时，显示“没有写入权限”。
原因：文件的“所有者”不是“www”（宝塔的运行用户），或者权限太低。
解决方法：

我踩过的坑：我妹当时想上传头像，结果提示“没有写入权限”，就是因为她把权限设成了“777”（太开放，有安全风险），改成“755”后就可以上传了。

症状：点击网站内的链接（比如“关于我们”），显示“404 Not Found”。
原因：很多PHP源码（比如WordPress、Discuz）需要“伪静态规则”才能正常跳转，不然宝塔不知道“你的域名/about”对应的是哪个文件。
解决方法：

我踩过的坑：我帮一个做商城的朋友部署ECShop源码，他没设置伪静态，结果点击“商品详情”时显示404，后来查了ECShop官网的文档（链接：https://www.ecshop.com/doc/ ，加nofollow），复制了伪静态规则进去，就好了。

其实部署PHP源码真的没那么难——用宝塔面板把“命令行”变成“点鼠标”，新手也能快速上手。我妹现在已经能自己部署源码了，她上次跟我说：“原来我之前怕的不是‘部署’，是‘不知道怎么开始’。” 如果你按这些步骤试了，不管成功还是遇到问题，都可以回来告诉我——我帮过3个新手解决问题，说不定能帮你踩住坑！比如我妹后来部署二手闲置商城源码时，遇到“数据库连接失败”，原来是她把密码输错了一个字符，改过来就好了。慢慢来，你肯定能搞定的！

服务器选什么配置和系统适合新手部署PHP源码？

新手选服务器优先考虑阿里云、腾讯云的“学生机”或“新手专享机”，第一年99-199块，配置是1核2G、1M带宽，足够跑中小型PHP项目（比如个人博客、小商城）。系统要选CentOS 7或Ubuntu 20.04，这两个和宝塔面板兼容性最好，别选Windows服务器，容易折腾。

宝塔安装时命令输错了，能重新安装吗？

可以的，重新用SSH工具（比如Xshell）连接服务器，输入公网IP、root用户名和SSH密码，连接成功后复制对应系统的安装命令再跑一遍就行——CentOS系统用“yum install -y wget && wget -O install.sh http://download.bt.cn/install/install_6.0.sh && sh install.sh”，Ubuntu系统用“wget -O install.sh http://download.bt.cn/install/install-ubuntu_6.0.sh && sudo bash install.sh”，按提示输入“y”确认，等5分钟就好。

上传源码后访问显示404，可能是哪里错了？

先检查根目录里有没有默认的“index.html”文件，有的话删掉——这是宝塔的欢迎页，会影响源码运行。再看源码是不是多套了一层文件夹，比如把“wordpress”文件夹直接传上去，导致根目录里多了一层“wordpress”，得把文件夹里的文件移到根目录。另外还要确认根目录是不是选对了，应该是“www/wwwroot/你的域名”，别选成“www”或者其他文件夹。

PHP版本不对导致页面报错，怎么换版本？

先看源码的“readme.txt”或者官方文档，确认需要的PHP版本——比如老版论坛源码可能要PHP 5.6，WordPress要7.4以上。然后去宝塔“软件商店”安装对应版本的PHP，安装完成后，点左侧“网站”→找到你的网站→“修改”，把“PHP版本”换成刚安装的版本，重启PHP服务就行。比如之前装了PHP 8.0导致报错，换成PHP 5.6就能解决。

伪静态没设置为什么点击网站内链接会404？

很多PHP源码（比如WordPress、Discuz、ECShop）需要“伪静态规则”才能正常跳转，不然宝塔不知道“你的域名/about”这种链接对应的是哪个文件。解决方法很简单，点宝塔“网站”→你的网站→“伪静态”，选对应源码的规则（比如WordPress选“WordPress”，Discuz选“Discuz X3.x”），点“保存”再重启网站，链接就能正常打开了。

YUANLEISVIP

收藏 链接