Bug #77248 [NEW]: SessionUpdateTimestampHandlerInterface is not documented

From: Date: Thu, 06 Dec 2018 08:45:44 +0000
Subject: Bug #77248 [NEW]: SessionUpdateTimestampHandlerInterface is not documented
Groups: php.doc.bugs 
Request: Send a blank email to doc-bugs+get-16198@lists.php.net to get a copy of this message
From:             mumu at seznam dot cz
Operating system: 
PHP version:      7.2.12
Package:          Documentation problem
Bug Type:         Bug
Bug description:SessionUpdateTimestampHandlerInterface is not documented

Description:
------------
There is no description of SessionUpdateTimestampHandlerInterface
(introduced in PHP 7.0.0) and its respective non-oop
session-set-save-handler arguments in the docs.

http://php.net/manual/en/class.sessionupdatetimestamphandlerinterface.php
and 
http://php.net/manual/en/function.session-set-save-handler.php

For the context of the updateTimestamp() function I would like to see
- What is the difference between SessionHandlerInterface::write and
SessionUpdateTimestampHandlerInterface::updateTimestamp functions?
- How should differ the code implementing these two functions?
- How is the code supposed to update a timestamp if there is no
timestamp provided to the function?

Expected result:
----------------
The above is properly documented and the documentation explains the
context and difference between similarly looking constructs and
functions.

Actual result:
--------------
There is no documentation.

-- 
Edit bug report at https://bugs.php.net/bug.php?id=77248&edit=1
-- 
Try a snapshot (PHP 5.4):   https://bugs.php.net/fix.php?id=77248&r=trysnapshot54
Try a snapshot (PHP 5.5):   https://bugs.php.net/fix.php?id=77248&r=trysnapshot55
Try a snapshot (trunk):     https://bugs.php.net/fix.php?id=77248&r=trysnapshottrunk
Fixed in SVN:               https://bugs.php.net/fix.php?id=77248&r=fixed
Fixed in release:           https://bugs.php.net/fix.php?id=77248&r=alreadyfixed
Need backtrace:             https://bugs.php.net/fix.php?id=77248&r=needtrace
Need Reproduce Script:      https://bugs.php.net/fix.php?id=77248&r=needscript
Try newer version:          https://bugs.php.net/fix.php?id=77248&r=oldversion
Not developer issue:        https://bugs.php.net/fix.php?id=77248&r=support
Expected behavior:          https://bugs.php.net/fix.php?id=77248&r=notwrong
Not enough info:            https://bugs.php.net/fix.php?id=77248&r=notenoughinfo
Submitted twice:            https://bugs.php.net/fix.php?id=77248&r=submittedtwice
register_globals:           https://bugs.php.net/fix.php?id=77248&r=globals
PHP 4 support discontinued: https://bugs.php.net/fix.php?id=77248&r=php4
Daylight Savings:           https://bugs.php.net/fix.php?id=77248&r=dst
IIS Stability:              https://bugs.php.net/fix.php?id=77248&r=isapi
Install GNU Sed:            https://bugs.php.net/fix.php?id=77248&r=gnused
Floating point limitations: https://bugs.php.net/fix.php?id=77248&r=float
No Zend Extensions:         https://bugs.php.net/fix.php?id=77248&r=nozend
MySQL Configuration Error:  https://bugs.php.net/fix.php?id=77248&r=mysqlcfg



Thread (3 messages)

« previous php.doc.bugs (#16198) next »