如何在 XAMPP 环境中安装和调试 Shopware 电商系统

Shopware 6.4+要求PHP 8.1或8.2，XAMPP需匹配版本；须启用opcache、pdo_mysql等扩展及mod_rewrite，配置虚拟主机指向public目录，并正确设置Xdebug 3（端口9003）与UTF8MB4字符集。 确认 XAMPP 版本与 PHP 兼容性 Shopware 6.4+ 要求 PHP 8.1 或 8.2，而 XAMPP 默认附带的 PHP 版本往往滞后（例如 Windows 上常见 XAMPP 8.2.x 捆绑 PHP 8.2.0，但早期 XAMPP 8.1.x 可能只含 PHP 8.1.10）。若用错版本， 会直接报错 。 实操建议： 运行 → 点击 Apache 行右侧的 → ，打开后搜索 和 ，确保时区已设（如 ） 在命令行执行 和 ，确认关键扩展全部启用；缺 扩展会导致 Shopware 安装器卡在“Checking system requirements” 若 PHP 版本不足，不要手动替换 XAMPP 内的 PHP 目录——容易破坏 Apache 集成。应直接下载匹配的 新版 XAMPP ，或改用 / 分离管理 用 Composer 安装 Shopware 6（非 ZIP 包方式） 官网提供的 ZIP 包（ ）不含 ，且默认禁用开发模式，调试困难。必须用 Composer 安装才能启用热重载、Xdebug 断点和插件开发支持。 实操建议： 关闭 XAMPP 中的 Apache 和 MySQL，避免端口占用；在 下新建空文件夹（如 ），cd 进入后执行： 安装完成后，运行 初始化数据库（它会自动创建 数据库并导入基础结构）；若提示 ，说明 MySQL root 密码非空——需先在 中设置 ，或修改 中的 务必执行 ，否则后台 CSS/JS 404；Windows 下 失效，改用 配置 Apache 虚拟主机并启用重写 Shopware 6 依赖 Apache 的 和正确的 指向 目录。直接访问 会导致路由错误或后台白屏。 实操建议： 编辑 ，追加： 在系统 hosts 文件（ ）末尾添加： 重启 Apache；访问 应显示 Shopware 安装向导（若仍跳转到 XAMPP 默认页，检查 Apache 错误日志 是否报 ——说明未启用 ：编辑 ，取消注释 启用 Xdebug 并验证断点调试 Shopware 后台控制器、事件订阅器、自定义服务等逻辑无法靠 有效追踪，必须用 Xdebug 配合 IDE（如 PHPStorm 或 VS Code）单步执行。XAMPP 自带的 Xdebug 版本常与 PHP 8.2 不兼容，导致 显示 “enabled” 但 IDE 无法连接。 实操建议： 从 xdebug.org/download 下载对应 PHP 版本和线程安全（TS）标识的 （例如 PHP 8.2 TS → xdebug-3.3.1-8.2-vs16-x86_64.dll），放入 在 末尾添加： 注意：Xdebug 3 使用 ，不是旧版的 在 PHPStorm 中配置 PHP Interpreter 指向 ，并确认 Debug port 为 9003；在 Shopware 控制器方法首行打上断点，访问 URL 时在浏览器地址栏末尾加 即可触发连接 路径权限、MySQL 字符集（必须是 ）、以及 被 Apache 忽略——这三个点最容易被跳过，但任一出问题都会让后台登录页空白或 API 返回 500。