SessionHandler::destroy 和session_destroy 有什麼區別？哪個更適合銷毀會話？

gitbox 2025-09-09

在PHP 中，處理會話（Session）的生命週期是一個常見的操作，尤其是在需要保存用戶狀態或在多個頁面之間共享數據時。 PHP 提供了兩種方法來銷毀會話： SessionHandler::destroy()和session_destroy() 。雖然它們的名字相似，但在使用上有一些關鍵的區別。本文將詳細解釋這兩者的區別，並幫助你選擇最合適的方式來銷毀會話。

session_destroy()方法

session_destroy()是PHP 內置的函數，用於銷毀當前會話。這個函數會清除與當前會話相關的所有數據，並刪除會話的$_SESSION數組。注意， session_destroy()只是標記會話為已銷毀，它並不會立即刪除會話的所有數據，直到下一次頁面加載時才會實際清除數據。

工作原理：

session_destroy()會刪除服務器上保存會話數據的文件或數據庫中的記錄。
它不會刪除$_SESSION數組中的數據。實際上， $_SESSION數組在會話銷毀後依然存在，只是它不再存儲有效的數據。
必須調用session_start()來初始化會話，否則無法正常調用session_destroy() 。

示例代碼：

 <span><span><span class="hljs-title function_ invoke__">session_start</span></span><span>(); </span><span><span class="hljs-comment">// 啟動會話</span></span><span>
</span><span><span class="hljs-comment">// 設置會話變量</span></span><span>
</span><span><span class="hljs-variable">$_SESSION</span></span><span>[</span><span><span class="hljs-string">'user'</span></span><span>] = </span><span><span class="hljs-string">'John Doe'</span></span><span>;

</span><span><span class="hljs-comment">// 銷毀會話</span></span><span>
</span><span><span class="hljs-title function_ invoke__">session_destroy</span></span><span>();
</span></span>

SessionHandler::destroy()方法

SessionHandler::destroy()是在自定義會話處理器（Session Handler）中使用的一個方法。當你需要控制會話的存儲方式（如存儲在數據庫中，而不是PHP 的默認文件存儲方式）時，你可能會實現一個自定義的SessionHandler類。在這種情況下， SessionHandler::destroy()會銷毀會話數據並觸發相應的清理操作。

SessionHandler是session_set_save_handler()函數的一部分，它允許開發者自定義會話存儲的方式。通過實現SessionHandler接口中的destroy()方法，開發者可以定義會話銷毀的具體操作。

工作原理：

SessionHandler::destroy()會調用自定義的銷毀操作，確保會話數據從自定義存儲系統中被清除。
需要使用session_set_save_handler()設置自定義會話處理器。
它的作用是銷毀與會話ID 相關的所有數據，通常在數據庫或其他存儲媒介中。

示例代碼：

 <span><span><span class="hljs-class"><span class="hljs-keyword">class</span></span></span><span> </span><span><span class="hljs-title">MySessionHandler</span></span><span> </span><span><span class="hljs-keyword">extends</span></span><span> </span><span><span class="hljs-title">SessionHandler</span></span><span> {
    </span><span><span class="hljs-keyword">public</span></span><span> </span><span><span class="hljs-function"><span class="hljs-keyword">function</span></span></span><span> </span><span><span class="hljs-title">destroy</span></span><span>(</span><span><span class="hljs-params"><span class="hljs-variable">$session_id</span></span></span><span>) {
        </span><span><span class="hljs-comment">// 自定义銷毀會話数据的操作，例如從數據庫中刪除</span></span><span>
        </span><span><span class="hljs-comment">// 例如：刪除數據庫中的會話記錄</span></span><span>
        </span><span><span class="hljs-variable">$db</span></span><span> = </span><span><span class="hljs-keyword">new</span></span><span> </span><span><span class="hljs-title function_ invoke__">mysqli</span></span><span>(</span><span><span class="hljs-string">"localhost"</span></span><span>, </span><span><span class="hljs-string">"user"</span></span><span>, </span><span><span class="hljs-string">"password"</span></span><span>, </span><span><span class="hljs-string">"database"</span></span><span>);
        </span><span><span class="hljs-variable">$db</span></span><span>-&gt;</span><span><span class="hljs-title function_ invoke__">query</span></span><span>(</span><span><span class="hljs-string">"DELETE FROM sessions WHERE session_id = '<span class="hljs-subst">$session_id</span></span></span><span>'");
        
        </span><span><span class="hljs-comment">// 调用父类的方法以銷毀會話</span></span><span>
        </span><span><span class="hljs-keyword">return</span></span><span> </span><span><span class="hljs-built_in">parent</span></span><span>::</span><span><span class="hljs-title function_ invoke__">destroy</span></span><span>(</span><span><span class="hljs-variable">$session_id</span></span><span>);
    }
}

</span><span><span class="hljs-comment">// 設置自定義會話處理器</span></span><span>
</span><span><span class="hljs-title function_ invoke__">session_set_save_handler</span></span><span>(</span><span><span class="hljs-keyword">new</span></span><span> </span><span><span class="hljs-title class_">MySessionHandler</span></span><span>(), </span><span><span class="hljs-literal">true</span></span><span>);
</span><span><span class="hljs-title function_ invoke__">session_start</span></span><span>(); </span><span><span class="hljs-comment">// 啟動會話</span></span><span>

</span><span><span class="hljs-comment">// 設置會話數據</span></span><span>
</span><span><span class="hljs-variable">$_SESSION</span></span><span>[</span><span><span class="hljs-string">'user'</span></span><span>] = </span><span><span class="hljs-string">'Jane Doe'</span></span><span>;

</span><span><span class="hljs-comment">// 銷毀會話</span></span><span>
</span><span><span class="hljs-title function_ invoke__">session_destroy</span></span><span>();
</span></span>

主要區別

使用場景：
- session_destroy()是PHP 的內置函數，適用於普通會話的銷毀，尤其是在沒有使用自定義會話存儲時。
- SessionHandler::destroy()適用於自定義會話存儲的場景，它允許開發者通過實現自定義的會話處理邏輯來銷毀會話。
操作範圍：
- session_destroy()僅銷毀會話數據，但不會刪除$_SESSION數組中的數據。這意味著會話的數據在當前請求中仍然存在，直到頁面刷新。
- SessionHandler::destroy()會完全銷毀會話數據，通常在調用該方法時，數據會從自定義存儲中被刪除。
靈活性：
- session_destroy()是較為簡便的方式，適用於大多數情況。
- SessionHandler::destroy()提供了更高的靈活性和可擴展性，適用於需要自定義存儲和銷毀操作的複雜應用場景。

哪個更適合銷毀會話？

如果你使用的是PHP 默認的會話存儲機制（如文件存儲），並且僅需要銷毀當前會話，那麼使用session_destroy()是最簡單和最直接的方法。
如果你使用的是自定義的會話存儲（如存儲在數據庫中），並希望完全控制銷毀會話的方式，那麼SessionHandler::destroy()更為合適。

總的來說， session_destroy()適合大多數常規應用場景，而SessionHandler::destroy()更適用於需要高度定制的場合。選擇哪個方法取決於你如何存儲會話數據及其生命週期管理。