ShopXO 在宝塔面板中的详细部署教程

本文详细介绍如何在一台已安装宝塔面板的 Linux 服务器上，完整部署 ShopXO 开源商城系统。ShopXO 是一款基于 ThinkPHP6 开发的高性能电商系统，支持多语言、多货币及丰富的插件生态。

一、环境准备

在宝塔面板中首先确保已安装以下软件：

软件	推荐版本	说明
Nginx	1.20+	作为 Web 服务器
PHP	7.3 ~ 8.1	建议 7.4 或 8.0
MySQL	5.6 / 5.7 / 8.0	建议 5.7
Redis	可选但推荐	用于缓存加速

所需 PHP 扩展（在宝塔面板的 PHP 管理中勾选安装）：

fileinfo
openssl
curl
mbstring
gd2
pdo_mysql
redis（可选）
zip
bcmath
opcache

同时需要移除以下禁用函数：

putenv
proc_open
proc_get_status
symlink
shell_exec
exec
（在宝塔 PHP 设置 → 禁用函数中删除这些条目）

二、下载 ShopXO 源码

进入宝塔面板的 /www/wwwroot/ 目录（或您自定义的站点根目录）。

通过远程下载或上传官方源码包。推荐使用 Git 克隆：

cd /www/wwwroot
wget https://github.com/gongfuxiang/shopxo/archive/refs/heads/master.zip
unzip master.zip
mv shopxo-master shopxo  # 重命名为站点目录名

若使用宝塔的文件管理器，直接上传 zip 解压即可。

三、创建站点与数据库

3.1 添加站点

宝塔面板 → 网站 → 添加站点。
域名：填写您绑定的域名（如 shop.yourdomain.com）或服务器 IP。
根目录：选择刚刚解压的 shopxo 文件夹（例如 /www/wwwroot/shopxo/public）。
创建 MySQL 数据库：勾选“创建数据库”，输入数据库名、用户名和密码，并记录备用。
PHP 版本：选择 7.3 以上（推荐 7.4）。
点击“提交”完成站点创建。

3.2 配置 Nginx 伪静态

在站点设置中选择“伪静态” → 选择“ThinkPHP”规则（或手动输入以下内容）：

location / {
    index index.html index.htm index.php;
    if (!-e $request_filename) {
        rewrite ^(.*)$ /index.php?s=/$1 last;
        break;
    }
}

保存后重载 Nginx 使配置生效。

四、修改权限与运行目录

将站点根目录（/www/wwwroot/shopxo）下的 runtime 文件夹权限设为 755（可写）：
```
chmod -R 755 /www/wwwroot/shopxo/runtime
chown -R www:www /www/wwwroot/shopxo/runtime
```
确保整个项目文件所有者是 www（宝塔默认运行用户），避免权限错误。