XAMPP本地快速部署开源B2C商城ShopXO及伪静态配置

如果直接使用XAMPP默认配置运行ShopXO，很可能遇到404页面，admin.php无法打开，后台路由全部失效，甚至安装页面也无法访问。这并不是XAMPP本身的问题，而是ShopXO对运行环境有明确要求：它基于ThinkPHP8，需要PHP 8.0及以上版本以及几个特定扩展，此外还需要Apache的mod_rewrite模块和正确的.htaccess解析。而旧版本XAMPP的默认配置恰好缺少这些条件。

为什么XAMPP默认跑不起来ShopXO

通俗地说，ShopXO依赖PHP 8.0+、pdo_mysql、mbstring、openssl、curl等扩展，还要求Apache启用mod_rewrite模块，并且必须能解析.htaccess。而大多数XAMPP（尤其是老版本）默认处于以下状态：

• PHP版本还是7.4甚至更低（运行php --version即可确认）
• mod_rewrite模块并未启用——httpd.conf中#LoadModule rewrite_module仍被注释
• AllowOverride None未修改，导致public/.htaccess完全被忽略
• public/目录未被设为Web根目录，而是将整个源码丢进htdocs/shopxo/，结果所有/index.phps=路由都返回404

由此可见，问题的根源已经非常清晰。

XAMPP启动ShopXO的实操路径

并非“装完XAMPP就能跑”，而是必须手动调整三个环节：PHP版本、Apache模块、Web根目录。三者缺一不可，顺序也不能乱。

• 下载XAMPP 8.2.x版本（例如xampp-windows-x64-8.2.12-0-VC17-installer.exe），其自带的PHP 8.2可满足要求。旧版XAMPP升级无效，需要重装。
• 启动XAMPP Control Panel → 点击Apache右侧的“Config” → 选择“Apache (httpd.conf)” → 找到并取消注释这一行：LoadModule rewrite_module modules/mod_rewrite.so
• 在同一文件中，找到区块，将里面的AllowOverride None改为AllowOverride All
• 将ShopXO源码解压后，只把public/目录下的全部内容复制到C:\xampp\htdocs（注意：不是整个项目根目录）
• 确保C:\xampp\htdocs\.htaccess存在且内容为ThinkPHP8兼容规则（后面会给出正确写法）

伪静态规则必须加条件判断，否则会崩

网上许多“万能规则”直接搬过来，会导致静态资源（.js、.css、upload/中的图片）全部404。ShopXO的.htaccess必须带存在性校验，如下所示：

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ index.phps=$1 [QSA,PT,L]

• RewriteCond %{REQUEST_FILENAME} !-d：跳过真实存在的目录（如upload/）
• RewriteCond %{REQUEST_FILENAME} !-f：跳过真实存在的文件（如favicon.ico）
• [L]必须添加，否则后续规则会干扰路由匹配
• 不要用记事本保存.htaccess——编码应选UTF-8无BOM，否则Apache会直接拒绝读取

安装时卡在“数据库连接失败”的真实原因

页面提示Connection refused或直接白屏，十有八九不是密码输错，而是MySQL认证方式不兼容。XAMPP 8.2+默认MySQL用户root使用caching_sha2_password插件认证，但ThinkPHP8的pdo_mysql驱动不支持该插件。解决办法如下：

• 通过phpMyAdmin登录 → 用户账户 → 选择root@localhost → “编辑权限” → 底部“更改登录信息” → 密码认证插件选mysql_native_password → 保存
• 再检查.env中的DB_HOST=127.0.0.1（不能写localhost，Windows下DNS解析可能走IPv6导致连接失败）
• DB_PORT=3306必须显式写出，XAMPP有时会监听非标准端口

伪静态和数据库连通是两个独立关卡，一个不通就会卡死。很多人反复重装，其实只是没改AllowOverride或认证插件——这两步一旦搞定，后续流程就顺畅了。