cvs: phpdoc-nl /reference/http/functions header.xml headers-sent.xml setcookie.xml

Index: phpdoc-nl/reference/http/functions/setcookie.xml
diff -u phpdoc-nl/reference/http/functions/setcookie.xml:1.4 phpdoc-nl/reference/http/functions/setcookie.xml:1.5
--- phpdoc-nl/reference/http/functions/setcookie.xml:1.4	Wed Aug 14 07:17:47 2002
+++ phpdoc-nl/reference/http/functions/setcookie.xml	Fri Jan 10 16:13:45 2003
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- EN-Revision: 1.4 Maintainer: manuzhai Status: ready -->
+<!-- EN-Revision: 1.12 Maintainer: manuzhai Status: ready -->
   <refentry id="function.setcookie">
    <refnamediv>
     <refname>setcookie</refname>
@@ -18,15 +18,15 @@
      </methodsynopsis>
     <para>
      <function>setcookie</function> defineert een cookie dat wordt meegezonden
-     met de rest van de header informatie. Cookies moeten worden verzonden
-     <emphasis>voordat</emphasis> enige andere headers worden verzonden (dit
-     is een restrictie van cookies, niet van PHP). Daarom moet je deze functie
-     aanroepen voor enige <literal>&lt;html></literal> of
-     <literal>&lt;head></literal> tags. Als de header wordt afgesloten
-     voordat deze functie wordt aangeroepen, dan zal
-     <function>setcookie</function> falen en &false; terug geven.
-     Als alles goed is gegaan, geeft hij &true; terug. Dit zegt
-     niets over of de gebruiker de cookie geaccepteerd heeft of niet.
+     met de rest van de header informatie. Zoals elke header moeten cookies
+     verzonden worden <emphasis>voordat</emphasis> er output verzonden wordt
+     vanuit je script (dit is een restrictie van het protocol). Daarom moet je
+     deze functie aanroepen voor enige output, zoals
+     <literal>&lt;html></literal> of <literal>&lt;head></literal> tags en
+     whitespace. Als er toch output wordt doorgegeven voor het aanroepen
+     van deze functie, dan zal <function>setcookie</function> falen en
+     &false; terug geven. Als alles goed is gegaan, geeft hij &true; terug. Dit
+     wil echter niet zeggen dat de gebruiker het cookie geaccepteerd heeft.
     </para>
     <para>
      Alle argumenten behalve de <parameter>name</parameter> parameter zijn
Index: phpdoc-nl/reference/http/functions/headers-sent.xml
diff -u phpdoc-nl/reference/http/functions/headers-sent.xml:1.3 phpdoc-nl/reference/http/functions/headers-sent.xml:1.4
--- phpdoc-nl/reference/http/functions/headers-sent.xml:1.3	Wed Aug 14 07:17:48 2002
+++ phpdoc-nl/reference/http/functions/headers-sent.xml	Fri Jan 10 16:13:45 2003
@@ -1,25 +1,81 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- EN-Revision: 1.3 Maintainer: manuzhai Status: ready -->
+<!-- EN-Revision: 1.11 Maintainer: manuzhai Status: ready -->
   <refentry id="function.headers-sent">
    <refnamediv>
     <refname>headers_sent</refname>
-    <refpurpose>Geeft &true; terug als de headers verzonden zijn</refpurpose>
+    <refpurpose>Geeft aan of en waar de headers verzonden zijn</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Beschrijving</title>
-     <methodsynopsis>
-      <type>bool</type><methodname>headers_sent</methodname>
-      <void/>
-     </methodsynopsis>
+    <methodsynopsis>
+     <type>boolean</type><methodname>headers_sent</methodname>
+     <methodparam
+choice="opt"><type>string</type><parameter>&amp;file</parameter></methodparam>
+     <methodparam
+choice="opt"><type>int</type><parameter>&amp;line</parameter></methodparam>
+    </methodsynopsis>
+    <simpara>
+     <function>headers_sent</function> zal &false; teruggeven als er nog
+     geen HTTP headers zijn verzonden, of anders &true;. Als de optionele
+     <parameter>file</parameter> en <parameter>line</parameter> parameters
+     worden meegegeven, zal <function>headers_sent</function> de PHP source
+     file name en het regelnummer waar de output werd begonnen in de
+     <parameter>file</parameter> en <parameter>line</parameter> variabelen
+     gestopt.
+    </simpara> 
+    <simpara> 
+     Je kunt geen headers meer toevoegen met de <function>header</function>
+     functie wanneer de headers al verzonden zijn. Met deze functie kun
+     je op zijn minst voorkomen dat er fouten ontstaan die te maken hebben
+     met HTTP headers. Een andere mogelijkheid is het gebruiken van
+     <link linkend="ref.outcontrol">Output Buffering</link>.
+    </simpara> 
+    <note> 
+     <title>Nieuwe parameters</title> 
+     <simpara> 
+      The optionele <parameter>file</parameter> en
+      <parameter>line</parameter> parameters zijn toegevoegd in PHP 4.3.0. 
+     </simpara>
+    </note>
     <para>
-     Deze functie geeft &true; terug als de HTTP headers al zijn verzonden,
-     anders &false; Je kan geen header regels meer sturen via de
-     <function>header</function> functie wanneer de header block is gezet.
-     Door deze functie te gebruiken kan je de "Duplicate headers ..." foutmelding
-     tegen gaan.
+     <example>
+      <title>Voorbeelden met <function>headers_sent</function></title>
+      <programlisting role="php">
+<![CDATA[
+<?php
+
+// Als er nog geen headers verzonden zijn, stuur er een
+if (!headers_sent()) {
+    header ('Location: http://www.example.com/');
+    exit;
+}
+
+// Een voorbeeld met de optionele file en line parameters, vanaf PHP 4.3.0
+// Let erop dat $filename en $linenum worden meegegeven voor later gebruik.
+// Geef ze van te voren geen waarden.
+
+if (!headers_sent($filename, $linenum)) {
+    header ('Location: http://www.example.com/');
+    exit;
+
+// Waarschijnlijk wil je hier een fout laten zien
+} else {
+
+    print "Headers zijn al verzonden in $filename op regel $linenum\n" .
+          "Kan niet doorsturen, klik in plaats daarvan 
+          <a href=\"http://www.example.com\">deze link</a> aan.\n";
+    exit;
+    
+}
+
+?>
+]]>
+      </programlisting>
+     </example>
     </para>
     <para>
-     Zie ook: <function>header</function> voor een gedetaileerdere discusie
+     Zie ook <function>ob_start</function>, <function>trigger_error</function>,
+     en <function>header</function> voor een gedetaileerdere discusie
      over deze dingen.
     </para>
    </refsect1>
Index: phpdoc-nl/reference/http/functions/header.xml
diff -u phpdoc-nl/reference/http/functions/header.xml:1.4 phpdoc-nl/reference/http/functions/header.xml:1.5
--- phpdoc-nl/reference/http/functions/header.xml:1.4	Wed Aug 14 07:17:48 2002
+++ phpdoc-nl/reference/http/functions/header.xml	Fri Jan 10 16:13:45 2003
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- EN-Revision: 1.5 Maintainer: manuzhai Status: ready -->
+<!-- EN-Revision: 1.11 Maintainer: manuzhai Status: ready -->
   <refentry id="function.header">
    <refnamediv>
     <refname>header</refname>
@@ -28,8 +28,10 @@
      <informalexample>
       <programlisting role="php">
 <![CDATA[
+<?php
 header('WWW-Authenticate: Negotiate');
 header('WWW-Authenticate: NTLM',FALSE);
+?>
 ]]>
       </programlisting>
      </informalexample>
@@ -51,7 +53,7 @@
       <programlisting role="php">
 <![CDATA[
 <?php
-  header("HTTP/1.0 404 Not Found");
+header("HTTP/1.0 404 Not Found");
 ?>
 ]]>
       </programlisting>
@@ -74,7 +76,9 @@
        <informalexample>
         <programlisting role="php">
 <![CDATA[
+<?php
 header("Status: 404 Not Found");
+?>
 ]]>
         </programlisting>
        </informalexample>
@@ -89,8 +93,10 @@
      <informalexample>
       <programlisting role="php">
 <![CDATA[
-header("Location: http://www.php.net/"); /* Stuur de browser naar de PHP web site */
-exit;                 /* Zorg dat de code hieronder niet wordt uitgevoerd */
+<?php
+header("Location: http://www.php.net/"); /* Stuur de browser naar de PHP website */
+exit;                        /* Zorg dat de code hieronder niet wordt uitgevoerd */
+?>
 ]]>
       </programlisting>
      </informalexample>
@@ -107,9 +113,11 @@
       <informalexample>
        <programlisting>
 <![CDATA[
+<?php
 header("Location: http://".$_SERVER['HTTP_HOST']
-                      .dirname($_SERVER['PHP_SELF'])
-                      ."/".$relative_url);
+                          .dirname($_SERVER['PHP_SELF'])
+                          ."/".$relative_url);
+?>
 ]]>
        </programlisting>
       </informalexample>
@@ -123,12 +131,14 @@
      <informalexample>
       <programlisting role="php">
 <![CDATA[
+<?php
 header("Expires: Mon, 26 Jul 1997 05:00:00 GMT");    // Datum in het verleden
 header("Last-Modified: " . gmdate("D, d M Y H:i:s") . " GMT");
                                                      // Altijd veranderd
 header("Cache-Control: no-store, no-cache, must-revalidate");  // HTTP/1.1
 header("Cache-Control: post-check=0, pre-check=0", false);
 header("Pragma: no-cache");                          // HTTP/1.0
+?>
 ]]>
       </programlisting>
      </informalexample>
@@ -160,9 +170,12 @@
      <informalexample>
       <programlisting role="php">
 <![CDATA[
-
-<?php header ("Content-type: audio/x-pn-realaudio"); ?>
-// Werkt niet, zie de lege regel hierboven
+<html>
+<?php
+// Dit geeft een fout. Let op de output hierboven,
+// die voor de header() call staat.
+header ("Content-type: audio/x-pn-realaudio");
+?>
 ]]>
       </programlisting>
      </informalexample>
@@ -188,10 +201,13 @@
       <programlisting role="php">
 <![CDATA[
 <?php
+// We gaan een PDF outputten
 header("Content-type: application/pdf");
+// De PDF die we gaan outputten heet downloaded.pdf
 header("Content-Disposition: attachment; filename=downloaded.pdf");
-
-/* ... output pdf file ... */
+// De PDF source is in original.pdf
+readfile("original.pdf");
+?>
 ]]>
       </programlisting>
      </informalexample>