解決 PHP session_start() "Failed to initialize storage module: files" 權限錯誤

錯誤現象

Fatal error: session_start(): Failed to initialize storage module: files (path: ) in /data/www/phpmyadmin/libraries/session.inc.php on line 83

或警告版本：

Warning: session_start(): SAFE MODE Restriction in effect. The script whose uid is 501 is not allowed to access /tmp owned by uid 0

核心原因分析

1. Session 儲存路徑權限不足： `php.ini` 設定 `session.save_path = "/tmp"`，但 `/tmp` 目錄擁有者為 `root (uid 0)`，PHP-FPM 進程以 `www (uid 501)` 執行，無寫入權限。
2. Safe Mode / open_basedir 限制： 舊版 PHP 或特定主機商啟用 `safe_mode` 或 `open_basedir`，限制腳本只能存取特定目錄。
3. ini_set 無效： `ini_set('session.save_path', ...)` 在 `session_start()` 前調用**有時無效**，特別是模組模式下。

解決方案 (按推薦順序)

方案一：程式碼層面指定專屬目錄 (最通用、無需 root 權限)

在 **`session_start()` 之前** 呼叫 `session_save_path()`，指向專案專屬、可寫的目錄。

<?php
// 定義專屬 session 目錄 (建議放在專案目錄下，非公開目錄)
$sessSavePath = __DIR__ . '/../storage/sessions/';

// 確保目錄存在且可寫
if (!is_dir($sessSavePath)) {
    mkdir($sessSavePath, 0777, true);
}
if (is_writable($sessSavePath)) {
    session_save_path($sessSavePath);
} else {
    die('Session 目錄不可寫: ' . $sessSavePath);
}

// 現在才啟動 session
session_start();

方案二：修改 php.ini (需重啟 PHP-FPM，需 root)

; php.ini
session.save_handler = files
session.save_path = "/var/lib/php/sessions"  ; 建議專用目錄，非 /tmp

; 確保目錄權限
; chown www:www /var/lib/php/sessions
; chmod 770 /var/lib/php/sessions

方案三：針對 phpMyAdmin 等第三方系統修改入口檔

如原文遇到的 phpMyAdmin，修改 `libraries/session.inc.php` (或較新版 `libraries/common.inc.php`)：

// 在 session_start() 之前插入
session_save_path("/data/www/session"); // 自定義可寫路徑

if (!isset($_COOKIE[$session_name])) {
    session_save_path("/data/www/session");
    $r = session_start();
    // ... 錯誤處理
} else {
    session_save_path("/data/www/session");
    session_start();
}

Linux 權限實操檢查清單

# 1. 查看 PHP-FPM 執行用戶
ps aux | grep php-fpm
# 假設為 www-data

# 2. 檢查 session 目錄權限
ls -ld /var/lib/php/sessions
# drwx-wx-wt 2 root root 4096 ... /tmp  (權限 1777, sticky bit)
# 應改為專屬目錄:
mkdir -p /var/lib/php/sessions
chown www-data:www-data /var/lib/php/sessions
chmod 770 /var/lib/php/sessions

# 3. 檢查 open_basedir (若啟用)
# php.ini 或 php-fpm pool conf
; open_basedir = /var/www/:/tmp/:/var/lib/php/sessions/
# 必須包含 session 目錄

避坑指南

• ❌ 不要用 `@ini_set('session.save_path', ...)` 抑制錯誤，這會掩蓋問題且不一定生效。
• ❌ 不要直接用系統 `/tmp`，多用戶環境下極易衝突、被清理、權限錯亂。
• ✅ 每個專案/站點使用**獨立 session 目錄**，隔離權限、便於清理、避免衝突。
• ✅ 生產環境建議改用 **Redis/Memcached** 做 Session 儲存 (`session.save_handler = redis`)，解決多伺服器共享、效能、權限問題。