XAMPP环境部署Magento商城 XAMPP PHP扩展开启清单-php教程-PHP中文网

magento 2.4.x在xampp上必须启用curl、gd、mbstring、openssl、pdo_mysql、soap、xml、zip、intl、xsl扩展，且intl需icu≥72.1匹配；apache须设allowoverride all并启用mod_rewrite；mysql需禁用strict_trans_tables；memory_limit≥2g。

xampp环境部署magento商城 xampp php扩展开启清单

Magento 2.4.x 在 XAMPP 上跑不起来，八成卡在 PHP 扩展没开全或开错位置——不是“开了就行”，而是必须同时满足版本、依赖、加载顺序三重条件。

哪些扩展必须启用（且不能只去掉分号）

Magento 2.4.x 官方明确要求以下扩展全部启用并实际加载成功：curl、gd、mbstring、openssl、pdo_mysql、soap、xml、zip、intl、xsl。注意：sodium 和 sockets 虽非强制，但部分支付模块和 CLI 命令会触发依赖，建议一并开启。

常见错误是仅在 php.ini 中删掉分号，却忽略 Apache 实际加载的配置文件路径。XAMPP 多数版本使用 \xampp\php\php.ini，但 Apache 启动时可能读取的是 \xampp\apache\bin\php.ini（尤其升级后），务必用 phpinfo() 页面确认 “Loaded Configuration File” 路径。

用命令行验证是否真加载：php -m | findstr intl（Windows）或 php -m | grep intl（Linux/macOS），有输出才算成功
intl 扩展失败最典型报错：PHP Startup: Unable to load dynamic library 'intl'，本质是 php_intl.dll 依赖的 ICU DLL 版本与 PHP 不匹配，不能手动复制 DLL
推荐直接使用 XAMPP 8.2.12（含 PHP 8.2.12），其 intl 与 ICU 已预验证兼容

为什么开了 `intl` 还报错？ICU 版本陷阱

XAMPP 自带的 php_intl.dll 必须与同版本 PHP 绑定的 ICU 库严格对应。PHP 8.2.x 通常需要 ICU 72.x，而旧版 XAMPP（如 8.2.0）自带 ICU 71.x，就会导致扩展加载失败，且错误日志里只显示“无法加载”，不提示 ICU 版本问题。

不要尝试从其他 PHP 版本拷贝 icu*.dll 到 \xampp\apache\bin\，极易引发 Apache 启动崩溃。唯一稳妥解法是换用已验证兼容的 XAMPP 版本（如 8.2.12）或改用官方推荐的 WAMPserver / Docker 环境。

检查 ICU 版本：在 phpinfo() 页面搜索 “ICU version”，确认 ≥72.1
若版本不符，php -v 会报 Warning：Intl extension is loaded but ICU version is too old
Apache 启动失败时，查看 \xampp\apache\logs\error.log，常有 httpd.exe: Syntax error on line ... 提示，说明 DLL 加载中断

Apache 配置不改，`.htaccess` 就是摆设

XAMPP 默认把所有目录设为 AllowOverride None，导致 Magento 的 .htaccess 文件完全被忽略——结果就是前台白屏、后台路由 404、静态资源返回 403，而错误日志里几乎不报 Apache 层问题。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

必须定位到虚拟主机或主目录段落，把 AllowOverride None 改成 AllowOverride All，并确保 mod_rewrite 已在 XAMPP 控制面板中勾选启用。

修改位置通常在 \xampp\apache\conf\extra\httpd-vhosts.conf 或 \xampp\apache\conf\httpd.conf 的 <directory></directory> 段内
改完务必运行 httpd -t 验证语法，避免拼写错误导致 Apache 无法启动
若部署在子目录（如 http://localhost/magento2），还需在 app/etc/env.php 中显式设置 'base_url' => 'http://localhost/magento2/'，否则 CSS/JS 路径全错

MySQL 严格模式关不掉，安装直接中断

XAMPP 自带 MySQL 8.0+ 默认开启 STRICT_TRANS_TABLES，Magento 安装器执行 DDL 语句时会因默认值不合法报错，典型错误：SQLSTATE[42000]: Syntax error or access violation: 1067 Invalid default value for 'created_at'。

不能只在 phpMyAdmin 里临时 SET，必须永久关闭。编辑 \xampp\mysql\bin\my.ini，在 [mysqld] 段下添加或修改：

sql_mode = "NO_ENGINE_SUBSTITUTION"

然后重启 MySQL 服务。注意：修改后需重新创建数据库（原库仍带严格模式残留），否则安装过程仍会失败。

验证是否生效：登录 MySQL 执行 SELECT @@sql_mode;，输出中不应包含 STRICT_TRANS_TABLES
memory_limit 至少设为 2G，Magento 编译阶段极易因内存不足中断，php.ini 中设 memory_limit=2G，不是 2048M（某些 PHP 版本不识别 M 单位）
max_execution_time 建议设为 18000，避免安装器超时退出

真正卡住 Magento 安装的，往往不是某个扩展没开，而是 intl + ICU + Apache AllowOverride + MySQL sql_mode 四者联动失效——任何一个环节没对上，都会表现为“页面空白”或“404”，但错误日志里找不到直接线索。