要在php中连接mariadb数据库,首先要确保php环境已启用pdo或mysqli扩展。1. 检查php.ini文件并启用extension=pdo_mysql或extension=mysqli,保存后重启服务器;2. 推荐使用pdo方式连接,示例代码为通过new pdo设置主机、数据库名、用户名及密码,并设置错误模式;3. 也可使用mysqli方式连接,通过new mysqli传入参数并检查连接状态;4. 若连接失败,应检查数据库运行状态、账号信息、远程访问权限、防火墙设置及日志信息,必要时联系服务商确认限制情况。

要在PHP中连接MariaDB数据库,核心在于配置好PDO或MySQLi扩展,并正确填写数据库的连接参数。下面直接进入详细步骤。

1. 确保环境支持MariaDB连接
在开始之前,确认你的PHP环境已经启用了可以连接MariaDB的扩展,最常见的是PDO_MySQL或者mysqli。你可以通过以下方式检查:

- 打开
php.ini文件 - 查找并取消注释(去掉前面的分号)如下两行之一:
extension=pdo_mysqlextension=mysqli
保存文件后重启Web服务器(如Apache或Nginx),确保更改生效。
立即学习“PHP免费学习笔记(深入)”;
如果你使用的是像XAMPP、WAMP这类集成环境,通常这些扩展默认是启用的。

2. 使用PDO连接MariaDB(推荐方式)
PDO是一个更现代、支持多种数据库的接口,适合需要更高兼容性的项目。以下是基本连接代码示例:
setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
echo "连接成功";
} catch (PDOException $e) {
die("连接失败: " . $e->getMessage());
}
?>几点建议:
- 数据库名、用户名和密码要与你在MariaDB中设置的一致
- 推荐加上
charset=utf8或utf8mb4避免中文乱码 - 开发阶段可以开启错误显示,但上线前应关闭以避免暴露敏感信息
3. 使用MySQLi连接MariaDB(传统方式)
如果你不需要PDO提供的额外功能,也可以使用传统的MySQLi方式连接:
connect_error) {
die("连接失败: " . $conn->connect_error);
}
echo "连接成功";
?>这种方式语法相对简单,适合中小型项目使用。
4. 常见问题及排查方法
连接失败时可以从以下几个方面入手排查:
- 检查数据库是否运行正常(比如通过 phpMyAdmin 或命令行登录)
- 核对用户名、密码是否正确
- 确认是否有远程访问权限(如果数据库不在本地)
- 检查防火墙设置是否允许数据库端口(默认3306)
- 查看错误日志,例如 Apache 的 error.log 或 MariaDB 日志
如果是共享主机环境,可能还需要联系服务商确认是否允许外部连接或是否限制某些函数。
基本上就这些。只要配置得当,PHP连接MariaDB并不复杂,但很多小细节容易忽略。











