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:\xampp\htdocs\（不是整个项目根目录！） - 确保
C:\xampp\htdocs\.htaccess存在且内容为 ThinkPHP8 兼容规则（含RewriteCond %{REQUEST_FILENAME} !-d和RewriteCond %{REQUEST_FILENAME} !-f）
伪静态规则必须加条件判断，否则会崩
直接抄网上“万能规则”会导致静态资源（.js、.css、upload/ 图片）全部 404。ShopXO 的 .htaccess 必须带存在性校验：
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ 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 或认证插件。
