cvs: phpdoc /nl/functions http.xml

derick Mon Mar 25 07:16:40 2002 EDT Modified files: /phpdoc/nl/functions http.xml Log: - Whitespaced

Index: phpdoc/nl/functions/http.xml diff -u phpdoc/nl/functions/http.xml:1.3 phpdoc/nl/functions/http.xml:1.4 --- phpdoc/nl/functions/http.xml:1.3 Sun Mar 24 19:30:33 2002 +++ phpdoc/nl/functions/http.xml Mon Mar 25 07:16:40 2002 @@ -1,13 +1,13 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <reference id="ref.http"> <title>HTTP functies</title> <titleabbrev>HTTP</titleabbrev> <partintro> <simpara> - Met deze functies kun je de output die teruggezonden wordt naar de - remote browser manipuleren op het HTTP protocol niveau. + Met deze functies kun je de output die teruggezonden wordt naar de remote + browser manipuleren op het HTTP protocol niveau. </simpara> </partintro> @@ -30,12 +30,11 @@ informatie over <acronym>HTTP</acronym> headers. </para> <para> - De optionele <parameter>replace</parameter> parameter geeft aan - of de header een vorige gelijkaardige header moet vervangen, of - een tweede header van hetzelfde type toe moet voegen. Standaard - zal hij vervangen, maar als je &false; meegeeft als tweede - argument kun je meerdere headeers van het zelfde type forceren. - Bij voorbeeld: + De optionele <parameter>replace</parameter> parameter geeft aan of de + header een vorige gelijkaardige header moet vervangen, of een tweede + header van hetzelfde type toe moet voegen. Standaard zal hij vervangen, + maar als je &false; meegeeft als tweede argument kun je meerdere headeers + van het zelfde type forceren. Bij voorbeeld: <informalexample> <programlisting role="php"> <![CDATA[ @@ -46,14 +45,13 @@ </informalexample> </para> <para> - Er zijn twee speciale header calls. De eerste is een header die - begint met de string "<literal>HTTP/</literal>" (case is onbelangrijk), - die wordt gebruikt om uit te zoeken welke HTTP status moet - worden verzonden. Bijvoorbeeld, als je Apache hebt geconfigureerd om - een PHP script te gebruiken om requests voor ontbrekende bestanden - af te handelen (door de <literal>ErrorDocument</literal> directive te - gebruiken), wil je er misschien voor zorgen dat je script - de goede status code genereert. + Er zijn twee speciale header calls. De eerste is een header die begint + met de string "<literal>HTTP/</literal>" (case is onbelangrijk), die + wordt gebruikt om uit te zoeken welke HTTP status moet worden verzonden. + Bijvoorbeeld, als je Apache hebt geconfigureerd om een PHP script te + gebruiken om requests voor ontbrekende bestanden af te handelen (door de + <literal>ErrorDocument</literal> directive te gebruiken), wil je er + misschien voor zorgen dat je script de goede status code genereert. <informalexample> <programlisting role="php"> <![CDATA[ @@ -65,20 +63,19 @@ </informalexample> <note> <para> - Als je de return status op deze manier wil instellen moet je - zorgen dat dit de eerste header is die je verstuurt. Vergeet niet - dat <function>setcookie</function> <function>header</function> - intern gebruikt en dat de sessie functies misschien proberen - om een cookie neer te zetten, zodat deze interfereren met het - instellen van een return status via - <literal>header("HTTP ...")</literal>. + Als je de return status op deze manier wil instellen moet je zorgen dat + dit de eerste header is die je verstuurt. Vergeet niet dat + <function>setcookie</function> <function>header</function> intern + gebruikt en dat de sessie functies misschien proberen om een cookie + neer te zetten, zodat deze interfereren met het instellen van een + return status via <literal>header("HTTP ...")</literal>. </para> </note> <note> <para> - In PHP 3 werkt dit alleen als PHP is gecompileerd als een - Apache module. Je kunt echter hetzelfde effect verkrijgen - door middel van het gebruiken van de + In PHP 3 werkt dit alleen als PHP is gecompileerd als een Apache + module. Je kunt echter hetzelfde effect verkrijgen door middel van het + gebruiken van de <literal>Status</literal> header. <informalexample> <programlisting role="php"> @@ -91,10 +88,10 @@ </note> </para> <para> - De tweede speciale case is de "Location:" header. Deze header wordt - niet alleen teruggestuurd naar de browser, maar hij geeft ook een - <literal>REDIRECT</literal> (302) status code aan de browser tenzij - een <literal>3xx</literal> status code al eerder werd ingesteld. + De tweede speciale case is de "Location:" header. Deze header wordt niet + alleen teruggestuurd naar de browser, maar hij geeft ook een + <literal>REDIRECT</literal> (302) status code aan de browser tenzij een + <literal>3xx</literal> status code al eerder werd ingesteld. <informalexample> <programlisting role="php"> <![CDATA[ @@ -108,11 +105,11 @@ <para> HTTP/1.1 heeft een absolute <acronym>URI</acronym> als argument voor <ulink url="&spec.http1.1;-sec14.html#sec14.30">Location:</ulink>, - inclusief het schema, de hostname en absoluut pad, maar sommige - clients accepteren relatieve URIs. Je kunt normaal - <literal>$_SERVER['HTTP_HOST']</literal>, <literal>$_SERVER['PHP_SELF']</literal> - en <function>dirname</function> gebruiken om zelf een - absolute URI te maken van een relatieve: + inclusief het schema, de hostname en absoluut pad, maar sommige clients + accepteren relatieve URIs. Je kunt normaal + <literal>$_SERVER['HTTP_HOST']</literal>, + <literal>$_SERVER['PHP_SELF']</literal> en <function>dirname</function> + gebruiken om zelf een absolute URI te maken van een relatieve: <informalexample> <programlisting> <![CDATA[ @@ -125,11 +122,11 @@ </para> </note> <para> - PHP scripts genereren vaak dynamische content die niet mag worden - gecached door de client browser of een proxy cache tussen de server - en de client browser. Je kunt veel proxies en clients kunnen forceren - het cachen uit te zetten met - <informalexample> + PHP scripts genereren vaak dynamische content die niet mag worden + gecached door de client browser of een proxy cache tussen de server en de + client browser. Je kunt veel proxies en clients kunnen forceren het + cachen uit te zetten met + <informalexample> <programlisting role="php"> <![CDATA[ header("Expires: Mon, 26 Jul 1997 05:00:00 GMT"); // Datum in het verleden @@ -143,30 +140,29 @@ </informalexample> <note> <para> - Het zou kunnen dat je pagina's zelfs niet worden gecached als je - niet alle headers hierboven meestuurt. Er zijn een aantal opties - die gebruikers zelf kunnen instellen voor hun browser die ervoor - zorgen dat hun standaard caching gedrag verandert. Door de bovenstaande - headers mee te sturen kun je alle instellingen die anders zorgen dat - de output van je script wordt gecached overschrijven. + Het zou kunnen dat je pagina's zelfs niet worden gecached als je niet + alle headers hierboven meestuurt. Er zijn een aantal opties die + gebruikers zelf kunnen instellen voor hun browser die ervoor zorgen dat + hun standaard caching gedrag verandert. Door de bovenstaande headers + mee te sturen kun je alle instellingen die anders zorgen dat de output + van je script wordt gecached overschrijven. </para> <para> - Bovendien kunnen de <function>session_cache_limiter</function> - en de <literal>session.cache_limiter</literal> configuratie - worden gebruikt om automatisch de correcte caching-gerelateerde - headers mee te sturen wanneer er sessies worden gebruikt. + Bovendien kunnen de <function>session_cache_limiter</function> en de + <literal>session.cache_limiter</literal> configuratie worden gebruikt + om automatisch de correcte caching-gerelateerde headers mee te sturen + wanneer er sessies worden gebruikt. </para> </note> </para> <para> - Onthoud dat <function>header</function> moet worden aangeroepen - voor er output is verzonden, door normale HTML tags, lege regels in een - file, of vanuit PHP. Het is een veel voorkomende fout - om met <function>include</function>, - <function>require</function>, functies, of een andere file toegang - functie output te verzenden voordat <function>header</function> - wordt aangeroepen. Hetzelfde probleem bestaat wanneer - er een enkele PHP/HTML file wordt gebruikt. + Onthoud dat <function>header</function> moet worden aangeroepen voor er + output is verzonden, door normale HTML tags, lege regels in een file, of + vanuit PHP. Het is een veel voorkomende fout om met + <function>include</function>, <function>require</function>, functies, of + een andere file toegang functie output te verzenden voordat + <function>header</function> wordt aangeroepen. Hetzelfde probleem bestaat + wanneer er een enkele PHP/HTML file wordt gebruikt. <informalexample> <programlisting role="php"> <![CDATA[ @@ -180,22 +176,22 @@ </informalexample> <note> <para> - In PHP 4 kun je output buffering gebruiken om dit probleem te voorkomen, - waarbij het begin van al je output naar de browser wordt gebuffered - op de server tot je het verzendt. Je kunt dit doen door - <function>ob_start</function> en <function>ob_end_flush</function> - aan te roepen in je script, of door de <literal>output_buffering</literal> - instelling in je <filename>php.ini</filename> of je server configuratie - files in te stellen. + In PHP 4 kun je output buffering gebruiken om dit probleem te + voorkomen, waarbij het begin van al je output naar de browser wordt + gebuffered op de server tot je het verzendt. Je kunt dit doen door + <function>ob_start</function> en <function>ob_end_flush</function> aan + te roepen in je script, of door de <literal>output_buffering</literal> + instelling in je <filename>php.ini</filename> of je server configuratie + files in te stellen. </para> </note> </para> <para> - Als je wil dat de gebruiker wordt gevraagd de data die je zendt - op te slaan, zoals een gegenereerd PDF bestand, kun je de - <ulink url="&url.rfc2183;">Content-Disposition</ulink> header gebruiken - om een standaard filenaam mee te geven en de browser te forceren de - opslaan dialoog te laten zien. + Als je wil dat de gebruiker wordt gevraagd de data die je zendt op te + slaan, zoals een gegenereerd PDF bestand, kun je de <ulink + url="&url.rfc2183;">Content-Disposition</ulink> header gebruiken om een + standaard filenaam mee te geven en de browser te forceren de opslaan + dialoog te laten zien. <informalexample> <programlisting role="php"> <![CDATA[ @@ -209,16 +205,15 @@ </informalexample> <note> <para> - Er is een bug in Microsoft Internet Explorer 4.01 die ervoor - zorgt dat dit niet werkt. Er is niks aan te doen. Er is ook een - bug in Microsoft Internet Explorer 5.5 dat hiermee - problemen veroorzaakt. Deze kan worden opgelost door up te graden - naar Service Pack 2 of later. + Er is een bug in Microsoft Internet Explorer 4.01 die ervoor zorgt dat + dit niet werkt. Er is niks aan te doen. Er is ook een bug in Microsoft + Internet Explorer 5.5 dat hiermee problemen veroorzaakt. Deze kan + worden opgelost door up te graden naar Service Pack 2 of later. </para> </note> </para> <para> - Zie ook: <function>headers_sent</function>, + Zie ook: <function>headers_sent</function>, <function>setcookie</function>, en de sectie over <link linkend="features.http-auth">HTTP authenticatie</link>. </para> @@ -237,8 +232,8 @@ <void/> </methodsynopsis> <para> - Deze functie geeft &true; terug als de HTTP headers al zijn verzonden, - anders &false; + Deze functie geeft &true; terug als de HTTP headers al zijn verzonden, + anders &false; </para> <para> Zie ook: <function>header</function> @@ -263,56 +258,54 @@ <methodparam choice="opt"><type>int</type><parameter>secure</parameter></methodparam> </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 + <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. </para> <para> - Alle argumenten behalve de <parameter>name</parameter> parameter - zijn optioneel. Als alleen het name argument aanwezig is, wordt - het cookie met die naam verwijderd van de remote client. Je mag - een willekeurig argument ook vervangen door een lege string - (<emphasis>&quot;&quot;</emphasis>) om dat argument over te slaan. - De <parameter>expire</parameter> en <parameter>secure</parameter> - argumenten zijn integers en kunnen niet worden overgeslagen - met een lege string. Gebruik in plaats daarvan een nul - (<emphasis>0</emphasis>). De <parameter>expire</parameter> parameter - is een normaal Unix tijds integer zoals wordt teruggegeven door de - <function>time</function> of <function>mktime</function> functies. - De <parameter>secure</parameter> geeft aan dat het cookie alleen - mag worden verzonden over een veilige HTTPS verbinding. + Alle argumenten behalve de <parameter>name</parameter> parameter zijn + optioneel. Als alleen het name argument aanwezig is, wordt het cookie met + die naam verwijderd van de remote client. Je mag een willekeurig argument + ook vervangen door een lege string (<emphasis>&quot;&quot;</emphasis>) om + dat argument over te slaan. De <parameter>expire</parameter> en + <parameter>secure</parameter> argumenten zijn integers en kunnen niet + worden overgeslagen met een lege string. Gebruik in plaats daarvan een + nul (<emphasis>0</emphasis>). De <parameter>expire</parameter> parameter + is een normaal Unix tijds integer zoals wordt teruggegeven door de + <function>time</function> of <function>mktime</function> functies. De + <parameter>secure</parameter> geeft aan dat het cookie alleen mag worden + verzonden over een veilige HTTPS verbinding. </para> <para> Veel voorkomende fouten: <itemizedlist> <listitem> <simpara> - Cookies worden niet zichtbaar tot de volgende keer dat een pagina - waarop het cookie zichtbaar is wordt geladen. + Cookies worden niet zichtbaar tot de volgende keer dat een pagina + waarop het cookie zichtbaar is wordt geladen. </simpara> </listitem> <listitem> <simpara> - Cookies moeten worden verwijderd met dezelfde parameters als waarmee - ze werden ingesteld. + Cookies moeten worden verwijderd met dezelfde parameters als waarmee + ze werden ingesteld. </simpara> </listitem> </itemizedlist> </para> <simpara> - In PHP 3 worden meerdere aanroepen van <function>setcookie</function> - in hetzelfde script verwerkt in omgekeerde volgorde. Als je probeert - een cookie te verwijderen voordat je een nieuwe neerzet, moet je het - toevoegen doen voor het verwijderen. In PHP 4 worden meerdere - aanroepen van <function>setcookie</function> verwerkt in de volgorde - waarop ze worden aangeroepen. + In PHP 3 worden meerdere aanroepen van <function>setcookie</function> in + hetzelfde script verwerkt in omgekeerde volgorde. Als je probeert een + cookie te verwijderen voordat je een nieuwe neerzet, moet je het + toevoegen doen voor het verwijderen. In PHP 4 worden meerdere aanroepen + van <function>setcookie</function> verwerkt in de volgorde waarop ze + worden aangeroepen. </simpara> <para> - Een paar voorbeelden volgen over hoe je cookies moet verzenden: + Een paar voorbeelden volgen over hoe je cookies moet verzenden: <example> <title><function>setcookie</function> stuur voorbeelden</title> <programlisting role="php"> @@ -325,10 +318,10 @@ </example> </para> <para> - Wanneer je een cookie verwijdert moet je zorgen dat de expiratie - datum in het verleden is, om het verwijder mechanisme in je browser - te activeren. Er volgen voorbeelden hoe je in het vorige voorbeeld - verzonden cookies kunt verwijderen: + Wanneer je een cookie verwijdert moet je zorgen dat de expiratie datum in + het verleden is, om het verwijder mechanisme in je browser te activeren. + Er volgen voorbeelden hoe je in het vorige voorbeeld verzonden cookies + kunt verwijderen: <example> <title><function>setcookie</function> verwijder voorbeelden</title> <programlisting role="php"> @@ -341,12 +334,12 @@ </example> </para> <para> - Let er op dat het waarde deel van het cookie automatisch wordt - ge-urlencoded wanneer je het cookie verzendt, en wanneer het wordt - ontvangen, wordt het automatisch gedecodeerd en toegewezen aan - een variabele met dezelfde naam als de cookie naam. Om de inhoud - van ons test cookie in een script te zien, kun je simpelweg een - van de volgende voorbeelden gebruiken: + Let er op dat het waarde deel van het cookie automatisch wordt + ge-urlencoded wanneer je het cookie verzendt, en wanneer het wordt + ontvangen, wordt het automatisch gedecodeerd en toegewezen aan een + variabele met dezelfde naam als de cookie naam. Om de inhoud van ons test + cookie in een script te zien, kun je simpelweg een van de volgende + voorbeelden gebruiken: <informalexample> <programlisting role="php"> <![CDATA[ @@ -357,11 +350,11 @@ </informalexample> </para> <para> - Je kunt ook array cookies zetten door array notatie in de cookie - naam te gebruiken. Dit heeft het effect dat er evenveel cookies - worden neergezet als je array elements hebt, maar als het cookie - wordt ontvangen door je script worden de waarden allemaal geplaatst - in een array met de naam van het cookie: + Je kunt ook array cookies zetten door array notatie in de cookie naam te + gebruiken. Dit heeft het effect dat er evenveel cookies worden neergezet + als je array elements hebt, maar als het cookie wordt ontvangen door je + script worden de waarden allemaal geplaatst in een array met de naam van + het cookie: <informalexample> <programlisting role="php"> <![CDATA[ @@ -378,18 +371,18 @@ </informalexample> </para> <para> - Voor meer informatie over cookies, zie Netscape's cookie + Voor meer informatie over cookies, zie Netscape's cookie specificatie op <ulink url="&spec.cookies;">&spec.cookies;</ulink>. </para> <simpara> - Microsoft Internet Explorer 4 met Service Pack 1 werkt niet - goed met cookies die hun path parameter hebben ingesteld. + Microsoft Internet Explorer 4 met Service Pack 1 werkt niet goed met + cookies die hun path parameter hebben ingesteld. </simpara> <simpara> - Netscape Communicator 4.05 en Microsoft Internet Explorer 3.x - lijken cookies incorrect af te handelen wanneer het pad en de - tijd niet zijn ingesteld. + Netscape Communicator 4.05 en Microsoft Internet Explorer 3.x lijken + cookies incorrect af te handelen wanneer het pad en de tijd niet zijn + ingesteld. </simpara> </refsect1> </refentry>