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

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>