svn: /phpdoc/en/trunk/reference/network/functions/ setcookie.xml
| From: | Adam Harvey | 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>