phpMyAdmin 預設 **1440 秒(24 分鐘)無操作自動登出**,頻繁重新登入嚴重影響開發效率。修改 `php.ini` 的 `session.gc_maxlifetime` 往往無效,因為 phpMyAdmin 有獨立的 Cookie 有效期配置。
phpMyAdmin 使用兩層超時機制:
關鍵約束:`LoginCookieValidity` **不得大於** `session.gc_maxlifetime`,否則 phpMyAdmin 會報錯並以較小值為準。
; php.ini
; 必須 >= LoginCookieValidity
session.gc_maxlifetime = 36000
; 建議同步調整的相關參數
session.cookie_lifetime = 36000 ; 瀏覽器端 Session Cookie 壽命(秒),0=瀏覽器關閉失效
session.gc_probability = 1
session.gc_divisor = 1000 ; 0.1% 機率觸發 GC,減少效能衝擊
session.save_handler = files ; 或 memcached/redis (分散式環境)
session.save_path = "/var/lib/php/sessions" ; 確保目錄可寫、權限正確
# PHP-FPM
sudo systemctl reload php8.2-fpm
# Apache
sudo systemctl reload apache2
# Nginx (若使用 PHP-FPM 無需重啟 Nginx)
# 僅需重啟 PHP-FPM
<?php
// 建立驗證腳本 test_session.php 放在 phpMyAdmin 目錄下
session_start();
echo "session.gc_maxlifetime: " . ini_get('session.gc_maxlifetime') . "
";
echo "session.cookie_lifetime: " . ini_get('session.cookie_lifetime') . "
";
echo "LoginCookieValidity (需引入 phpMyAdmin 配置): ";
// 引入 phpMyAdmin 配置讀取
require_once 'libraries/config.default.php';
echo $cfg['LoginCookieValidity'] . "
";
echo "當前 Session ID: " . session_id() . "
";
echo "Session 剩餘時間: " . (ini_get('session.gc_maxlifetime') - (time() - $_SERVER['REQUEST_TIME'])) . " 秒";
?>
<?php
// config.inc.php 中動態設定
if (isset($_SESSION['user_role']) && $_SESSION['user_role'] === 'admin') {
// 管理員:8 小時
$cfg['LoginCookieValidity'] = 28800;
} else {
// 一般用戶:2 小時
$cfg['LoginCookieValidity'] = 7200;
}
// 確保不超過 PHP 設定
$maxAllowed = (int)ini_get('session.gc_maxlifetime');
if ($cfg['LoginCookieValidity'] > $maxAllowed) {
$cfg['LoginCookieValidity'] = $maxAllowed;
}
?>
| 誤區 | 正確認知 |
|---|---|
| 只改 php.ini 的 session.gc_maxlifetime | 無效,phpMyAdmin 以 LoginCookieValidity 為準,且受限於 gc_maxlifetime |
| 設定極大值 (如 8640000) | 超過 gc_maxlifetime 會報錯並降級;且安全風險高 |
| 以為修改 config.default.php 即可 | 更新 phpMyAdmin 會覆蓋,應修改 config.inc.php |
| 忽略 session.cookie_lifetime | 若為 0,關閉瀏覽器即失效,與 LoginCookieValidity 無關 |
| 多台伺服器未共享 Session | 需配置 session.save_handler = memcached/redis |
解決 phpMyAdmin 逾時的**正確姿勢**:
config.inc.php 設定 $cfg['LoginCookieValidity']php.ini 的 session.gc_maxlifetime 為**相同或更大值**