XAMPP 环境下安装和配置 X-Cart 购物车的详细步骤-php教程-PHP中文网

x-cart不能直接放入htdocs运行，必须启用mod_rewrite、mbstring、curl等php扩展，配置虚拟主机指向根目录，并用域名（如xcart.local）访问安装向导，否则出现404或路由错乱。

xampp 环境下安装和配置 x-cart 购物车的详细步骤

X-Cart 不能直接丢进 htdocs 就跑起来——它依赖 Apache 的 mod_rewrite、PHP 的 mbstring 和 curl 扩展，且必须通过虚拟主机（VirtualHost）指向其根目录，否则安装向导会 404 或路由错乱。

确保 XAMPP 已启用必要 PHP 扩展

X-Cart 4.x（尤其是 Gold Plus 及以上版本）明确要求 mbstring、curl、gd、xml 和 json。默认 XAMPP 安装中，mbstring 和 curl 往往被注释掉。

打开 C:\xampp\php\php.ini（或你实际的 XAMPP 安装路径）
搜索 ;extension=mbstring 和 ;extension=curl，删掉行首的分号 ;
确认 date.timezone 已设置，例如：date.timezone = "Asia/Shanghai"
保存后，**必须重启 Apache**（在 XAMPP 控制面板里 Stop 再 Start）
验证是否生效：在浏览器访问 http://localhost/dashboard/phpinfo.php，搜索 mbstring 和 curl，看到“enabled”才算成功

配置 Apache 虚拟主机并启用重写

X-Cart 安装向导和前台/后台 URL 都依赖干净的路径（如 /admin.php 而非 /admin.php?mode=login），这需要 mod_rewrite + 正确的 DocumentRoot + AllowOverride All。

XAMPP 8.0.30

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

下载

确认 httpd.conf 中已取消注释：LoadModule rewrite_module modules/mod_rewrite.so

编辑 C:\xampp\apache\conf\extra\httpd-vhosts.conf，追加以下内容（路径和域名按需替换）：

<virtualhost>
    ServerName xcart.local
    DocumentRoot "C:/xampp/htdocs/xcart"
    <directory>
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </directory></virtualhost>

修改系统 hosts 文件（C:\Windows\System32\drivers\etc\hosts），添加一行：127.0.0.1 xcart.local
重启 Apache；之后必须用 http://xcart.local 访问，不能用 http://localhost/xcart

创建数据库并执行安装向导

X-Cart 安装器对数据库权限较敏感，root 用户密码为空是前提；若你已设过密码，安装会卡在“Database connection failed”。

启动 MySQL，访问 http://localhost/phpmyadmin
点击“新建”，输入数据库名（如 xcart），排序规则选 utf8mb4_unicode_ci（X-Cart 4.6+ 强烈推荐）
打开浏览器，访问 http://xcart.local —— 此时应自动跳转到 http://xcart.local/install.php
安装第二步填写数据库信息时：
– 主机：留空或填 localhost
– 用户名：root
– 密码：**留空**（不是填 “root”，也不是填你改过的密码）
– 数据库名：xcart
若提示 “Your server does not meet the requirements”，重点检查 mbstring 是否启用、AllowOverride All 是否生效、以及是否用了虚拟主机地址访问

安装后必须做的三件事

安装成功不等于能用。X-Cart 默认关闭部分关键功能，且本地环境有硬性限制。

登录后台（http://xcart.local/admin.php）后，立即进入 Settings → Security，把 Enable HTTPS for admin area 设为 Off（XAMPP 无有效 SSL，开则白屏）
进入 Settings → General，确认 Shop URL 填的是 http://xcart.local（不是 http://localhost/xcart），否则邮件链接、图片路径全错
检查 C:/xampp/htdocs/xcart/files/ 目录权限：Apache 进程（通常是 SYSTEM 或 Administrators 组）必须有读写权，否则上传商品图、导出 CSV 会失败