PHP通过客户端连接数据库服务器，核心是使用mysqli或PDO扩展，在代码中指定服务器地址、用户名、密码和数据库名即可完成连接。
PHP连接数据库服务器的两种主流客户端方式
PHP开发者面对数据库连接时，主要在两个客户端扩展中做选择：mysqli和PDO，两者都能稳定连接MySQL服务器,但设计思路和适用场景有明显差异。
mysqli扩展：面向过程与面向对象并存
mysqli是MySQL官方推出的专用扩展，同时支持面向过程和面向对象两种写法，对于习惯写简单脚本的开发者,面向过程版本上手更快：
$conn = mysqli_connect('localhost', 'root', 'mypassword', 'mydb');
if (!$conn) {
die('连接失败: ' . mysqli_connect_error());
}
面向对象版本则更符合现代PHP风格：
$mysqli = new mysqli('localhost', 'root', 'mypassword', 'mydb');
if ($mysqli->connect_error) {
die('连接失败: ' . $mysqli->connect_error);
}
mysqli的优势在于完全针对MySQL优化，性能略高，并且支持预处理语句、事务和高级特性如异步查询，但缺点也很明显：只能用于MySQL,无法迁移到其他数据库。
PDO扩展：统一接口支持多种数据库
PDO（PHP Data Objects）提供了一个轻量级的数据访问抽象层，无论你连接MySQL、PostgreSQL还是SQLite，代码结构保持一致,连接MySQL的典型写法：
try {
$pdo = new PDO('mysql:host=localhost;dbname=mydb', 'root', 'mypassword');
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
} catch (PDOException $e) {
die('连接失败: ' . $e->getMessage());
}
PDO的预处理语句默认使用模拟预处理，但可以开启原生预处理，对于需要跨数据库移植的项目，PDO是事实上的标准，据PHP官方文档统计,目前新项目中使用PDO的比例已经超过mysqli。
选择哪种客户端？场景决定
| 对比维度 | mysqli | PDO |
|---|---|---|
| 数据库支持 | 仅MySQL | 12种以上数据库 |
| 预处理语句 | 支持 | 支持 |
| 错误处理 | 过程或异常 | 异常为主 |
| 性能 | 稍高 | 基本持平 |
| 代码可移植性 | 低 | 高 |
| 是否推荐新项目 | 一般 | 推荐 |
如果项目只使用MySQL且需要极致性能，mysqli是合理选择，但多数情况下，行业共识认为PDO是更现代、更安全的做法,尤其在团队协作和后期维护中优势明显。
PHP连接数据库服务器失败怎么办？
连接失败是新手最常见的挫折，从错误信息入手，按顺序排查,多数问题能在几分钟内定位。
检查服务器地址和端口
- 本地开发用
localhost或0.0.1，生产环境用IP或域名 - 默认端口MySQL是3306，如果修改过端口，必须在连接时指定
- 使用套接字连接时，注意
mysql.default_socket配置是否匹配
// 自定义端口
$pdo = new PDO('mysql:host=192.168.1.100;port=3307;dbname=mydb', ...);
验证用户名和密码
- 确认用户名在数据库服务器上存在，且允许从当前主机连接
- 检查密码是否包含特殊字符（如、），需要URL编码或正确转义
- 云数据库如简米云RDS，通常需要创建高权限账号后再分配
确认数据库服务器是否运行
- 在服务器终端执行
systemctl status mysql或service mysql status - 使用命令行客户端测试：
mysql -u root -p，如果命令行能连，PHP连接失败则是配置问题 - 检查MySQL错误日志，通常位于
/var/log/mysql/error.log
防火墙和网络问题
PHP扩展是否启用
- 打开
phpinfo()，搜索mysqli或pdo_mysql，确认扩展已加载 - 未加载则在
php.ini中取消注释：extension=mysqli和extension=pdo_mysql - 安装扩展：
sudo apt install php-mysql或sudo yum install php-mysqlnd
错误信息解读
Connection refused：服务器未运行或端口错误Access denied for user：用户名密码错误，或不允许从该主机连接Unknown database：数据库名不存在Cannot connect to MySQL server：网络不通或主机名解析失败
用mysqli_connect_error()或PDO异常捕获具体信息，不要直接die()一个固定字符串。
PHP连接数据库服务器代码示例与最佳实践
直接给出可运行的代码,并附上业界推荐的写法。
mysqli连接示例（带预处理）
$mysqli = new mysqli('localhost', 'root', 'password', 'mydb');
if ($mysqli->connect_error) {
exit('连接失败: ' . $mysqli->connect_error);
}
$stmt = $mysqli->prepare('SELECT FROM users WHERE email = ?');
$stmt->bind_param('s', $email);
$email = 'test@example.com';
$stmt->execute();
$result = $stmt->get_result();
while ($row = $result->fetch_assoc()) {
echo $row['name'];
}
$stmt->close();
$mysqli->close();
PDO连接示例（带异常处理）
$dsn = 'mysql:host=localhost;dbname=mydb;charset=utf8mb4';
$options = [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
PDO::ATTR_EMULATE_PREPARES => false,
];
try {
$pdo = new PDO($dsn, 'root', 'password', $options);
} catch (PDOException $e) {
exit('数据库连接失败: ' . $e->getMessage());
}
$stmt = $pdo->prepare('SELECT FROM users WHERE email = :email');
$stmt->execute(['email' => 'test@example.com']);
$users = $stmt->fetchAll();
连接池与持久连接
- 持久连接（
PDO::ATTR_PERSISTENT）可减少连接开销，但可能引发资源泄漏，生产环境慎用 - 现代PHP框架（如Laravel、Symfony）默认使用短连接，配合连接池中间件（如ProxySQL）实现高并发
处理连接异常
- 总是将连接代码放在try-catch块中，确保异常有统一处理
- 记录错误日志而不是直接显示给用户
- 使用
set_error_handler或set_exception_handler全局兜底
PHP连接数据库服务器配置详解：从本地到云端
不同环境下的配置参数差异很大,尤其是云数据库的场景。
本地开发环境配置
- 使用
localhost，通常无需密码 - 数据库名和表名在本地和线上保持一致，避免大小写问题
- 推荐使用Docker快速搭建本地环境，避免版本冲突
生产环境配置
- 使用内网IP连接数据库服务器，减少网络延迟
- 开启SSL连接：
PDO::MYSQL_ATTR_SSL_CA指定CA证书路径 - 数据库服务器只允许应用服务器访问，禁用
root远程登录
连接云数据库（如简米云RDS、酷番云、华为云）
- 获取云数据库的内网地址和外网地址，生产环境必须用内网
-
创建数据库账号时，指定可访问的IP地址（如应用服务器的内网IP）
- 如果必须外网连接，需要开通公网地址并设置白名单，同时开启SSL加密
- 连接字符串示例：
mysql:host=<内网地址>;port=3306;dbname=mydb;charset=utf8mb4
PHP连接数据库安全注意事项
连接数据库只是第一步,安全防护贯穿整个生命周期。
使用预处理语句防止SQL注入
- 无论mysqli还是PDO，都使用参数化查询，不拼接SQL字符串
- 设定
PDO::ATTR_EMULATE_PREPARES为false，开启原生预处理 - 过滤输入数据虽好，但不能替代预处理
数据库密码管理
- 永远不要将密码硬编码在PHP文件中
- 使用环境变量（
.env文件）存储敏感信息，生产环境通过系统环境变量注入 - 数据库用户遵循最小权限原则，只授予当前业务需要的权限
连接加密
- 生产环境要求MySQL开启SSL/TLS，PHP连接时指定CA证书
- 云数据库大多默认开启SSL，需在PDO连接选项中添加
MYSQL_ATTR_SSL_CA和MYSQL_ATTR_SSL_VERIFY_SERVER_CERT - 使用
mysqli时，通过MYSQLI_CLIENT_SSL标志启用SSL
PHP连接数据库服务器常见问题解答
php连接数据库服务器需要哪些信息？
需要准备四个核心参数：数据库服务器主机地址（host，如localhost或内网IP）、端口号（port，MySQL默认3306）、数据库用户名（username）和密码（password），以及目标数据库名（dbname），如果使用套接字连接，则无需端口，但要指定socket路径。
php连接数据库服务器超时怎么解决？
超时原因通常涉及网络延迟、防火墙拦截或数据库负载过高，首先检查网络连通性，用telnet测试端口是否可达，再调整PHP连接超时设置：PDO通过PDO::ATTR_TIMEOUT设置（单位秒），mysqli通过MYSQLI_OPT_CONNECT_TIMEOUT设置，同时优化数据库服务器，如增加max_connections、调整wait_timeout参数,并确认云数据库的白名单包含了应用服务器IP。
php连接数据库服务器代码示例中，如何选择mysqli和PDO？
如果项目只使用MySQL且不需要迁移，mysqli的面向对象版本是完全可用的选择，但若项目未来可能切换数据库，或需要同时操作多种数据库，PDO是唯一合理的方案，行业共识认为，新项目应优先考虑PDO，因为它提供了更好的异常处理、一致的预处理接口和更广泛的社区支持。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/php%e7%94%a8%e5%ae%a2%e6%88%b7%e7%ab%af%e6%80%8e%e4%b9%88%e8%bf%9e%e6%8e%a5%e6%95%b0%e6%8d%ae%e5%ba%93%e6%9c%8d%e5%8a%a1%e5%99%a8%ef%bc%8c%e8%bf%9e%e4%b8%8d%e4%b8%8a%e6%80%8e%e4%b9%88%e5%8a%9e/
