XAMPP是一款常用的本地集成开发环境,包含Apache、MySQL、PHP等组件,适合快速搭建各类PHP项目运行环境。很多开发者会选择用它来本地部署Magento电商系统,不过Magento对PHP扩展有特定要求,默认XAMPP的PHP配置往往缺少必要的扩展,需要手动开启才能保障系统正常运行。

XAMPP下开启PHP扩展的方法
不同系统的XAMPP开启PHP扩展的步骤略有差异,核心都是修改php.ini配置文件,以下是通用操作流程:
Windows系统操作步骤
- 打开XAMPP控制面板,点击Apache对应的Config按钮,选择PHP (php.ini)选项,直接打开配置文件
- 在配置文件中找到需要开启的扩展行,去掉行首的分号注释,比如
extension=gd原本是;extension=gd,去掉分号即可 - 修改完成后保存文件,重启Apache服务让配置生效
Linux/macOS系统操作步骤
- 找到XAMPP安装目录下的php.ini文件,通常路径为/opt/lampp/etc/php.ini
- 使用文本编辑器打开文件,同样去掉对应扩展前的注释符号
- 执行/opt/lampp/lampp restart命令重启XAMPP服务
Magento部署必需的PHP扩展清单
以下是Magento 2.x版本在XAMPP环境下必须开启的PHP扩展,缺少任意一个都可能导致安装失败或者功能异常:
| 扩展名称 | 作用说明 |
|---|---|
| gd | 处理图片相关功能,比如商品图片生成、缩略图裁剪等 |
| curl | 支持HTTP请求,用于调用第三方接口、支付回调等场景 |
| intl | 提供国际化支持,处理多语言、多货币相关的业务逻辑 |
| mbstring | 支持多字节字符串处理,避免中文等字符出现乱码问题 |
| xml | 解析XML格式数据,Magento的配置文件、API响应很多使用XML格式 |
| simplexml | 简化XML操作,用于读取和处理系统各类XML配置 |
| openssl | 提供加密相关功能,保障支付、用户数据等传输安全 |
| pdo_mysql | PHP连接MySQL数据库的必需扩展,Magento所有数据存储都依赖MySQL |
| soap | 支持SOAP协议,用于调用部分第三方Web服务接口 |
| zip | 处理压缩文件,用于系统升级、插件安装时的压缩包解压 |
| bcmath | 提供任意精度数学计算,保障订单金额、税费计算准确 |
| tokenizer | PHP词法分析器,Magento的代码解析、路由匹配依赖该扩展 |
扩展开启后的验证方法
开启所有必需扩展后,可以通过phpinfo页面验证是否生效,操作步骤如下:
在XAMPP的htdocs目录下新建一个info.php文件,内容如下:
<?php phpinfo(); ?>
在浏览器中访问http://localhost/info.php,搜索对应的扩展名称,如果能看到扩展的相关信息,说明已经成功开启。验证完成后建议删除该文件,避免暴露服务器信息。
部署注意事项
- 确认XAMPP的PHP版本符合Magento的要求,比如Magento 2.4.x需要PHP 7.4及以上版本,不要使用过低版本的PHP
- 除了PHP扩展,还需要确保Apache开启了mod_rewrite模块,用于支持Magento的伪静态规则
- MySQL的版本也需要匹配Magento要求,建议开启innodb存储引擎,Magento的表默认使用innodb
- 如果安装过程中提示缺少扩展,先检查php.ini中是否正确去掉了注释,再确认是否重启了Apache服务
注意:修改php.ini文件前建议先备份原文件,避免出现配置错误无法恢复的情况。如果开启扩展后Apache无法启动,可以查看XAMPP的日志文件定位错误原因,通常是扩展文件路径配置错误导致的。