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

From: Date: Fri, 10 Jan 2003 21:13:46 +0000
Subject: cvs: phpdoc-nl /reference/http/functions header.xml headers-sent.xml setcookie.xml
Groups: php.doc.nl 
Request: Send a blank email to doc-nl+get-222@lists.php.net to get a copy of this message
manuzhai Fri Jan 10 16:13:46 2003 EDT Modified files: /phpdoc-nl/reference/http/functions setcookie.xml headers-sent.xml header.xml Log: Synced with EN.

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>
« previous php.doc.nl (#222) next »