cvs: phpdoc-cs /reference/http/functions setcookie.xml

From: Date: Wed, 10 Mar 2004 09:09:51 +0000
Subject: cvs: phpdoc-cs /reference/http/functions setcookie.xml
Groups: php.doc.cs 
Request: Send a blank email to doc-cs+get-117@lists.php.net to get a copy of this message
vrana Wed Mar 10 04:09:51 2004 EDT Modified files: /phpdoc-cs/reference/http/functions setcookie.xml Log: Fix of bug #27538 http://cvs.php.net/diff.php/phpdoc-cs/reference/http/functions/setcookie.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc-cs/reference/http/functions/setcookie.xml diff -u phpdoc-cs/reference/http/functions/setcookie.xml:1.1 phpdoc-cs/reference/http/functions/setcookie.xml:1.2 --- phpdoc-cs/reference/http/functions/setcookie.xml:1.1 Sun Apr 14 19:46:44 2002 +++ phpdoc-cs/reference/http/functions/setcookie.xml Wed Mar 10 04:09:50 2004 @@ -9,7 +9,7 @@ <refsect1> <title>Popis</title> <methodsynopsis> - <type>int</type><methodname>setcookie</methodname> + <type>bool</type><methodname>setcookie</methodname> <methodparam><type>string</type><parameter>name</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>value</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>expire</parameter></methodparam> @@ -18,12 +18,28 @@ <methodparam choice="opt"><type>int</type><parameter>secure</parameter></methodparam> </methodsynopsis> <para> - <function>setcookie</function> definuje cookie, který se po¹le - spolu s hlavièkami. Cookies se musí odeslat jako - <emphasis>první</emphasis> ze v¹ech HTTP hlavièek (to je omezení - cookies, ne PHP). Volání této funkce musíte tudí¾ umístit pøed - <literal>&lt;html></literal> èi <literal>&lt;head></literal> tagy. - </para> + <function>setcookie</function> definuje cookie, která se po¹le + spolu s ostatními HTTP hlavièkami. Podobnì jako ostatní hlavièky, cookies + se musí odeslat <emphasis>pøed</emphasis> jakýmkoliv výstupem va¹eho + skriptu (jedná se o omezení protokolu). Je tedy tøeba, abyste + v¹echna volání této funkce umístili pøed jakýkoliv výstup, vèetnì + znaèek <literal>&lt;html&gt;</literal> a <literal>&lt;head&gt;</literal> + a také pøed jakékoliv bílé znaky. Kdy¾ je pøi volání této funkce u¾ nìco + na výstupu, <function>setcookie</function> neuspìje a vrátí &false;. + Kdy¾ <function>setcookie</function> probìhne v poøádku, vrátí + &true;. To v¹ak neøíká nic o tom, zda byla cookie pøijata klientem. + </para> + <note> + <para> + V PHP 4 lze k poslání výstupu pøed voláním této funkce + pou¾ít <link linkend="ref.outcontrol">output buffering</link>, + ov¹em s tou re¾ií, ¾e v¹echen výstup pro prohlí¾eè + bude pozdr¾en na serveru, dokud ho nepo¹lete. Lze to zaøídit voláním funkcí + <function>ob_start</function> a <function>ob_end_flush</function> + nebo nastavením konfiguraèní direktivy <literal>output_buffering</literal> + v &php.ini; nebo konfiguraèních souborech serveru. + </para> + </note> <para> V¹echny argumenty kromì argumentu <parameter>name</parameter> jsou nepovinné. Pokud je pøítomný pouze argument @@ -36,7 +52,7 @@ <parameter>expire</parameter> je bì¾né Unixové celoèíselné vyjádøení èasu, jak je vrací funkce <function>time</function> èi <function>mktime</function>. Argument <parameter>secure</parameter> - indikuje, ¾e by se tento cookie mìl pøená¹et pouze po zabezpeèeném + indikuje, ¾e by se tato cookie mìla pøená¹et pouze po zabezpeèeném HTTPS spojení. </para> <para>

« previous php.doc.cs (#117) next »