在php中使用pdo连接mysql时，设置`pdo::attr_persistent`为true可以启用持久连接。具体做法是在实例化`pdo`对象时，将第四个参数`options`数组中的该属性设为`true`，这样数据库连接会在脚本执行结束后保持打开状态，供后续请求复用，从而减少频繁建立连接的开销。
如何正确配置PDO的持久连接选项
要启用持久连接，必须在创建PDO实例时通过$options参数显式指定。默认情况下，PDO使用临时连接，脚本结束即断开。设置`PDO::ATTR_PERSISTENT => true`后，PHP会尝试从连接池中获取已有连接或创建新连接并保留在池中。需要注意的是，如果连接池已满或服务器限制，可能仍会创建新连接。此外，持久连接可能导致事务未提交或锁资源长期占用，需确保代码逻辑正确处理连接状态。
<?php
$host = '127.0.0.1';
$dbname = 'test_db';
$username = 'root';
$password = '';
try {
$dsn = "mysql:host=$host;dbname=$dbname;charset=utf8mb4";
$options = [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
PDO::ATTR_EMULATE_PREPARES => false,
PDO::ATTR_PERSISTENT => true, // 启用持久连接
];
$pdo = new PDO($dsn, $username, $password, $options);
echo "Connected successfully with persistent connection.";
} catch (PDOException $e) {
die("Connection failed: " . $e->getMessage());
}
?>
上述代码中，`$options`数组包含了关键配置。`PDO::ATTR_PERSISTENT`设为`true`是核心。其他选项如错误模式设为异常、禁用模拟预处理等，也是良好实践。运行此代码后，若成功，将输出成功消息。实际连接行为取决于PHP-FPM或Web服务器的配置以及MySQL的`max_connections`设置。建议在生产环境中监控连接数，避免耗尽资源。
立即学习“PHP免费学习笔记（深入）”；
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录，或需要将该能力封装成可公开复用的 Codex skill。
持久连接与非持久连接的行为差异对比
非持久连接（默认）在每次请求开始时新建连接，结束时立即关闭。持久连接则复用现有连接。主要差异体现在性能、资源管理和状态保持上。非持久连接每次都有握手开销，但连接干净，无残留状态。持久连接节省握手时间，但可能携带上次请求的状态（如未提交的事务、会话变量），需谨慎处理。此外，持久连接在负载均衡或多进程环境下可能表现不同，需测试验证。
<?php
// 非持久连接示例
$pdo_temp = new PDO('mysql:host=127.0.0.1;dbname=test_db', 'root', '', [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
]);
echo "Temporary connection created and will close after script.";
unset($pdo_temp); // 显式销毁，但通常脚本结束自动关闭
// 持久连接示例
$pdo_persist = new PDO('mysql:host=127.0.0.1;dbname=test_db', 'root', '', [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_PERSISTENT => true,
]);
echo "Persistent connection created and may be reused.";
unset($pdo_persist); // 连接可能保留在池中，不立即关闭
?>
比较两段代码，唯一区别是`PDO::ATTR_PERSISTENT`的值。第一段代码创建临时连接，脚本结束或变量销毁后连接关闭。第二段代码创建持久连接，即使变量销毁，连接也可能被PHP内部连接池保留。在实际应用中，可通过查看MySQL的`SHOW PROCESSLIST`命令观察连接是否持续存在。注意，持久连接不适用于需要严格隔离状态的场景，如长时间运行的批处理任务或涉及敏感数据且需确保连接完全重置的情况。务必在部署前进行充分测试，评估其对应用稳定性和资源使用的影响。
当PDO连接失败时，如何排查持久连接相关的问题
如果启用持久连接后出现连接问题，如“Too many connections”错误或连接不稳定，应检查MySQL的最大连接数限制和PHP的连接池管理。常见原因包括：MySQL `max_connections` 设置过小，导致连接池满；未正确提交或回滚事务，导致锁资源累积；或者Web服务器（如Apache mod_php）与PHP-FPM对持久连接的处理方式不同。排查步骤包括：检查MySQL错误日志、监控活跃连接数、确认代码中是否正确关闭事务、以及考虑在非高并发场景下暂时禁用持久连接以验证是否为根本原因。
