使用 pconnect() 可以建立 mysql 持久连接，该连接在脚本执行结束后不会立即关闭，而是保留在连接池中供后续请求复用。具体做法是将 new mysqli 替换为 mysqli::pconnect 或调用 $mysqli->pconnect()，并传入相同的服务器、用户名、密码和数据库名参数。这样做能显著减少频繁创建 tcp 握手和认证带来的开销，但需注意连接池大小限制及潜在的资源占用问题。
如何正确调用 pconnect 函数
直接调用 mysqli::pconnect() 即可实现持久化，其参数签名与标准连接方法一致。开发者只需确保每次调用时使用的连接标识（主机、用户、密码）完全相同，MySQL 服务端才能识别并复用已有的连接。若参数稍有差异，系统将视为新连接并尝试建立新的会话。
<?php
$host = 'localhost';
$user = 'root';
$pass = 'password';
$db = 'test_db';
// 使用 pconnect 建立持久连接
$mysqli = new mysqli();
$mysqli->pconnect($host, $user, $pass, $db);
if ($mysqli->connect_error) {
die('Connect Error: ' . $mysqli->connect_error);
}
echo 'Persistent connection established successfully.';
// 模拟业务逻辑
$result = $mysqli->query('SELECT 1');
var_dump($result->fetch_assoc());
// 脚本结束，连接不关闭，进入空闲状态等待复用
?>
运行上述代码后，预期输出为：Persistent connection established successfully.array(1) { ["1"]=> string(1) "1" }
验证方式：在 Linux 系统中执行 netstat -an | grep 3306，可以看到处于 TIME_WAIT 或 ESTABLISHED 状态的连接数多于实际并发请求数，表明连接被保留。注意，PHP-FPM 或 Apache 等 Web 服务器的进程管理策略会影响持久连接的实际效果，若 Worker 进程被回收，连接也会随之断开。
立即学习“PHP免费学习笔记（深入）”；
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录，或需要将该能力封装成可公开复用的 Codex skill。
pconnect 与常规 connect 的行为差异是什么
pconnect 与常规 connect 的核心区别在于连接的生命周期管理。常规连接在脚本执行完毕或对象销毁时立即释放，而 pconnect 会将连接标记为“持久”，由 MySQL 服务端维护其存活状态。这种机制避免了重复的 TCP 三次握手和 MySQL 身份验证过程，提升了高并发场景下的响应速度。然而，持久连接可能导致连接数累积，若未合理配置 max_connections，可能引发资源耗尽。
<?php
// 对比测试：常规连接 vs 持久连接
function test_normal_connect() {
$start = microtime(true);
$conn = new mysqli('localhost', 'root', 'password', 'test_db');
$conn->close(); // 显式关闭
return microtime(true) - $start;
}
function test_persistent_connect() {
$start = microtime(true);
$conn = new mysqli();
$conn->pconnect('localhost', 'root', 'password', 'test_db');
$conn->close(); // 仅标记为可复用，不真正关闭
return microtime(true) - $start;
}
// 执行多次以观察平均耗时
$normal_times = [];
$persistent_times = [];
for ($i = 0; $i < 5; $i++) {
$normal_times[] = test_normal_connect();
$persistent_times[] = test_persistent_connect();
}
echo 'Normal avg: ' . array_sum($normal_times)/count($normal_times) . "s\n";
echo 'Persistent avg: ' . array_sum($persistent_times)/count($persistent_times) . "s\n";
?>
运行结果示例：Normal avg: 0.0025sPersistent avg: 0.0008s
从结果可见，持久连接因跳过握手和认证阶段，单次操作耗时更低。但需注意，pconnect 并非绝对更快，在网络延迟低或连接已复用的情况下，差异可能微乎其微。此外，持久连接会占用 MySQL 的线程资源，需监控 SHOW PROCESSLIST 中的空闲连接数，避免超过 max_user_connections 限制。
当多个请求同时复用同一持久连接时会发生什么
当多个 PHP 请求同时尝试复用同一个持久连接时，MySQL 服务端会根据连接状态决定是分配现有连接还是创建新连接。若连接处于空闲状态且未被其他会话修改，它会被直接分配给下一个请求；若连接已被修改（如事务未提交），则可能触发错误或创建新连接。这种行为取决于 MySQL 的 interactive_timeout 和 wait_timeout 设置，以及 PHP 扩展的实现细节。开发者应避免在持久连接上执行长时间运行的事务，以防阻塞其他请求。
