svn: /phpdoc/en/trunk/reference/network/functions/ setcookie.xml

From: Date: Fri, 24 Sep 2010 04:06:05 +0000
Subject: svn: /phpdoc/en/trunk/reference/network/functions/ setcookie.xml
Groups: php.doc.cvs 
Request: Send a blank email to doc-cvs+get-7159@lists.php.net to get a copy of this message
aharvey Fri, 24 Sep 2010 04:06:05 +0000 Revision: http://svn.php.net/viewvc?view=revision&revision=303739 Log: Fix doc bug #52916 (Reference to old RFC version) by removing the references to the Netscape cookie spec in the parameters section and adding a little more detail to the domain parameter description on how that parameter should be structured and is matched. Bug: http://bugs.php.net/52916 (Assigned) Reference to old RFC version Changed paths: U phpdoc/en/trunk/reference/network/functions/setcookie.xml Modified: phpdoc/en/trunk/reference/network/functions/setcookie.xml =================================================================== --- phpdoc/en/trunk/reference/network/functions/setcookie.xml 2010-09-23 22:27:27 UTC (rev 303738) +++ phpdoc/en/trunk/reference/network/functions/setcookie.xml 2010-09-24 04:06:05 UTC (rev 303739) @@ -48,8 +48,9 @@ instead. </para> <para> - See <link xlink:href="&spec.cookies;"><literal>Netscape cookie specification</literal></link> for - specifics on how each <function>setcookie</function> parameter works + <link xlink:href="&url.rfc;2109">RFC 2109</link> provides the normative + reference on how each <function>setcookie</function> parameter is + interpreted. <variablelist> <varlistentry> <term><parameter>name</parameter></term> @@ -63,9 +64,9 @@ <term><parameter>value</parameter></term> <listitem> <para> - The value of the cookie. This value is stored on the clients - computer; do not store sensitive information. - Assuming the <parameter>name</parameter> is 'cookiename', this + The value of the cookie. This value is stored on the clients computer; + do not store sensitive information. Assuming the + <parameter>name</parameter> is <literal>'cookiename'</literal>, this value is retrieved through <varname>$_COOKIE['cookiename']</varname> </para> </listitem> @@ -118,14 +119,15 @@ <term><parameter>domain</parameter></term> <listitem> <para> - The domain that the cookie is available. - To make the cookie available on all subdomains of example.com - then you'd set it to <literal>'.example.com'</literal>. The - <literal>.</literal> is not required but makes it compatible - with more browsers. Setting it to <literal>www.example.com</literal> - will make the cookie only available in the <literal>www</literal> - subdomain. Refer to tail matching in the - <link xlink:href="&spec.cookies;">spec</link> for details. + The domain that the cookie is available to. To make the cookie + available on all subdomains of example.com (including example.com + itself) then you'd set it to <literal>'.example.com'</literal>. + Although some browsers will accept cookies without the initial + <literal>.</literal>, <link xlink:href="&url.rfc;2109">RFC 2109</link> + requires it to be included. Setting the domain to + <literal>'www.example.com'</literal> or + <literal>'.www.example.com'</literal> will make the cookie only + available in the <literal>www</literal> subdomain. </para> </listitem> </varlistentry> @@ -370,6 +372,7 @@ <member><function>header</function></member> <member><function>setrawcookie</function></member> <member><link linkend="features.cookies">cookies section</link></member> + <member><link xlink:href="&spec.cookies;">Original Netscape cookie specification</link></member> <member><link xlink:href="&url.rfc;2109">RFC 2109</link></member> <member><link xlink:href="&url.rfc;2965">RFC 2965</link></member> </simplelist>

« previous php.doc.cvs (#7159) next »