如何在 XAMPP 环境中安装和调试 Shopware 电商系统-php教程-PHP中文网

shopware 6.4+要求php 8.1或8.2，xampp需匹配版本；须启用opcache、pdo_mysql等扩展及mod_rewrite，配置虚拟主机指向public目录，并正确设置xdebug 3（端口9003）与utf8mb4字符集。

如何在 xampp 环境中安装和调试 shopware 电商系统

确认 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）。若用错版本，composer create-project 会直接报错 Your requirements could not be resolved。

实操建议：

运行 xampp-control.exe → 点击 Apache 行右侧的 Config → PHP (php.ini)，打开后搜索 extension_dir 和 date.timezone，确保时区已设（如 date.timezone = "Europe/Berlin"）
在命令行执行 php -v 和 php -m | findstr "opcache pdo_mysql mbstring xml curl json"，确认关键扩展全部启用；缺 intl 扩展会导致 Shopware 安装器卡在“Checking system requirements”
若 PHP 版本不足，不要手动替换 XAMPP 内的 PHP 目录——容易破坏 Apache 集成。应直接下载匹配的新版 XAMPP，或改用 phpbrew / xampp-portable 分离管理

用 Composer 安装 Shopware 6（非 ZIP 包方式）

官网提供的 ZIP 包（shopware-6-x.x.x.zip）不含 vendor/，且默认禁用开发模式，调试困难。必须用 Composer 安装才能启用热重载、Xdebug 断点和插件开发支持。

实操建议：

关闭 XAMPP 中的 Apache 和 MySQL，避免端口占用；在 C:\xampp\htdocs\ 下新建空文件夹（如 sw6），cd 进入后执行：
```
composer create-project shopware/platform:6.5.5.3 sw6 --no-interaction
```
安装完成后，运行 php bin/console system:setup 初始化数据库（它会自动创建 shopware 数据库并导入基础结构）；若提示 SQLSTATE[HY000] [1045] Access denied，说明 MySQL root 密码非空——需先在 C:\xampp\php\php.ini 中设置 mysqli.default_pw = ""，或修改 .env 中的 DATABASE_URL=mysql://root:your_password@127.0.0.1:3306/shopware
务必执行 php bin/console assets:install public --symlink，否则后台 CSS/JS 404；Windows 下 --symlink 失效，改用 --relative

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

Shopware 6 依赖 Apache 的 mod_rewrite 和正确的 DocumentRoot 指向 public/ 目录。直接访问 http://localhost/sw6/public 会导致路由错误或后台白屏。

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

下载

实操建议：

编辑 C:\xampp\apache\conf\extra\httpd-vhosts.conf，追加：

<virtualhost>
    ServerName shopware.test
    DocumentRoot "C:/xampp/htdocs/sw6/public"
    <directory>
        AllowOverride All
        Require all granted
    </directory></virtualhost>

在系统 hosts 文件（C:\Windows\System32\drivers\etc\hosts）末尾添加：127.0.0.1 shopware.test
重启 Apache；访问 http://shopware.test 应显示 Shopware 安装向导（若仍跳转到 XAMPP 默认页，检查 Apache 错误日志 C:\xampp\apache\logs\error.log 是否报 Invalid command 'RewriteEngine'——说明未启用 mod_rewrite：编辑 C:\xampp\apache\conf\httpd.conf，取消注释 LoadModule rewrite_module modules/mod_rewrite.so

启用 Xdebug 并验证断点调试

Shopware 后台控制器、事件订阅器、自定义服务等逻辑无法靠 var_dump 有效追踪，必须用 Xdebug 配合 IDE（如 PHPStorm 或 VS Code）单步执行。XAMPP 自带的 Xdebug 版本常与 PHP 8.2 不兼容，导致 phpinfo() 显示 “enabled” 但 IDE 无法连接。

实操建议：

从 xdebug.org/download 下载对应 PHP 版本和线程安全（TS）标识的 php_xdebug.dll（例如 PHP 8.2 TS → xdebug-3.3.1-8.2-vs16-x86_64.dll），放入 C:\xampp\php\ext\

在 php.ini 末尾添加：

[XDebug]
zend_extension = "C:\xampp\php\ext\php_xdebug.dll"
xdebug.mode = debug
xdebug.start_with_request = trigger
xdebug.client_host = 127.0.0.1
xdebug.client_port = 9003
xdebug.log = "C:\xampp\php\logs\xdebug.log"

注意：Xdebug 3 使用 xdebug.mode = debug，不是旧版的 xdebug.remote_enable=1

在 PHPStorm 中配置 PHP Interpreter 指向 C:\xampp\php\php.exe，并确认 Debug port 为 9003；在 Shopware 控制器方法首行打上断点，访问 URL 时在浏览器地址栏末尾加 ?XDEBUG_SESSION_START=PHPSTORM 即可触发连接