philip Wed May 28 12:10:11 2003 EDT
Modified files:
/phpdoc/en/reference/http/functions setcookie.xml
Log:
Clarify expires parameter, link to RFC2965, and see alsos. Closes bug #23835
Index: phpdoc/en/reference/http/functions/setcookie.xml
diff -u phpdoc/en/reference/http/functions/setcookie.xml:1.21
phpdoc/en/reference/http/functions/setcookie.xml:1.22
--- phpdoc/en/reference/http/functions/setcookie.xml:1.21 Tue Feb 18 06:27:40
2003
+++ phpdoc/en/reference/http/functions/setcookie.xml Wed May 28 12:10:11 2003
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.21 $ -->
+<!-- $Revision: 1.22 $ -->
<!-- splitted from ./en/functions/http.xml, last change in rev 1.2 -->
<refentry id="function.setcookie">
<refnamediv>
@@ -48,8 +48,10 @@
be skipped with an empty string, use a zero (<emphasis>0</emphasis>)
instead. The following table explains each parameter of the
<function>setcookie</function> function, be sure to read the
- <ulink url="&spec.cookies;">Netscape cookie specification</ulink>
- for specifics.
+ <ulink url="&spec.cookies;">Netscape cookie specification</ulink> for
+ specifics on how each <function>setcookie</function> parameter works
+ and <ulink url="&url.rfc;2965">RFC 2965</ulink> for additional
+ information on how HTTP cookies work.
</para>
<para>
<table>
@@ -295,7 +297,14 @@
<para>
For more information on cookies, see Netscape's cookie
specification at <ulink
- url="&spec.cookies;">&spec.cookies;</ulink>.
+ url="&spec.cookies;">&spec.cookies;</ulink> and
+ <ulink url="&url.rfc;2965">RFC 2965</ulink>.
+ </para>
+ <para>
+ You may notice the <parameter>expire</parameter> parameter takes on a
+ unix timestamp, as opposed to the date format <literal>Wdy, DD-Mon-YYYY
+ HH:MM:SS GMT</literal>, this is because PHP does this conversion
+ internally.
</para>
<simpara>
Microsoft Internet Explorer 4 with Service Pack 1 applied does
@@ -307,6 +316,10 @@
appear to handle cookies incorrectly when the path and time
are not set.
</simpara>
+ <para>
+ See also <function>header</function> and the
+ <link linkend="features.cookies">cookies section</link>.
+ </para>
</refsect1>
</refentry>
--
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
