在PHP开发中，连接MySQL数据库是几乎所有动态项目都需要完成的基础操作，正确的连接配置和合适的连接方式能保障项目数据交互的稳定运行。不同的PHP版本和项目需求对应不同的连接方案，开发者需要根据实际情况选择适配的方法。
连接前的基础配置准备
无论使用哪种方式连接MySQL数据库，都需要先准备好对应的连接参数，这些参数通常包含数据库服务器的地址、端口、数据库名称、登录用户名和密码，部分场景下还需要指定字符集避免中文乱码问题。
如果是本地开发环境，默认的数据库服务器地址一般是127.0.0.1，MySQL默认端口是3306，这些参数如果没有修改过可以直接使用。如果是线上环境，需要向服务器管理员获取对应的真实参数，不要随意填写默认值。
使用mysqli扩展连接MySQL
mysqli是PHP针对MySQL开发的扩展，分为面向过程和面向对象两种使用方式，兼容性较好，适合习惯过程式编程或者只需要对接MySQL数据库的场景。
面向过程方式连接
面向过程的方式直接调用mysqli_connect函数完成连接，代码逻辑比较直观，适合新手快速上手。
<?php
// 数据库连接参数配置
$host = '127.0.0.1'; // 数据库服务器地址
$port = '3306'; // MySQL端口
$dbname = 'test_db'; // 要连接的数据库名称
$username = 'root'; // 数据库登录用户名
$password = '123456'; // 数据库登录密码
// 建立数据库连接
$conn = mysqli_connect($host, $username, $password, $dbname, $port);
// 检查连接是否成功
if (!$conn) {
die('数据库连接失败：' . mysqli_connect_error());
}
// 设置字符集为utf8，避免中文乱码
mysqli_set_charset($conn, 'utf8');
echo 'mysqli面向过程方式连接数据库成功';
// 使用完成后关闭连接
mysqli_close($conn);
?>面向对象方式连接
面向对象的方式通过实例化mysqli类完成连接，代码结构更清晰，符合面向对象编程的习惯。
<?php
// 数据库连接参数配置
$host = '127.0.0.1';
$port = '3306';
$dbname = 'test_db';
$username = 'root';
$password = '123456';
// 实例化mysqli类建立连接
$conn = new mysqli($host, $username, $password, $dbname, $port);
// 检查连接状态
if ($conn->connect_error) {
die('数据库连接失败：' . $conn->connect_error);
}
// 设置字符集
$conn->set_charset('utf8');
echo 'mysqli面向对象方式连接数据库成功';
// 关闭连接
$conn->close();
?>使用PDO连接MySQL
PDO即PHP Data Objects，是PHP提供的一个数据库抽象层，支持多种数据库类型，如果项目后续可能更换数据库类型，使用PDO会更方便，不需要大幅修改连接代码。
<?php
// 数据库连接参数配置
$host = '127.0.0.1';
$port = '3306';
$dbname = 'test_db';
$username = 'root';
$password = '123456';
$charset = 'utf8';
// 构造DSN字符串，包含数据库类型、地址、端口、库名和字符集
$dsn = "mysql:host=$host;port=$port;dbname=$dbname;charset=$charset";
try {
// 实例化PDO类建立连接
$pdo = new PDO($dsn, $username, $password);
// 设置错误模式为异常模式，方便捕获连接错误
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
echo 'PDO方式连接数据库成功';
} catch (PDOException $e) {
die('数据库连接失败：' . $e->getMessage());
}
// 使用完成后销毁PDO实例即可关闭连接
$pdo = null;
?>两种连接方式的对比
开发者可以根据项目需求选择合适的连接方式，以下是两种方式的简单对比：
| 对比项 | mysqli扩展 | PDO |
|---|---|---|
| 支持数据库类型 | 仅支持MySQL | 支持MySQL、PostgreSQL、SQLite等多种数据库 |
| 编程风格 | 支持面向过程和面向对象 | 仅支持面向对象 |
| 参数绑定 | 支持但不如PDO灵活 | 支持预处理语句，参数绑定更安全 |
| 适用场景 | 仅对接MySQL的小型项目 | 可能更换数据库或者需要更高安全性的项目 |
连接常见问题处理
在配置连接时经常会遇到连接失败的问题，常见原因和解决方法如下：
- 连接参数错误：检查服务器地址、端口、用户名、密码、数据库名称是否正确，尤其是线上环境不要使用本地默认参数。
- MySQL服务未启动：检查服务器上的MySQL服务是否正常运行，本地环境可以通过服务管理面板查看。
- 扩展未开启：检查php.ini文件中是否开启了对应的扩展，mysqli扩展需要去掉extension=mysqli前面的分号，PDO需要开启extension=pdo_mysql。
- 权限不足：确认数据库用户是否有对应数据库的连接和操作权限，必要时可以给用户授予对应权限。
实际开发中建议把数据库连接参数放到单独的配置文件中，不要直接在业务代码里写死，这样后续修改参数或者切换环境会更方便，也能提升代码的安全性和可维护性。
PHPMySQL数据库连接mysqliPHP_Data_Objects修改时间：2026-06-02 23:37:25