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

From: Date: Fri, 03 Jan 2003 17:19:13 +0000
Subject: cvs: phpdoc-nl /reference/filesystem/functions filemtime.xml fopen.xml fpassthru.xml fread.xml fscanf.xml fwrite.xml
Groups: php.doc.nl 
Request: Send a blank email to doc-nl+get-200@lists.php.net to get a copy of this message
truelight Fri Jan 3 12:19:13 2003 EDT Modified files: /phpdoc-nl/reference/filesystem/functions filemtime.xml fopen.xml fpassthru.xml fread.xml fscanf.xml fwrite.xml Log: Sync with EN

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