在XAMPP环境中部署Drupal系统,核心前提是确保PHP环境具备Drupal所需的数据库驱动支持,Drupal默认使用MySQL或MariaDB作为底层存储数据库,对应的PHP扩展需要提前开启才能正常建立数据库连接。

XAMPP环境准备与基础检查
首先确保已经正确安装XAMPP,并且启动Apache和MySQL服务。打开XAMPP控制面板,查看两个服务的状态是否为运行中,如果MySQL服务启动失败,先检查3306端口是否被其他程序占用。
Drupal对PHP版本有明确要求,以Drupal 10为例,需要PHP 8.1及以上版本,XAMPP的PHP版本需要满足对应要求,可以新建一个phpinfo页面查看当前PHP版本和已开启的扩展。
<?php // 查看PHP配置信息 phpinfo(); ?>
配置PHP数据库驱动扩展
XAMPP默认安装的PHP已经包含MySQL相关的驱动扩展,但部分版本可能未默认开启,需要手动修改PHP配置文件。
修改php.ini配置文件
找到XAMPP安装目录下的php文件夹,打开php.ini配置文件,搜索以下扩展项,去掉前面的分号注释即可开启:
extension=mysqli:MySQL改进扩展,Drupal核心依赖该扩展连接数据库extension=pdo_mysql:PDO方式的MySQL驱动,部分Drupal模块会用到extension=mbstring:多字节字符串处理扩展,Drupal安装必须项extension=gd:图片处理扩展,用于Drupal的图片功能
修改完成后保存配置文件,重启XAMPP的Apache服务让配置生效。
验证驱动是否开启成功
再次访问之前的phpinfo页面,搜索mysqli和pdo_mysql,如果能看到对应的配置区块,说明驱动已经成功开启。
Drupal系统部署与数据库配置
将下载好的Drupal压缩包解压到XAMPP的htdocs目录下,比如解压到htdocs/drupal文件夹,然后在浏览器访问http://127.0.0.1/drupal进入Drupal安装流程。
数据库配置步骤
在安装流程的数据库配置页面,按照以下信息填写:
| 配置项 | 填写内容 | 说明 |
|---|---|---|
| 数据库类型 | MySQL | 选择MariaDB也可以,两者兼容 |
| 数据库名称 | drupal_db | 提前在phpMyAdmin创建的数据库名 |
| 数据库用户名 | root | XAMPP默认MySQL用户名 |
| 数据库密码 | 空 | XAMPP默认MySQL密码为空,若修改过则填对应密码 |
| 数据库主机 | localhost | 本地部署填写localhost即可 |
| 数据库端口 | 3306 | MySQL默认端口,未修改则保持默认 |
填写完成后点击保存并继续,如果驱动配置正确,就会进入Drupal的后续安装步骤,若提示数据库连接错误,回到php.ini检查驱动扩展是否正确开启。
常见问题排查
如果安装时提示未检测到MySQL驱动,首先检查php.ini中对应的扩展是否去掉注释,然后检查XAMPP的php/ext目录下是否存在对应的扩展文件,比如php_mysqli.dll和php_pdo_mysql.dll,如果文件缺失需要重新下载对应版本的扩展文件放到该目录。
另外需要注意,Windows系统和Linux系统的XAMPP配置方式略有不同,Linux系统下php.ini的路径通常在/opt/lampp/etc/php.ini,扩展文件的后缀是.so而不是.dll,修改时需要注意系统差异。
完成所有配置后,Drupal系统就可以正常在XAMPP环境下运行,后续可以根据需要安装对应的模块和主题,完善站点功能。