PHP MySQL 長連接 mysql_pconnect 深度解析與避坑指南

長連接運作前提：Apache Keep-Alive

PHP 作為 Apache 模組運行時，長連接能否生效取決於 Apache 的 Keep-Alive 設定。

Keep-Alive 原理

• 無 Keep-Alive：每次 HTTP 請求需建立/關閉 TCP 連線 (3 次交握 + 4 次揮手)
• 啟用 Keep-Alive：單一 TCP 連線處理多個 HTTP 請求，大幅降低開銷

Apache 關鍵設定 (httpd.conf)

KeepAlive On
MaxKeepAliveRequests 0    # 不限制單連線請求數
KeepAliveTimeout 15       # 保持連線秒數，關鍵參數

驗證 Keep-Alive 生效

<?php
echo "Apache 進程 PID: " . getmypid();
// 15 秒內重整頁面觀察 PID 是否變化
?>

PHP 內部長連接實現機制

mysql_pconnect 根據 Apache 進程 ID 生成 Hash Key，在進程級別的 persistent_list 中查找/儲存連線資源。

// 簡化版核心邏輯 (PHP 源碼 ext/mysql/php_mysql.c)
$user = php_get_current_user();  // 取得進程唯一標識
$hashed_details = "MySQL__${user}_";

// 在 persistent_list 中查找
if (zend_hash_find(&EG(persistent_list), $hashed_details, ...) == FAILURE) {
    // 不存在：建立新連線並存入 hash 表
    zend_hash_update(&EG(persistent_list), $hashed_details, ..., $new_le);
} else {
    // 存在：直接復用連線資源
    $mysql = $le->ptr;
}

MySQL 端關鍵參數：wait_timeout vs interactive_timeout

預設值陷阱

兩者預設均為 8 小時 (28800 秒)，極易導致連線堆積。

觀察連線狀態

<?php
$conn = mysql_pconnect("localhost", "root", "123456");
echo "MySQL Thread ID: " . mysql_thread_id($conn) . "<br>";
echo "Apache PID: " . getmypid();
?>

對照 MySQL SHOW PROCESSLIST 觀察 Command=Sleep、Time 遞增。

參數調整建議 (my.cnf)

[mysqld]
wait_timeout = 30          # 非互動式連線閒置超時
interactive_timeout = 60   # 互動式連線閒置超時

連線類型判斷

• 預設 mysql_pconnect → 非互動式 → 受 wait_timeout 控制
• mysql_pconnect(..., MYSQL_CLIENT_INTERACTIVE) → 互動式 → 受 interactive_timeout 控制

黃金平衡原則

Apache KeepAliveTimeout ≥ MySQL wait_timeout

確保 Apache 釋放連線前，MySQL 已主動清理閒置連線，避免「僵屍連線」佔用 max_connections。

實戰調優清單

現代替代方案

• PDO::ATTR_PERSISTENT：PDO 原生支援
• 連線池中介軟體：ProxySQL、MaxScale、PgBouncer
• 應用層連線池：Swoole、Workerman 長驻進程模型
• 無狀態架構：短連接 + 高效能資料庫 + 連線複用優化