SessionHandler::gc

(PHP 5 >= 5.4.0, PHP 7, PHP 8)

SessionHandler::gc — 清除舊的工作階段

public SessionHandler::gc(int $max_lifetime): int|false

清除過期的 session。當 session 啟動或呼叫 session_start() 時，PHP 內部會隨機呼叫此函式。呼叫頻率取決於 session.gc_divisor 和 session.gc_probability 設定指示。

此方法包裝了在設定此處理器之前的 session.save_handler ini 設定中定義的內部 PHP 儲存處理器，該設定是透過 session_set_save_handler() 設定的。

如果此類別是透過繼承擴展的，呼叫父類別的 gc 方法將會呼叫此方法的包裝器，進而呼叫關聯的內部回呼函式。這允許覆寫或攔截及過濾此方法。

有關此方法預期功能的更多資訊，請參閱 SessionHandlerInterface::gc() 的文件。

成功時返回已刪除的 session 數量，失敗時返回 false。請注意，此值會在內部返回給 PHP 進行處理。

版本	說明
7.1.0	在此版本之前，函式在成功時返回 `true`。

此頁面沒有使用者提供的註記。