XAMPP运行ShopXO商城：开源B2C商城系统的本地快速搭建与伪静态配置

ShopXO无法在XAMPP默认运行，因需PHP 8.0+、启用mod_rewrite模块、AllowOverride All，并将public目录内容置于htdocs根目录，且MySQL认证插件须改为mysql_native_password。

不能直接用 XAMPP 运行 ShopXO —— 默认配置下必报 404、admin.php 打不开、后台路由全失效，根本进不去安装页。

为什么 XAMPP 默认跑不起来 ShopXO

ShopXO 基于 ThinkPHP8，依赖 PHP 8.0+、pdo_mysql、mbstring、openssl、curl 等扩展，且必须启用 Apache 的 mod_rewrite 模块 + 正确解析 .htaccess。而 XAMPP（尤其老版本）默认：

• PHP 版本是 7.4 或 8.0 以下（php --version 一查就露馅）
• mod_rewrite 模块未启用（httpd.conf 里 #LoadModule rewrite_module 还被注释着）
• AllowOverride None 没改，导致 public/.htaccess 完全被忽略
• public/ 目录没设为 Web 根目录，却把整个源码丢进 htdocs/shopxo/，结果 /index.php?s= 路由全部 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
• 在同一文件中，找到 <Directory "C:/xampp/htdocs"> 区块，把里面的 AllowOverride None 改成 AllowOverride All
• 把 ShopXO 源码解压后，只把 public/ 目录下的全部内容复制到 C:xampphtdocs（不是整个项目根目录！）
• 确保 C:xampphtdocs.htaccess 存在且内容为 ThinkPHP8 兼容规则（含 RewriteCond %{REQUEST_FILENAME} !-d 和 RewriteCond %{REQUEST_FILENAME} !-f）

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

直接抄网上“万能规则”会导致静态资源（.js、.css、upload/ 图片）全部 404。ShopXO 的 .htaccess 必须带存在性校验：

RewriteEngine OnRewriteCond %{REQUEST_FILENAME} !-dRewriteCond %{REQUEST_FILENAME} !-fRewriteRule ^(.*)$ index.php?s=$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 或认证插件。