LikeShop 本地部署教程（PHPStudy 版）

想在本地把 LikeShop 跑起来，结果卡在环境配置上折腾了一下午？这篇把每个步骤和踩坑点基本写了。

一、为什么要用 PHPStudy 部署 LikeShop？

如果你正在做 LikeShop 的二次开发，宝塔适合服务器上线，Docker 适合快速体验，但日常改代码调试最顺手的还得是 PHPStudy——改完即时生效，不用反复打包部署。

不过 LikeShop 对运行环境有明确要求，PHP 版本选错会直接导致安装失败或运行时报错。先看一张版本对照表：

产品线	PHP 版本	MySQL 版本
单商户 / 多商户 / 外卖 / 回收租赁	7.2～7.4（推荐 7.2）	5.7
单商户高级版 / SaaS 版	8.0	5.7

这篇文章以多商户版为例，PHP 用 7.2，MySQL 用 5.7。

注意：单商户高级版要求 PHP 8.0，和多商户版完全不同。版本装错是部署失败最常见的原因之一，务必先确认你下载的是哪个版本。

二、环境安装

2.1 安装 PHPStudy

去官网（www.xp.cn/download.ht… PHPStudy，选择安装路径后点击「立即安装」即可。

2.2 安装 PHP 7.2 + Nginx + MySQL 5.7

安装好 PHPStudy 后，打开主界面，进入「软件管理」：

1. 找到 PHP 7.2，点击安装（如果列表里没有，切换到「全部版本」标签页查找）
2. 找到 Nginx，点击安装
3. 找到 MySQL 5.7，点击安装

安装完成后，回到首页，分别启动 Nginx 和 MySQL。

踩坑提醒：PHPStudy 首次使用 MySQL 时，需要先修改 root 密码才能创建数据库。在「数据库」面板中设置好密码，后面安装程序时会用到。

三、源码部署

3.1 下载源码

从 Gitee 下载 LikeShop 源码包（单商户开源版）：

# 企业免费版仓库地址
https://gitee.com/likeshop_gitee/likeshop

如果你购买的是付费版本，在 LikeShop 技术社区下载即可。

3.2 部署源码到 WWW 目录

把下载的源码包复制到 PHPStudy 安装目录下的 WWW 文件夹中解压。

这里有一个容易忽略的细节：LikeShop 是前后端分离架构，你只需要把 server 文件夹部署到 Web 服务器，其他文件夹（admin、uniapp、pc）是前端源码，本地开发时不需要放到 Web 根目录。

重点来了：很多人解压后重新打包时会遗漏隐藏文件（比如 .env、.example 等），导致安装程序无法正常运行。解压的时候直接用原始压缩包解压到 WWW 目录，不要重新打包。

四、创建站点与伪静态

4.1 创建网站

在 PHPStudy 中点击「网站」→「创建网站」，填写以下信息：

配置项	填写内容
域名	自定义，比如 likeshop.test
根目录	选择 WWW/你的源码目录/server/public
PHP 版本	选择 7.2
同步 Host	勾选

4.2 配置伪静态

点击「伪静态」，填入以下规则后点击确定：

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

如果你用的是 Apache，可以跳过伪静态配置这一步。

4.3 访问安装界面

在网站列表中点击「管理」→「打开网站」，就能看到 LikeShop 的安装引导界面了。

五、安装程序

进入安装界面后，按引导一步步操作：

Step 1：点击「我已阅读并同意」，进入环境检测页面

Step 2：确认环境检测全部通过。如果有扩展未安装的提示，回到 PHPStudy 的「软件管理」→ 找到 PHP 7.2 →「设置」→「安装扩展」，安装对应的扩展即可

Step 3：填写数据库信息和超级管理员账号密码

PHPStudy 默认的 MySQL 账号密码是 root / root，如果你之前改过密码，填修改后的密码就行。

Step 4：点击「继续」，等待安装完成。

安装报错怎么办？ 如果提示 请在 mysql 配置文件修改 sql-mode 添加 NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION，在 PHPStudy 的 MySQL 配置中修改 sql-mode，然后重启 MySQL：

sql-mode=NO_ENGINE_SUBSTITUTION,STRICT_TRANS_TABLES,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION

六、登录入口一览

安装成功后，各端入口如下：

入口	地址
PC 平台管理后台	http://域名/admin
PC 商家管理后台	http://域名/shop
PC 商城	http://域名/
手机商城	http://域名/mobile
PC 客服端	http://域名/kefu/login

用安装时设置的超级管理员账号密码登录管理后台，看到仪表盘就说明部署成功了。

七、踩坑总结

把部署过程中最容易翻车的几个点集中列一下：

1. PHP 版本选错——多商户版用 7.2，单商户高级版用 8.0，版本不对直接安装失败
2. 根目录设错——必须指向 server/public，如果选的是根目录的 public，所有请求会直接 404
3. 遗漏隐藏文件——解压后不要重新打包，原始文件里有安装程序依赖的隐藏配置
4. 伪静态没配——忘记配伪静态会导致除了首页之外的所有页面 404
5. MySQL 密码没改——PHPStudy 首次使用 MySQL 必须手动设置 root 密码
6. sql-mode 报错——按上面的配置修改后记得重启 MySQL

搞定了这几点，LikeShop 在本地跑起来基本没问题。下一步可以看看前后端分离的开发调试，或者小程序端的对接配置。