shopnc b2b2c在xampp上运行失败主因是环境不匹配：需用xampp 7.4.33（php 7.4.33），启用php_mysql、mbstring、gd扩展，禁用session.auto_start，mysql设utf8mb4字符集并新建专用用户，apache配allowoverride all且确保data/cache/upload可写，伪静态依赖server_name需配虚拟主机或修正base_site_url。
ShopNC B2B2C 在 XAMPP 上跑不起来，不是代码问题，而是环境没对齐——它对 PHP 版本、扩展、权限和 MySQL 配置有明确硬性要求，稍有偏差就会卡在安装页或白屏。
PHP 版本与关键扩展必须匹配
ShopNC 官方要求 PHP 5.6+，但实际测试中 PHP 7.2–7.4 更稳定；PHP 8.x 会触发 mysql_connect() 被移除、session_register() 报错等兼容问题。XAMPP 8.0+ 自带 PHP 8.2，不能直接用。
- 推荐使用 XAMPP 7.4.33（含 PHP 7.4.33），下载地址见 Apache Friends 官网历史版本存档
- 确认
php.ini中启用：extension=php_mysql.dll（注意不是pdo_mysql）、extension=php_mbstring.dll、extension=php_gd2.dll -
session.auto_start = Off必须为Off，否则后台登录页反复跳转 - 改完后重启 Apache，并访问
http://localhost/dashboard/phpinfo.php核对扩展状态
MySQL 权限与字符集要手动调
ShopNC 安装时创建数据表失败，常见于 MySQL 用户权限不足或字符集不支持 emoji —— 它的 shopnc_goods 表字段含 TEXT 和富文本描述，utf8 不够用。
XAMPP 8.0.30 是一款免费、开源的跨平台 Web 服务器集成包，专为快速搭建本地 PHP 开发环境而设计。该版本核心组件包括：Apache 2.4.56、MySQL 8.0.33、PHP 8.0.30、phpMyAdmin 5.2.1 等。它支持 Windows、Linux 和 macOS 系统，可让开发者在个人电脑上轻松模拟服务器环境，无需复杂配置即可运行 WordPress、Thin
- 用 phpMyAdmin 登录 root（密码为空），执行：
CREATE DATABASE shopnc DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; - 检查 MySQL 配置文件
xampp/mysql/bin/my.ini，确保 [mysqld] 段落含：character-set-server=utf8mb4和collation-server=utf8mb4_unicode_ci - 不要用默认的
root@localhost直接安装，建议新建用户：CREATE USER 'shopnc'@'localhost' IDENTIFIED BY 'strongpass123'; GRANT ALL PRIVILEGES ON shopnc.* TO 'shopnc'@'localhost'; FLUSH PRIVILEGES;
目录权限与 .htaccess 缺失是静默杀手
安装页面能打开，但点击“下一步”后空白或重定向回首页，大概率是 Apache 没读到重写规则，或缓存目录不可写——ShopNC 的 data/ 和 cache/ 目录需全程可写。
- 解压 ShopNC 后，确认
htdocs/shopnc/.htaccess存在（Windows 解压常丢失该文件，建议用 7-Zip 或命令行tar -xzf提取） - 编辑
xampp/apache/conf/httpd.conf，找到<directory></directory>区块，把AllowOverride None改成AllowOverride All - 确保
htdocs/shopnc/data/、htdocs/shopnc/cache/、htdocs/shopnc/upload/对 Apache 进程（Windows 下是IIS_IUSRS或Everyone）有完全控制权限 - 安装完成后务必删掉
htdocs/shopnc/install/目录，否则安全扫描会告警
伪静态启用后 URL 路由仍 404？检查 SERVER_NAME
后台菜单点击无反应、商品页打不开，不是模板错，而是 ShopNC 的路由依赖 $_SERVER['SERVER_NAME'] 值为真实域名，而 XAMPP 默认是 localhost，导致路径拼接异常。
- 临时方案：修改
shopnc/config/config.php，在define('BASE_SITE_URL', 'http://localhost');后加一行：define('BASE_SITE_URL', 'http://localhost/shopnc');（注意末尾无斜杠） - 更稳妥做法：配虚拟主机，在
httpd-vhosts.conf加：<virtualhost> DocumentRoot "C:/xampp/htdocs/shopnc" ServerName shopnc.test </virtualhost>，再改 hosts 文件映射127.0.0.1 shopnc.test - 别碰
index.php里的$_SERVER['REQUEST_URI']手动截断逻辑——ShopNC 的 URL 解析器很脆弱，小改就崩
ShopNC 的本地运行难点不在功能多，而在它把 PHP 5.x 时代的耦合写法固化进了核心逻辑：数据库连接靠全局变量、模板渲染不走自动加载、缓存键名硬编码。一旦环境参数和预期有毫厘偏差，错误不会明说，只会静默失败。动手前先核对 PHP 版本输出和 phpinfo() 里扩展状态，比反复重装快得多。
