PHP与数据库服务器端建立连接，核心是通过MySQLi或PDO扩展实例化连接对象，并传入服务器地址、用户名、密码及数据库名即可完成握手。
PHP连接数据库服务器端的两种主流方式
使用MySQLi扩展连接MySQL数据库
MySQLi是PHP针对MySQL数据库提供的专用扩展，支持面向对象和过程化两种写法，在大多数PHP环境中，MySQLi已默认启用，你只需在连接时指定主机、用户、密码和数据库名即可，以下是一个典型操作路径：
- 创建连接对象：
new mysqli($host, $user, $password, $database) - 检查连接是否成功：通过
connect_error属性判断 - 设置字符集：
$mysqli->set_charset('utf8mb4')避免乱码 - 执行查询并处理结果
在本地开发时,主机通常填0.0.1或localhost；生产环境则填写数据库服务器的IP或域名，很多新手在PHP连接数据库服务器端配置时会忽略端口号，MySQL默认端口为3306，如果服务器使用非默认端口，需要在主机参数后加冒号指定，例如0.0.1:3307。
使用PDO扩展连接多种数据库
PDO（PHP Data Objects）提供了一个统一的数据访问接口，不仅支持MySQL，还能连接PostgreSQL、SQLite、SQL Server等，如果你需要在一个项目中切换数据库，PDO是更灵活的选择，连接时需构造数据源名称（DSN），格式类似：
- MySQL：
mysql:host=127.0.0.1;dbname=test;charset=utf8mb4 - PostgreSQL：
pgsql:host=127.0.0.1;dbname=test - SQLite：
sqlite:/path/to/database.db
PDO的异常处理机制更完善,建议将错误模式设置为PDO::ERRMODE_EXCEPTION，这样在连接失败时能直接捕获异常，便于调试。
PHP连接数据库服务器端的详细步骤
配置数据库连接信息
在开始编码前，先确认数据库服务器端的各项参数，你需要获取以下信息：
- 服务器地址：IP或域名，例如
168.1.100或db.example.com - 端口号：默认3306（MySQL），如果修改过需对应调整
- 用户名和密码：具有访问指定数据库权限的账号
- 数据库名称：要连接的具体库名
建议将这些配置单独放在一个文件中（如
config.php），避免在代码中硬编码，生产环境更要严格控制配置文件的权限，防止泄露。
编写连接代码并测试
以MySQLi为例，一个完整的连接流程如下：
- 包含配置文件,获取连接参数
- 实例化mysqli对象：
$conn = new mysqli($host, $user, $pass, $db, $port) - 检查是否连接错误：
if ($conn->connect_error) { die('连接失败: ' . $conn->connect_error); } - 设置字符集：
$conn->set_charset('utf8mb4') - 执行查询：
$result = $conn->query('SELECT FROM users') - 处理结果后关闭连接：
$conn->close()
使用PDO时,连接代码更加简洁但需要注意异常处理：
try {
$pdo = new PDO('mysql:host=127.0.0.1;dbname=test', $user, $pass);
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
} catch (PDOException $e) {
die('连接失败: ' . $e->getMessage());
}
测试连接是否成功,最简单的方式是执行一条简单的SQL语句，比如SELECT 1，看是否能返回结果，如果返回false，则说明连接或查询有问题，根据错误信息逐步排查。
PHP连接数据库服务器端的常见问题与解决方案
连接失败的原因和排查方法
连接失败是开发者最常遇到的场景，根据行业共识，大部分问题集中在以下几方面：
- 服务器地址或端口错误：检查数据库服务器是否监听在指定的IP和端口上，可以使用
telnet或ping测试连通性 - 认证信息错误：确认用户名和密码是否正确，尤其注意数据库用户是否具有远程访问权限（MySQL中
host字段需为或具体IP） - 防火墙阻止连接：云服务器或本地防火墙可能拦截了3306端口，需要添加入站规则
- PHP扩展未启用：在
php.ini中检查extension=mysqli或extension=pdo_mysql是否被注释 - 字符集不匹配：连接时未设置字符集，可能导致后续查询出现乱码或错误
当遇到“无法连接”的错误时，建议先检查错误信息中的具体错误号，比如2002
表示无法连接服务器，1045表示认证失败，1049表示数据库不存在。
确保连接安全的常见做法
数据库连接直接暴露在代码中，安全问题不容忽视，业内专家指出，以下几条措施能有效降低风险：
- 使用预处理语句（Prepared Statement）防止SQL注入，PDO和MySQLi都支持
- 限制数据库用户权限,只赋予业务所需的最小权限（如SELECT、INSERT、UPDATE、DELETE）
- 连接信息中的密码不要明文硬编码,可使用环境变量或配置文件，并设置严格的文件权限
- 如果数据库服务器和应用服务器分离,尽量使用内网IP连接，避免暴露公网端口
- 定期更换数据库密码,并检查慢查询日志和错误日志
PHP连接数据库服务器端的性能优化
使用连接池减少连接开销
每次PHP请求都创建和销毁数据库连接会消耗大量资源，在高并发场景下尤为明显，连接池技术可以复用已有连接，减少握手次数，PHP本身不内置连接池，但可以通过以下方式实现类似效果：
- 持久连接：MySQLi和PDO都支持持久连接，在连接参数前加
p:前缀，如p:127.0.0.1，但需注意，持久连接可能在长周期应用中出现连接状态不一致的问题，需谨慎使用 - 使用Swoole或Workerman：这些常驻内存的框架支持连接池，可提前创建一批连接，请求时从池中获取，用完归还
- 借助中间件：如ProxySQL、MySQL Router等，可以统一管理数据库连接，起到连接池的作用
以下几种方案各有优劣,可根据实际场景选择：
| 方案 | 优点 | 缺点 |
|---|---|---|
| 持久连接 | 实现简单，无需额外组件 | 可能产生连接泄漏，不适合高并发 |
| 应用层连接池 | 资源可控，性能提升明显 | 需要框架支持，开发成本较高 |
| 中间件代理 | 无侵入，功能全面 | 多一层网络开销，需运维维护 |
合理设置连接超时和重试机制
数据库连接不应无限等待，在PHP中可以为连接设置超时时间，MySQLi的连接超时通过`mysqli.options`设置，PDO则通过DSN中的`timeout`参数指定。
- MySQLi：
$mysqli->options(MYSQLI_OPT_CONNECT_TIMEOUT, 5) - PDO：
mysql:host=127.0.0.1;dbname=test;connect_timeout=5
当连接超时或失败时,可以实现简单的重试逻辑，但要注意避免无限重试导致服务器压力过大，通常建议重试1-2次，每次间隔1-2秒。
PHP连接数据库服务器端：从配置到调优的完整链路
开发环境 vs 生产环境的差异
在本地开发时，PHP连接数据库服务器端配置往往比较简单，直接使用root账户或统一账号，但在生产环境中，需要遵循更严格的规范：
- 使用独立的数据库用户,密码强度足够
- 开启SSL连接,防止数据在传输中被窃听
- 关闭MySQL的远程登录,只允许应用服务器IP连接
- 定期检查数据库连接数,避免超限
连接后的日常维护
建立连接只是第一步，后续的维护同样重要：
- 记录连接失败日志,便于分析问题
- 监控连接数,超过阈值时及时扩容或优化查询
- 定期更新PHP版本和数据库驱动,修复已知安全漏洞
关于PHP连接数据库服务器端的常见问题解答
PHP连接数据库时提示“Class ‘mysqli’ not found”怎么办？
这表示PHP环境中没有安装或启用MySQLi扩展，在Linux系统中，可以通过包管理器安装，sudo apt-get install php-mysql`，然后重启Web服务器，在Windows下，检查`php.ini`中`extension=mysqli`是否被移除注释，并确保`php_mysqli.dll`文件存在。
如何在不重启PHP的情况下测试数据库连接是否正常？
可以单独写一个脚本文件，只包含连接代码，然后通过命令行执行，php test_connect.php`，如果脚本正常输出“连接成功”之类的信息，说明连接配置无误，生产环境建议使用监控工具（如PHP的`mysql_ping`）定期检查连接状态。
PHP连接数据库服务器端时，用MySQLi还是PDO更好？
如果项目只使用MySQL，且需要更原生的MySQL特性（如异步查询、多语句执行），MySQLi是不错的选择；如果项目可能切换数据库系统，或者需要统一的API，PDO更合适，据统计，多数现代PHP框架（如Laravel、Symfony）默认使用PDO，因为其灵活性和可扩展性更好，最终选择取决于你的具体场景和团队习惯。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/php%e6%80%8e%e4%b9%88%e5%92%8c%e6%95%b0%e6%8d%ae%e5%ba%93%e5%bb%ba%e7%ab%8b%e8%bf%9e%e6%8e%a5%ef%bc%9f%ef%bc%8cphp%e8%bf%9e%e6%8e%a5%e6%95%b0%e6%8d%ae%e5%ba%93%e7%9a%84%e6%ad%a5%e9%aa%a4%e6%98%af/
