Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:86893
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: pass (pb1.pair.com: domain gmail.com designates 209.85.213.42 as permitted sender)
MIME-Version: 1.0
Sender: yohgaki@gmail.com
In-Reply-To: <CAGa2bXY3x+gi3VB6X99HFtH_GbBCdsozRdU30BhA52we3a+snQ@mail.gmail.com>
References: <CAJW__o0D_DadKJCyZbMhDiEVpO-pzpWwKV5Ht=ukK1MOBCLCKg@mail.gmail.com>
 <CAGa2bXaS5Q-qMPtbg855vSVXbSinWv=HA-t26=KB4fQ1tXRUJA@mail.gmail.com>
 <CADNQb0Vc1vU=ddVD1Dfd4KQ5J7yLhOEVsak6x8mTSo9OUChhZg@mail.gmail.com> <CAGa2bXY3x+gi3VB6X99HFtH_GbBCdsozRdU30BhA52we3a+snQ@mail.gmail.com>
Date: Fri, 26 Jun 2015 12:56:18 +0900
Message-ID: <CAGa2bXYzJQpCMYJTM61a_dJ=nJbMRjks5QcnAXocXO3=1Y=s6g@mail.gmail.com>
To: Hannes Magnusson <hannes.magnusson@gmail.com>
Cc: Kalle Sommer Nielsen <kalle@php.net>, Internals <internals@lists.php.net>, Anatoliy Belsky <ab@php.net>, 
	Dmitry Stogov <Dmitry@zend.com>, Nikita Popov <nikita.ppv@gmail.com>, Ferenc Kovacs <tyra3l@gmail.com>, 
	Xinchen Hui <laruence@php.net>
Content-Type: multipart/alternative; boundary=001a113937bc44ce36051963bb52
Subject: Re: [PHP-DEV] Headsup: PHP7 feature freeze
From: yohgaki@ohgaki.net (Yasuo Ohgaki)

--001a113937bc44ce36051963bb52
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: quoted-printable

Hi Hannes,

On Fri, Jun 26, 2015 at 12:51 PM, Yasuo Ohgaki <yohgaki@ohgaki.net> wrote:

> On Fri, Jun 26, 2015 at 10:48 AM, Hannes Magnusson <
> hannes.magnusson@gmail.com> wrote:
>
>> Why do you think its undocumented?
>> http://php.net/manual/en/sessionhandler.create-sid.php
>>
>
> Rename discussion was there. And I explicitly discussed "it's undocumente=
d
> and it violates CODING_STANDARDS", but it was added recently (after the
> discussion I suppose).
>
> [yohgaki@dev session]$ svn log -r 334814
> ------------------------------------------------------------------------
> r334814 | aharvey | 2014-09-09 04:49:26 +0900 (2014=E5=B9=B409=E6=9C=8809=
=E6=97=A5 (=E7=81=AB)) | 2 lines
>
> Add documentation for SessionHandler::create_sid().
>
> ------------------------------------------------------------------------
>
> 334814    aharvey     <classname>SessionHandler</classname> is a special
> class that can be used
> 334814    aharvey     to expose the current internal PHP session save
> handler by inheritance.
> 334814    aharvey     There are seven methods which wrap the seven
> internal session save handler
> 334814    aharvey     callbacks (<parameter>open</parameter>,
> <parameter>close</parameter>,
> 334814    aharvey     <parameter>read</parameter>,
> <parameter>write</parameter>,
> 334814    aharvey     <parameter>destroy</parameter>,
> <parameter>gc</parameter> and
> 334814    aharvey     <parameter>create_sid</parameter>).  By default,
> this class will wrap
> 334814    aharvey     whatever internal save handler is set as defined by
> the
> 334814    aharvey     <link
> linkend=3D"ini.session.save-handler">session.save_handler</link>
> 334814    aharvey     configuration directive which is usually
> <parameter>files</parameter> by
> 334814    aharvey     default.  Other internal session save handlers are
> provided by PHP
> 334814    aharvey     extensions such as SQLite (as
> <parameter>sqlite</parameter>), Memcache (as
> 334814    aharvey     <parameter>memcache</parameter>), and Memcached (as
> 334814    aharvey     <parameter>memcached</parameter>).
>
> I think this should be reverted.
>

Or it may stay there.
It's just a matter of having a copy of create_sid().
I'll add documentation.

Regards,

--
Yasuo Ohgaki
yohgaki@ohgaki.net

--001a113937bc44ce36051963bb52--