PHPCMS V9 服务器端全流程部署实操指南 从环境配置到上线验证

前置准备

部署前需提前准备以下资源：

• 服务器：CentOS7.6+/Ubuntu20.04+，配置1核2G及以上，开放80、443、8888端口
• SSH连接工具：推荐FinalShell，直接填入服务器公网IP、root账号密码即可连接
• PHPCMS官方稳定版源码：https://download.phpcms.cn/v9/phpcms_v9.6.3_UTF8.zip
• 运行环境要求：Nginx1.18+/Apache2.4、PHP5.6/PHP7.0（PHPCMS最高兼容PHP7.0，高版本会报错）、MySQL5.6+/MariaDB10.1+

第一步：服务器基础环境部署

为降低新手操作门槛，统一使用宝塔面板部署环境，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确认，等待3-5分钟安装完成，控制台会输出宝塔面板地址、账号、密码，复制保存后登录面板，在弹出的环境推荐窗口中选择Nginx1.20、PHP7.0、MySQL5.7、phpMyAdmin4.9，点击一键安装，等待10分钟左右环境部署完成。

第二步：站点与数据库创建

2.1 创建站点

宝塔面板左侧点击「网站」-「添加站点」，域名栏输入绑定的域名（未买域名可直接填服务器公网IP），根目录默认生成/www/wwwroot/你的域名，FTP选择不创建，PHP版本下拉选择PHP-70，点击提交完成站点创建。

2.2 创建数据库

宝塔面板左侧点击「数据库」-「添加数据库」，数据库名可自定义（比如phpcms），用户名默认和数据库名一致，密码点击「自动生成」后单独复制保存，编码选择utf8mb4，点击提交，记录下数据库名、用户名、密码三个信息，后续安装需要使用。

第三步：PHPCMS源码上传与权限配置

3.1 源码上传

推荐直接在服务器端执行命令下载源码，避免本地上传慢的问题：首先在宝塔站点列表点击对应站点的「根目录」进入文件管理器，复制顶部路径，回到SSH终端执行命令（路径替换为你自己的站点根目录）：

``` cd /www/wwwroot/你的域名 wget https://download.phpcms.cn/v9/phpcms_v9.6.3_UTF8.zip unzip phpcms_v9.6.3_UTF8.zip mv upload/ ./ rm -rf upload phpcms_v9.6.3_UTF8.zip ```

3.2 目录权限配置

权限配置错误会导致安装失败、上传资源失败等问题，直接在SSH终端执行以下命令（路径替换为自己的站点根目录）：

``` chmod -R 755 /www/wwwroot/你的域名 chown -R www:www /www/wwwroot/你的域名 chmod -R 777 caches configs uploadfile html avatar phpsso_server/caches phpsso_server/uploadfile ```

第四步：可视化安装向导配置

打开浏览器输入你的域名/服务器公网IP，自动跳转PHPCMS安装页面：

• 第一步：阅读许可协议，点击「同意」进入下一步
• 第二步：环境检测，确认所有检测项均为绿色对勾，如有红色报错项，检查PHP版本是否为7.0、目录权限是否配置正确，无误后点击「下一步」
• 第三步：配置数据库和管理员账号，所有信息确认无误再提交：
  • 数据库服务器填localhost，数据库名、用户名、密码填之前创建数据库时保存的信息，表前缀默认v9_无需修改，数据库编码选择utf8mb4
  • 管理员账号自定义，密码设置复杂度高一点，邮箱填自己的常用邮箱，PHPCSSO配置保持默认即可
• 点击「下一步」等待10秒左右即可完成安装

第五步：安装后验证与安全配置

5.1 功能验证

安装完成后，直接访问域名即可看到PHPCMS默认前台站点，后台访问地址为你的域名/admin.php，用刚才设置的管理员账号登录，确认可以正常进入后台、发布文章、上传图片即可。

5.2 必做安全配置

• 删除安装目录，避免被恶意重复安装，执行命令：rm -rf /www/wwwroot/你的域名/install
• 修改后台入口文件名：将根目录下的admin.php改为自定义名称（比如my_phpcms_admin.php），然后打开configs/config.php文件，找到$config['admin_url'] = 'admin.php';，将引号内的内容改为新的后台文件名，避免后台地址被暴力破解
• 关闭PHP错误显示：在宝塔面板左侧点击「软件商店」-「已安装」- 找到PHP7.0点击「设置」-「配置修改」，找到display_errors = On改为Off，保存后重启PHP，避免路径信息泄露

常见报错排查

• 安装页面空白：检查PHP版本是否高于7.0，在宝塔站点设置中切换PHP版本为7.0即可解决
• 上传图片/附件失败：检查uploadfile目录权限是否为777，同时在PHP7.0设置的「扩展」页面安装fileinfo扩展，重启PHP即可
• 后台登录验证码错误：在PHP7.0扩展页面安装gd扩展，重启PHP即可
• 静态页面生成失败/伪静态不生效：在宝塔站点设置的「伪静态」页面粘贴以下规则，保存即可： ``` rewrite ^/content-([0-9]+)-([0-9]+)-([0-9]+).html /index.php?m=content&c=index&a=show&catid=$1&id=$2&page=$3 last; rewrite ^/show-([0-9]+)-([0-9]+)-([0-9]+).html /index.php?m=content&c=index&a=show&catid=$1&id=$2&page=$3 last; rewrite ^/list-([0-9]+)-([0-9]+).html /index.php?m=content&c=index&a=lists&catid=$1&page=$2 last; rewrite ^/tag-(.).html /index.php?m=content&c=tag&a=init&tag=$1 last; ```