Laracon US 2026

The SessionUpdateTimestampHandlerInterface interface

(PHP 7, PHP 8)

Introduction

SessionUpdateTimestampHandlerInterface is an interface which defines optional methods for creating a custom session handler. In order to pass a custom session handler to session_set_save_handler() using its OOP invocation, the class can implement this interface.

Note that the callback methods of classes implementing this interface are designed to be called internally by PHP and are not meant to be called from user-space code.

Class synopsis

interface SessionUpdateTimestampHandlerInterface {
/* Methods */
public function updateTimestamp(string $id, string $data): bool
public function validateId(string $id): bool
}

Table of Contents

add a note

User Contributed Notes 2 notes

up
0
polygon dot co dot in at gmail dot com
1 day ago
I found that the updateTimestamp has special function.

Seems this was specifically meant for updating timestamp for Cookie based session.

When we use Cookie as a mode of storage of session data we need to maintain the timestamp inside the cookie data.

Generally, when we use other modes we have timestamp details for when it was last accessed. I. case of Cookie this details is with browser as the modified data is set at that moment but not inside the cookie.

So, if we need the last accessed timestamp we can add a kay for the timestamp.

The hack is we need to use session option ['serialize_handler' => 'php_serialize'] so that unserialize add required timestamp key and re serialize it.

I think the 'php_serialize' is the only option which helps to decode the sessionData inside the Session Handler class.
up
0
Anonymous
6 years ago
There is a bit of documentation provided by Wu Xiancheng. See his comment in the SessionHandlerInterface section:
https://www.php.net/manual/en/class.sessionhandlerinterface.php#122032
To Top