PHP session_start() 失敗：open() No such file or directory 根因與多環境修復指南

執行 `session_start()` 出現 Warning: session_start(): open(/tmp/sess_xxx, O_RDWR) failed: No such file or directory，核心原因是 **Session 儲存目錄不存在或不可寫**。本文提供 Windows/Linux/共享主機/容器四大環境的精準修復方案與預防配置。

錯誤訊號解讀

Warning: session_start(): open(/tmp/sess_84cb589ea249708b09c3d5e6836fdd0d, O_RDWR) failed: No such file or directory (2)
# 路徑 /tmp/sess_... 來自 php.ini: session.save_path = "/tmp"
# 錯誤碼 2 = ENOENT (目錄/檔案不存在)

四大環境修復方案

1. Linux VPS / 專用伺服器 (Root 權限)

# 方案 A：建立標準目錄並授權 (推薦)
mkdir -p /var/lib/php/sessions
chown www-data:www-data /var/lib/php/sessions  # PHP-FPM 執行用戶
chmod 1733 /var/lib/php/sessions              # sticky bit 防刪除

# 修改 php.ini
session.save_path = "/var/lib/php/sessions"

# 方案 B：若堅持用 /tmp，確保存在且權限正確
mkdir -p /tmp
chmod 1777 /tmp
# systemd-tmpfiles 可能定期清理，建議改用方案 A

2. 共享虛擬主機 (無 Root、無 php.ini 權限)

<?php
// 在 session_start() 之前呼叫 (必須在任何輸出前)
ini_set('session.save_path', __DIR__ . '/sessions'); // 當前目錄下建立 sessions/

// 確保目錄存在且可寫
$savePath = ini_get('session.save_path');
if (!is_dir($savePath)) {
    mkdir($savePath, 0700, true);
}
session_start();
?>

> ⚠️ 目錄需在 `public_html` **外層** 或設定 `.htaccess` 拒絕 Web 存取： > `Deny from all`

3. Windows (XAMPP / WAMP / IIS)

; php.ini 修改為絕對路徑 (使用正斜線)
session.save_path = "C:/xampp/tmp/sessions"
; 或
session.save_path = "D:/php_sessions"

; 確保目錄存在
; 執行 cmd: mkdir C:\xampp\tmp\sessions

> IIS 需額外授權 `IUSR`、`IIS_IUSRS` 對目錄 **修改** 權限。

4. Docker 容器

# Dockerfile
RUN mkdir -p /var/lib/php/sessions \
    && chown www-data:www-data /var/lib/php/sessions \
    && chmod 1733 /var/lib/php/sessions

# php.ini (或透過環境變數 PHP_INI_SCAN_DIR 注入)
session.save_path = "/var/lib/php/sessions"

# docker-compose.yml (掛載持久化)
services:
  php:
    volumes:
      - php_sessions:/var/lib/php/sessions

volumes:
  php_sessions:

進階配置：Redis / Memcached 分散式 Session

# 安裝擴充
pecl install redis
# php.ini
session.save_handler = redis
session.save_path = "tcp://127.0.0.1:6379?auth=password&database=0"
# 多節點高可用
session.save_path = "tcp://redis1:6379?weight=1, tcp://redis2:6379?weight=1"

# 或 Memcached
session.save_handler = memcached
session.save_path = "127.0.0.1:11211"

> 優點：多伺服器負載均衡自動共享 Session、重啟不丟失、效能極高。

常見誤區與檢查清單

誤區	正確做法
以為是 Session ID 錯誤	實際是儲存目錄權限/存在性問題
直接 chmod 777 /tmp	安全風險極高，應建立專屬目錄設 1733
修改 php.ini 後未重啟服務	PHP-FPM/Apache 必須 reload 生效
共享主機用相對路徑	必須用 `__DIR__` 絕對路徑，避免 CWD 變更導致路徑錯誤
忽略 GC 機制	設定 `session.gc_probability=1`, `session.gc_divisor=100`, `session.gc_maxlifetime=1440`

驗證腳本

<?php
// test_session.php
ini_set('display_errors', 1);
error_reporting(E_ALL);

$savePath = ini_get('session.save_path');
echo "Save Path: $savePath\n";
echo "Writable: " . (is_writable($savePath) ? 'Yes' : 'No') . "\n";

session_start();
$_SESSION['test'] = time();
echo "Session ID: " . session_id() . "\n";
echo "Test Value: " . $_SESSION['test'] . "\n";

// 刷新頁面應看到 Test Value 不變
?>

精準定位 `session.save_path` 目錄權限問題，根據環境選擇檔案系统/Redis/Memcached 儲存器，能徹底消除 `session_start()` 失敗隱患。