当前位置：首页 > 文章列表 > 文章 > php教程 > PHP连接MariaDB详细配置教程

PHP连接MariaDB详细配置教程

2025-07-18 16:07:21 0浏览收藏

想要让你的PHP应用成功连接MariaDB数据库吗？本文为你提供一份完整的配置教程，助你轻松实现PHP与MariaDB的无缝对接。首先，确保你的PHP环境已正确启用PDO_MySQL或MySQLi扩展，这是连接的基础。教程详细讲解了如何通过修改php.ini文件启用所需扩展，并推荐使用PDO方式进行连接，提供清晰的代码示例，包括设置主机、数据库名、用户名和密码，以及处理连接错误。同时，也介绍了MySQLi的连接方法，并针对连接失败的常见问题，如数据库运行状态、账号权限、远程访问限制和防火墙设置等，提供了一套全面的排查方案。无论你是新手还是有经验的开发者，都能通过本文快速掌握PHP连接MariaDB的关键步骤，打造稳定可靠的应用。

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

如何在PHP中配置MariaDB数据库连接的详细步骤？

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

1. 确保环境支持MariaDB连接

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

打开 php.ini 文件
查找并取消注释（去掉前面的分号）如下两行之一：
- extension=pdo_mysql
- extension=mysqli

保存文件后重启Web服务器（如Apache或Nginx），确保更改生效。

如果你使用的是像XAMPP、WAMP这类集成环境，通常这些扩展默认是启用的。

2. 使用PDO连接MariaDB（推荐方式）

PDO是一个更现代、支持多种数据库的接口，适合需要更高兼容性的项目。以下是基本连接代码示例：

<?php
$host = 'localhost';
$db   = 'your_database_name';
$user = 'your_username';
$pass = 'your_password';

try {
    $pdo = new PDO("mysql:host=$host;dbname=$db;charset=utf8", $user, $pass);
    // 设置错误模式为异常
    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
    echo "连接成功";
} catch (PDOException $e) {
    die("连接失败: " . $e->getMessage());
}
?>

几点建议：

数据库名、用户名和密码要与你在MariaDB中设置的一致
推荐加上 charset=utf8 或 utf8mb4 避免中文乱码
开发阶段可以开启错误显示，但上线前应关闭以避免暴露敏感信息

3. 使用MySQLi连接MariaDB（传统方式）

如果你不需要PDO提供的额外功能，也可以使用传统的MySQLi方式连接：

<?php
$host = 'localhost';
$user = 'your_username';
$pass = 'your_password';
$db   = 'your_database_name';

$conn = new mysqli($host, $user, $pass, $db);

if ($conn->connect_error) {
    die("连接失败: " . $conn->connect_error);
}

echo "连接成功";
?>

这种方式语法相对简单，适合中小型项目使用。