cvs: phpdoc-nl /reference/filesystem/functions filemtime.xml fopen.xml fpassthru.xml fread.xml fscanf.xml fwrite.xml

Index: phpdoc-nl/reference/filesystem/functions/filemtime.xml
diff -u phpdoc-nl/reference/filesystem/functions/filemtime.xml:1.1 phpdoc-nl/reference/filesystem/functions/filemtime.xml:1.2
--- phpdoc-nl/reference/filesystem/functions/filemtime.xml:1.1	Tue Aug 13 07:31:17 2002
+++ phpdoc-nl/reference/filesystem/functions/filemtime.xml	Fri Jan  3 12:19:12 2003
@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- EN-Revision: 1.2 Maintainer: truelight Status: ready -->
-<!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -->
+<!-- EN-Revision: 1.3 Maintainer: truelight Status: ready -->
   <refentry id="function.filemtime">
    <refnamediv>
     <refname>filemtime</refname>
@@ -14,7 +13,8 @@
      </methodsynopsis>
     <para>
      Geeft de tijd dat het bestand het laatste gewijzigd is terug of &false;
-     in het geval van een fout. De tijd wordt terug gegeven in Unix timestamp.
+     in het geval van een fout. De tijd wordt terug gegeven in Unix timestamp
+     en die is geschikt voor de <function>date</function> functie.
     </para>
     <para>
      Het resultaat van deze functie wordt gecached. Zie
@@ -29,12 +29,27 @@
      Let op: deze functie geeft de tijd terug, van wanneer
      er data naar een bestand geschreven is, dat wil zeggen,
      de tijd dat de inhoud van het bestand gewijzigd is.
-     Gebruik <function>date</function> op het resultaat
-     van deze functie om een leesbare 'laatst gewijzigd' datum
-     voor voetnoten van een pagina te krijgen.
     </para>
     <para>
-     Zie ook <function>filectime</function> en <function>touch</function>.
+     <example>
+      <title><function>filemtime</function> voorbeeld</title>
+      <programlisting role="php">
+<![CDATA[
+<?php
+// weergeeft bijvoorbeeld: somefile.txt was het laatste gewijzigd op: December 29 2002 22:16:23.
+
+$filename = 'somefile.txt';
+if (file_exists($filename)) {
+    echo "$filename was het laatste gewijzigd op: " . date ("F d Y H:i:s.", filemtime($filename));
+}
+?>
+]]>
+      </programlisting>
+     </example>
+    </para>
+    <para>
+     Zie ook <function>filectime</function>, <function>stat</function>,
+     <function>touch</function> en <function>getlastmod</function>.
     </para>
    </refsect1>
   </refentry>
@@ -58,4 +73,4 @@
 vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
--->
\ No newline at end of file
+-->
Index: phpdoc-nl/reference/filesystem/functions/fopen.xml
diff -u phpdoc-nl/reference/filesystem/functions/fopen.xml:1.1 phpdoc-nl/reference/filesystem/functions/fopen.xml:1.2
--- phpdoc-nl/reference/filesystem/functions/fopen.xml:1.1	Tue Aug 13 07:31:17 2002
+++ phpdoc-nl/reference/filesystem/functions/fopen.xml	Fri Jan  3 12:19:12 2003
@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- EN-Revision: 1.3 Maintainer: truelight Status: ready -->
-<!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -->
+<!-- EN-Revision: 1.5 Maintainer: truelight Status: ready -->
   <refentry id="function.fopen">
    <refnamediv>
     <refname>fopen</refname>
@@ -16,59 +15,39 @@
       <methodparam choice="opt"><type>resource</type><parameter>zcontext</parameter></methodparam>
      </methodsynopsis>
     <simpara>
-     Als <parameter>filename</parameter> begint met "http://" (niet
-     hoofdletter gevoelig), wordt er een HTTP 1.0 connectie geopend
-     naar de aangegeven server, de pagina wordt opgevraagd met de
-     HTTP GET methode, en een bestands pointer wordt terug gegeven die
-     aan het begin van de body van de reactie staat. Een 'Host:' kop wordt
-     met de request meegezonden om 'name-based virtual hosts' aan te kunnen.
-    </simpara>
-    <simpara>
-     Vanaf PHP 4.3.0 geldt, dat als je PHP gecompileerd hebt met ondersteuning
-     voor OpenSSL, je "https://" mag gebruiken om een HTTP connectie te openen
-     over SSL.
-    </simpara>
-    <simpara>
-     Let op dat de bestands pointer het alleen mogelijk maakt om de
-     <emphasis>body</emphasis> van de reactie uit te lezen;
-     om de HTTP kop van de reactie te lezen moet je PHP 4.0.5 of later gebruiken;
-     De kop wordt opgeslagen in de $http_response_header variabel.
-     Vanaf PHP 4.3.0 kan de kop ook worden uitgelezen door gebruik te maken van
-     <function>file_get_wrapper_data</function>.
-    </simpara>
-    <simpara>
-     HTTP verbindingen zijn alleen lezen; je kan geen data schrijven of
-     bestanden kopieren naar een HTTP bron.
-    </simpara>
-    <simpara>
-     Eerdere versies dan PHP 4.0.5 behandelen geen HTTP redirects. Om deze reden
-     moeten folder URL's eindigen op een slash (http://www.voorbeeld.com/test/ ipv
-     http://www.voorbeeld.com/test).
-    </simpara>
-    <simpara>
-     Als <parameter>filename</parameter> begint met "ftp://" (niet
-     hoofdletter gevoelig), wordt er een ftp connectie geopend
-     naar de aangegeven server en een pointer naar het gevraagde bestand
-     wordt terug gegeven. Als de server geen 'passive mode' ondersteunt,
-     zal dit niet werken. Je kan bestanden voor zowel lezen als schrijven openen
-     (maar niet beide simultaan). Als het remote bestand al bestaat op de ftp server
-     en je probeert hem te openen om te schrijven, dan zal dit niet werken.
-     Als je bestaande files over ftp moet updaten, gebruik <function>ftp_connect</function>.
-    </simpara>
-    <simpara>
-     Als <parameter>filename</parameter> "php://stdin", "php://stdout" of
-     "php://stderr" is, dan zal de corresponderende stdio stream worden geopend.
-     (Dit is geintroduceerd in PHP 3.0.13; in eerdere versies moeten bestandsnamen
-     zoals "/dev/stdin" of "/dev/fd/0" gebruikt worden om de stdio streams op te vragen.)
-    </simpara>
-    <simpara>
-     Als <parameter>filename</parameter> begint met iets anders, dan
-     wordt het bestand van het bestands systeem geopend, en een bestands pointer
-     naar de geopende bestand terug gegeven.
-    </simpara>
-    <simpara>
-     Als het openen niet lukt, geeft de functie &false; terug.
+     <function>fopen</function> bindt een genaamde resource,
+     aangegeven met <parameter>filename</parameter>, aan een stream. Als
+     <parameter>filename</parameter> van het formaat "schema://..." is,
+     dan wordt aangenomen dat het een URL is en PHP zal dan zoeken naar
+     een protocol handler (ook bekend als een wrapper) voor dat schema.
+     Als er geen wrapper voor dat protocol geregistreerd is, zal PHP
+     een notice weergeven om je te helpen mogelijke problemen in je
+     script te achterhalen en zal dan doorgaan alsof <parameter>filename</parameter>
+     verwijst naar een normaal bestand.
+    </simpara>
+    <simpara>
+     Als PHP heeft besloten dat <parameter>filename</parameter> verwijst
+     naar een lokaal bestand, dan zal het proberen om een stream te openen
+     naar dat bestand. Het bestand moet toegankelijk zijn voor PHP, dus
+     je moet er voor zorgen dat de bestands rechten dit toestaan.
+     Als je <link linkend="ini.safe-mode">safe_mode</link>
+     of <link linkend="ini.open-basedir">open_basedir</link> aan hebt staan,
+     kunnen er andere restricties gelden.
+    </simpara>
+    <simpara>
+     Als PHP heeft besloten dat <parameter>filename</parameter> verwijst
+     naar een geregistreerde protcol en dat dat protocol is geregistreerd
+     als een netwerk URL, dan zal PHP controleren of
+     <link linkend="ini.allow-url-fopen">allow_url_fopen</link> aan staat.
+     Als het uit staat, dan zal PHP een waarschuwing weergeven en fopen zal dan
+     falen.
     </simpara>
+    <note>
+     <simpara>
+      De lijst met ondersteunde protocols kan gevonden worden op <xref linkend="wrappers"/>.
+     </simpara>
+    </note>
+
     <para>
      <parameter>mode</parameter> mag een van de volgende zijn:
      <itemizedlist>
@@ -119,7 +98,8 @@
       De <parameter>mode</parameter> mag de letter 'b' bevatten.
       Dit is alleen handig op systemen die verschil zien tussen
       binaire en tekst bestand (bijvoorbeeld Windows. Op Unix is het zinloos).
-      Als het niet nodig is, wordt het genegeerd.
+      Als het niet nodig is, wordt het genegeerd. Je wordt aangemoedigd om
+      de 'b' vlag toe te voegen om je script zo compatible mogelijk te houden.
      </para>
     </note>
     <para>
@@ -131,6 +111,9 @@
      De optionele vierde <parameter>zcontext</parameter> parameter
      is gebruikt voor gespecifiseerde afstemmings parameters en aanroepen.
     </para>
+    <simpara>
+     Als het openen faalt, dan geeft de functie &false; terug.
+    </simpara>
     <para>
      <example>
       <title><function>fopen</function> voorbeeld</title>
@@ -173,7 +156,8 @@
      </informalexample>
     </para>
     <simpara>
-     Zie ook <function>fclose</function>,
+     Zie ook <xref linkend="wrappers"/>,
+     <function>fclose</function>,
      <function>fgets</function>,
      <function>fsockopen</function>,
      <function>file</function>,
@@ -204,4 +188,4 @@
 vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
--->
\ No newline at end of file
+-->
Index: phpdoc-nl/reference/filesystem/functions/fpassthru.xml
diff -u phpdoc-nl/reference/filesystem/functions/fpassthru.xml:1.1 phpdoc-nl/reference/filesystem/functions/fpassthru.xml:1.2
--- phpdoc-nl/reference/filesystem/functions/fpassthru.xml:1.1	Tue Aug 13 07:31:17 2002
+++ phpdoc-nl/reference/filesystem/functions/fpassthru.xml	Fri Jan  3 12:19:12 2003
@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- EN-Revision: 1.2 Maintainer: truelight Status: ready -->
-<!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -->
+<!-- EN-Revision: 1.3 Maintainer: truelight Status: ready -->
   <refentry id="function.fpassthru">
    <refnamediv>
     <refname>fpassthru</refname>
@@ -14,7 +13,7 @@
      </methodsynopsis>
     <simpara>
      Leest tot EOF van de opgegeven bestands pointer vanaf de huidige positie
-     en geeft het resultaat door aan de standaard output.
+     en schrijft het resultaat naar de output buffer.
     </simpara>
     <simpara>
      Als er een fout optreedt, geeft <function>fpassthru</function>
@@ -31,7 +30,8 @@
      <parameter>fp</parameter> dus onbruikbaar).
     </simpara>
     <simpara>
-     Als je alleen de inhoud van een bestand naar de stdout wil sturen,
+     Als je alleen de inhoud van een bestand naar de output buffer wil sturen,
+     zonder het eerst te wijzigen of te zoeken naar een bepaald beginpunt,
      kan je beter <function>readfile</function> gebruiken, omdat
      dat je een <function>fopen</function> aanroep scheelt.
     </simpara>
@@ -42,6 +42,11 @@
       binaire mode door een <literal>b</literal> toe te voegen aan de mode
       in de aanroep van <function>fopen</function>.
      </para>
+     <para>
+      Je wordt aangemoedigd om de <literal>b</literal> vlag te gebruiken
+      als je te maken hebt met binaire bestanden, zelfs als jouw systeem
+      het niet nodig heeft, zodat je scripts meer compatible zijn.
+     </para>
     </note>
     <simpara>
      Zie ook <function>readfile</function>,
@@ -70,4 +75,4 @@
 vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
--->
\ No newline at end of file
+-->
Index: phpdoc-nl/reference/filesystem/functions/fread.xml
diff -u phpdoc-nl/reference/filesystem/functions/fread.xml:1.1 phpdoc-nl/reference/filesystem/functions/fread.xml:1.2
--- phpdoc-nl/reference/filesystem/functions/fread.xml:1.1	Tue Aug 13 07:31:16 2002
+++ phpdoc-nl/reference/filesystem/functions/fread.xml	Fri Jan  3 12:19:12 2003
@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- EN-Revision: 1.2 Maintainer: truelight Status: ready -->
-<!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.25 -->
+<!-- EN-Revision: 1.4 Maintainer: truelight Status: ready -->
   <refentry id="function.fread">
    <refnamediv>
     <refname>fread</refname>
@@ -17,17 +16,19 @@
      <function>fread</function> leest <parameter>length</parameter> bytes
      van de bestands pointer waar <parameter>fp</parameter> naar verwijst.
      Het lezen stopt als <parameter>length</parameter> bytes worden gelezen
-     of als er een EOF optreed, welke ook als eerste komt.
+     of als er een EOF (einde-van-bestand) optreed, welke ook als eerste komt.
     </simpara>
     <para>
      <informalexample>
       <programlisting role="php">
 <![CDATA[
+<?php
 // leest de inhoud van een bestand naar een string
 $filename = "/usr/local/something.txt";
 $fd = fopen ($filename, "r");
 $contents = fread ($fd, filesize ($filename));
 fclose ($fd);
+?>
 ]]>
       </programlisting>
      </informalexample>
@@ -43,10 +44,12 @@
      <informalexample>
       <programlisting role="php">
 <![CDATA[
+<?php
 $filename = "c:\\files\\somepic.gif";
 $fd = fopen ($filename, "rb");
 $contents = fread ($fd, filesize ($filename));
 fclose ($fd);
+?>
 ]]>
       </programlisting>
      </informalexample>
@@ -80,4 +83,4 @@
 vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
--->
\ No newline at end of file
+-->
Index: phpdoc-nl/reference/filesystem/functions/fscanf.xml
diff -u phpdoc-nl/reference/filesystem/functions/fscanf.xml:1.1 phpdoc-nl/reference/filesystem/functions/fscanf.xml:1.2
--- phpdoc-nl/reference/filesystem/functions/fscanf.xml:1.1	Tue Aug 13 07:31:16 2002
+++ phpdoc-nl/reference/filesystem/functions/fscanf.xml	Fri Jan  3 12:19:12 2003
@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- EN-Revision: 1.4 Maintainer: truelight Status: ready -->
-<!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -->
+<!-- EN-Revision: 1.5 Maintainer: truelight Status: ready -->
   <refentry id="function.fscanf">
    <refnamediv>
     <refname>fscanf</refname>
@@ -56,6 +55,14 @@
       </programlisting>
      </example>
     </para>
+    <note>
+     <simpara>
+      Voor PHP 4.3.0, de maximaal aantal tekens per keer dat gelezen
+      kon worden uit het bestand was 512 (of tot de eerste \n, welke
+      ook als eerste kwam).
+      Vanaf PHP 4.3.0 worden ook lange regels gelezen en gescand.
+     </simpara>
+    </note>
     <para>
      Zie ook <function>fread</function>, <function>fgets</function>,
      <function>fgetss</function>, <function>sscanf</function>,
@@ -83,4 +90,4 @@
 vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
--->
\ No newline at end of file
+-->
Index: phpdoc-nl/reference/filesystem/functions/fwrite.xml
diff -u phpdoc-nl/reference/filesystem/functions/fwrite.xml:1.1 phpdoc-nl/reference/filesystem/functions/fwrite.xml:1.2
--- phpdoc-nl/reference/filesystem/functions/fwrite.xml:1.1	Tue Aug 13 07:31:16 2002
+++ phpdoc-nl/reference/filesystem/functions/fwrite.xml	Fri Jan  3 12:19:12 2003
@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- EN-Revision: 1.2 Maintainer: truelight Status: ready -->
-<!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -->
+<!-- EN-Revision: 1.5 Maintainer: truelight Status: ready -->
   <refentry id="function.fwrite">
    <refnamediv>
     <refname>fwrite</refname>
@@ -24,7 +23,7 @@
     </simpara>
     <simpara>
      <function>fwrite</function> geeft het aantal bytes dat hij geschreven heeft
-     terug, of -1 als er een fout is opgetreden.
+     terug, of &false; als er een fout is opgetreden.
     </simpara>
     <simpara>
      Let op dat als de <parameter>length</parameter> parameter gegeven is,
@@ -40,6 +39,44 @@
       in <function>fopen</function> mode parameter.
      </para>
     </note>
+    <para>
+     <example>
+      <title>Een simpel fwrite voorbeeld</title>
+      <programlisting role="php">
+<![CDATA[
+<?php
+$filename = 'test.txt';
+$somecontent = "Voeg dit toe aan het bestand\n";
+
+// Laten we eerst controleren of het bestand bestaat en of we er in kunnen schrijven.
+if (is_writable($filename)) {
+
+    // In ons voorbeeld openen we $filename in 'toevoeg' modus.
+    // De bestands pointer is aan het einde van het bestand
+    // en daar gaat $somecontent naar toe als we het fwrite()'en.
+    if (!$fp = fopen($filename, 'a')) {
+         print "Kan het bestand niet openen ($filename)";
+         exit;
+    }
+
+    // Schrijf $somecontent naar ons bestand dat we geopend hebben.
+    if (!fwrite($fp, $somecontent)) {
+        print "Kan niet schrijven naar bestand ($filename)";
+        exit;
+    }
+
+    print "Succes, geschreven ($somecontent) naar bestand ($filename)";
+
+    fclose($fp);
+
+} else {
+    print "Het bestand $filename is niet schrijfbaar";
+}
+?>
+]]>
+      </programlisting>
+     </example>
+    </para>
     <simpara>
      Zie ook <function>fread</function>, <function>fopen</function>,
      <function>fsockopen</function>, <function>popen</function>, en