cvs: phpdoc-it /reference/filesystem/functions fscanf.xml ftell.xml is-dir.xml is-executable.xml is-file.xml is-link.xml is-readable.xml
is-uploaded-file.xml is-writable.xml is-writeable.xml link.xml linkinfo.xml move-uploaded-file.xml
| From: | Andrioli Darvin | Date: | Fri, 06 Feb 2004 20:42:01 +0000 |
| Subject: | cvs: phpdoc-it /reference/filesystem/functions fscanf.xml ftell.xml is-dir.xml is-executable.xml is-file.xml is-link.xml is-readable.xml is-uploaded-file.xml is-writable.xml is-writeable.xml link.xml linkinfo.xml move-uploaded-file.xml |
||
| Groups: | php.doc.it | ||
| Request: | Send a blank email to doc-it+get-540@lists.php.net to get a copy of this message | ||
darvina Fri Feb 6 15:42:01 2004 EDT
Modified files:
/phpdoc-it/reference/filesystem/functions fscanf.xml ftell.xml
is-dir.xml
is-executable.xml
is-file.xml is-link.xml
is-readable.xml
is-uploaded-file.xml
is-writable.xml
is-writeable.xml link.xml
linkinfo.xml
move-uploaded-file.xml
Log:
Sync to En tree
http://cvs.php.net/diff.php/phpdoc-it/reference/filesystem/functions/fscanf.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/filesystem/functions/fscanf.xml diff -u phpdoc-it/reference/filesystem/functions/fscanf.xml:1.2 phpdoc-it/reference/filesystem/functions/fscanf.xml:1.3 --- phpdoc-it/reference/filesystem/functions/fscanf.xml:1.2 Wed Apr 17 03:06:38 2002 +++ phpdoc-it/reference/filesystem/functions/fscanf.xml Fri Feb 6 15:42:01 2004 @@ -1,7 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- splitted from ./it/functions/filesystem.xml, last change in rev 1.15 --> -<!-- last change to 'fscanf' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: cortesi Status: working --> +<!-- EN-Revision: 1.11 Maintainer: cortesi Status: working --> <!-- OLD-Revision: 1.134/EN.1.2 --> <refentry id="function.fscanf"> <refnamediv> @@ -12,7 +10,7 @@ <title>Descrizione</title> <methodsynopsis> <type>mixed</type><methodname>fscanf</methodname> - <methodparam><type>int</type><parameter>handle</parameter></methodparam> + <methodparam><type>resource</type><parameter>handle</parameter></methodparam> <methodparam><type>string</type><parameter>format</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>var1</parameter></methodparam> </methodsynopsis> @@ -21,36 +19,53 @@ <function>sscanf</function>, ma prende il proprio input da un file associato con <parameter>handle</parameter> e interpreta l'input in accordo con il parametro - <parameter>format</parameter>. Se vengono passati solo due parametri + <parameter>format</parameter>, che viene descritto nella documentazione della funzione + <function>sprintf</function>. Se vengono passati solo due parametri a questa funzione, i valori esaminati verranno restituiti in un vettore. Altrimenti, se vengono passati i parametri opzionali, la funzione restituirà il numero dei valori assegnati. I parametri opzionali devono essere passati da reference. + </para> + <para> + Ogni spazio nella stringa di formato identifica uno spazio nel flusso + di input. Questo significa che anche i tab <literal>\t</literal> presenti nella stringa + di formato possono identiicare uno spazio nel flusso di input. + </para> + <para> <example> <title>Esempio di <function>fscanf</function></title> <programlisting role="php"> <![CDATA[ -$fp = fopen ("users.txt","r"); -while ($userinfo = fscanf ($fp, "%s\t%s\t%s\n")) { +<?php +$handle = fopen("users.txt", "r"); +while ($userinfo = fscanf ($handle, "%s\t%s\t%s\n")) { list ($name, $profession, $countrycode) = $userinfo; //... fai quacosa coi valori ... } -fclose($fp); +fclose($handle); +?> ]]> </programlisting> </example> <example> <title>users.txt</title> - <programlisting> + <screen> <![CDATA[ javier argonaut pe hiroshi sculptor jp robert slacker us luigi florist it ]]> - </programlisting> + </screen> </example> </para> + <note> + <simpara> + Nelle versioni di PHP precedenti alla 4.3.0, il numero massimo di caratteri + letti da un file era di 512 (o fino al primo \n, dipende da quale si incontra prima). + Dal PHP 4.3.0 si possono esaminare linee di lunghezza arbitraria. + </simpara> + </note> <para> Vedere anche <function>fread</function>, <function>fgets</function>, <function>fgetss</function>, <function>sscanf</function>, http://cvs.php.net/diff.php/phpdoc-it/reference/filesystem/functions/ftell.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/filesystem/functions/ftell.xml diff -u phpdoc-it/reference/filesystem/functions/ftell.xml:1.2 phpdoc-it/reference/filesystem/functions/ftell.xml:1.3 --- phpdoc-it/reference/filesystem/functions/ftell.xml:1.2 Wed Apr 17 03:06:38 2002 +++ phpdoc-it/reference/filesystem/functions/ftell.xml Fri Feb 6 15:42:01 2004 @@ -1,7 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- splitted from ./it/functions/filesystem.xml, last change in rev 1.15 --> -<!-- last change to 'ftell' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: cortesi Status: working --> +<!-- EN-Revision: 1.6 Maintainer: cortesi Status: working --> <!-- OLD-Revision: 1.134/EN.1.2 --> <refentry id="function.ftell"> <refnamediv> @@ -12,20 +10,41 @@ <title>Descrizione</title> <methodsynopsis> <type>int</type><methodname>ftell</methodname> - <methodparam><type>int</type><parameter>fp</parameter></methodparam> + <methodparam><type>resource</type><parameter>handle</parameter></methodparam> </methodsynopsis> <para> - Restituisce la posizione del puntatore al file indicato da fp; cioè, + Restituisce la posizione del puntatore al file indicato da <parameter>handle</parameter>; cioè, il suo offset all'interno del flusso del file. </para> <para> Se si verifica un errore, restituisce &false;. </para> <para> - Il puntatore al file deve essere valido e deve puntare ad un file + Il puntatore al file deve essere valido e deve puntare ad un file aperto correttamente da <function>fopen</function> o da <function>popen</function>. </para> + <para> + <example> + <title>Esempio di uso di <function>ftell</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + +// apre un file e legge alcuni dati +$fp = fopen("/etc/passwd", "r"); +$data = fgets($fp, 12); + +// where are we ? +echo ftell($fp); // 11 + +fclose($fp); + +?> +]]> + </programlisting> + </example> + </para> <para> Vedere anche <function>fopen</function>, <function>popen</function>, <function>fseek</function> e <function>rewind</function>. http://cvs.php.net/diff.php/phpdoc-it/reference/filesystem/functions/is-dir.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-it/reference/filesystem/functions/is-dir.xml diff -u phpdoc-it/reference/filesystem/functions/is-dir.xml:1.3 phpdoc-it/reference/filesystem/functions/is-dir.xml:1.4 --- phpdoc-it/reference/filesystem/functions/is-dir.xml:1.3 Tue Apr 23 05:40:41 2002 +++ phpdoc-it/reference/filesystem/functions/is-dir.xml Fri Feb 6 15:42:01 2004 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.3 Maintainer: cortesi Status: working --> +<!-- EN-Revision: 1.9 Maintainer: cortesi Status: working --> <!-- splitted from ./it/functions/filesystem.xml, last change in rev 1.15 --> <refentry id="function.is-dir"> <refnamediv> @@ -17,17 +17,36 @@ <parameter>filename</parameter> è un nome file relativo, verrà controllato relativamente alla directory di lavoro in uso. </para> + ¬e.clearstatcache; <para> - I risultati di questa funzione vengono memorizzati nella cache. Vedi - <function>clearstatcache</function> per maggiori informazioni. + <example> + <title>Esempio di uso di <function>is_dir</function></title> + <programlisting role="php"> +<![CDATA[ +<? +var_dump(is_dir('a_file.txt')) . "\n"; +var_dump(is_dir('bogus_dir/abc')) . "\n"; +var_dump(is_dir('..')); //su di una dir +?> +]]> + </programlisting> + <para> + L'esempio precedente visualizzerà: + </para> + <screen> +<![CDATA[ +bool(false) +bool(false) +bool(true) +]]> + </screen> + </example> </para> - <simpara> - Questa funzione non lavora con i <link - linkend="features.remote-files">file remoti</link>; i file da - esaminare devono essere accessibili attraverso il filesystem del server. - </simpara> + &tip.fopen-wrapper.stat; + <para> - Vedere anche <function>chdir</function>, <function>is_file</function> e + Vedere anche <function>chdir</function>, <link linkend="class.dir">dir</link>, + <function>opendir</function>, <function>is_file</function> e <function>is_link</function>. </para> </refsect1> http://cvs.php.net/diff.php/phpdoc-it/reference/filesystem/functions/is-executable.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/filesystem/functions/is-executable.xml diff -u phpdoc-it/reference/filesystem/functions/is-executable.xml:1.2 phpdoc-it/reference/filesystem/functions/is-executable.xml:1.3 --- phpdoc-it/reference/filesystem/functions/is-executable.xml:1.2 Wed Apr 17 03:06:39 2002 +++ phpdoc-it/reference/filesystem/functions/is-executable.xml Fri Feb 6 15:42:01 2004 @@ -1,8 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- splitted from ./it/functions/filesystem.xml, last change in rev 1.15 --> -<!-- last change to 'is-executable' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: cortesi Status: working --> -<!-- OLD-Revision: 1.134/EN.1.2 --> +<!-- EN-Revision: 1.10 Maintainer: cortesi Status: working --> <refentry id="function.is-executable"> <refnamediv> <refname>is_executable</refname> @@ -18,14 +15,33 @@ Restituisce &true; se il filename esiste ed è un eseguibile. </para> <para> - I risultati di questa funzione vengono memorizzati nella cache. Vedi - <function>clearstatcache</function> per maggiori informazioni. + La funzione <function>is_executable</function> sarà disponibile sui sistemi Windows + a partire dalla versione 5.0.0 di PHP. </para> - <simpara> - Questa funzione non lavora con i <link - linkend="features.remote-files">file remoti</link>; i file da - esaminare devono essere accessibili attraverso il filesystem del server. - </simpara> + <para> + <example> + <title>Esempio di uso di <function>is_executable</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + +$file = '/home/vincent/somefile.sh'; + +if (is_executable($file)) { + echo $file.' è eseguibile'; +} else { + echo $file.' non è eseguibile'; +} + +?> +]]> + </programlisting> + </example> + </para> + + ¬e.clearstatcache; + + &tip.fopen-wrapper.stat; <para> Vedere anche <function>is_file</function> e <function>is_link</function>. http://cvs.php.net/diff.php/phpdoc-it/reference/filesystem/functions/is-file.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/filesystem/functions/is-file.xml diff -u phpdoc-it/reference/filesystem/functions/is-file.xml:1.2 phpdoc-it/reference/filesystem/functions/is-file.xml:1.3 --- phpdoc-it/reference/filesystem/functions/is-file.xml:1.2 Wed Apr 17 03:06:39 2002 +++ phpdoc-it/reference/filesystem/functions/is-file.xml Fri Feb 6 15:42:01 2004 @@ -1,8 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- splitted from ./it/functions/filesystem.xml, last change in rev 1.15 --> -<!-- last change to 'is-file' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: cortesi Status: working --> -<!-- OLD-Revision: 1.134/EN.1.2 --> +<!-- EN-Revision: 1.6 Maintainer: cortesi Status: working --> <refentry id="function.is-file"> <refnamediv> <refname>is_file</refname> @@ -17,10 +14,10 @@ <para> Restituisce &true; se il filename esiste ed è un file regolare. </para> - <para> - I risultati di questa funzione vengono memorizzati nella cache. Vedi - <function>clearstatcache</function> per maggiori informazioni. - </para> + ¬e.clearstatcache; + + &tip.fopen-wrapper.stat; + <para> Vedere anche <function>is_dir</function> e <function>is_link</function>. http://cvs.php.net/diff.php/phpdoc-it/reference/filesystem/functions/is-link.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/filesystem/functions/is-link.xml diff -u phpdoc-it/reference/filesystem/functions/is-link.xml:1.2 phpdoc-it/reference/filesystem/functions/is-link.xml:1.3 --- phpdoc-it/reference/filesystem/functions/is-link.xml:1.2 Wed Apr 17 03:06:39 2002 +++ phpdoc-it/reference/filesystem/functions/is-link.xml Fri Feb 6 15:42:01 2004 @@ -1,8 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- splitted from ./it/functions/filesystem.xml, last change in rev 1.15 --> -<!-- last change to 'is-link' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: cortesi Status: working --> -<!-- OLD-Revision: 1.134/EN.1.2 --> +<!-- EN-Revision: 1.6 Maintainer: cortesi Status: working --> <refentry id="function.is-link"> <refnamediv> <refname>is_link</refname> @@ -17,20 +14,15 @@ <para> Restituisce &true; se il filename esiste ed è un link simbolico. </para> - <para> - I risultati di questa funzione vengono memorizzati nella cache. Vedi - <function>clearstatcache</function> per maggiori informazioni. - </para> + ¬e.clearstatcache; + + &tip.fopen-wrapper.stat; + <para> Vedere anche <function>is_dir</function> e <function>is_file</function>. </para> - <simpara> - Questa funzione non lavora con i <link - linkend="features.remote-files">file remoti</link>; i file da - esaminare devono essere accessibili attraverso il filesystem del server. - </simpara> - ¬e.no-windows; + </refsect1> </refentry> http://cvs.php.net/diff.php/phpdoc-it/reference/filesystem/functions/is-readable.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/filesystem/functions/is-readable.xml diff -u phpdoc-it/reference/filesystem/functions/is-readable.xml:1.2 phpdoc-it/reference/filesystem/functions/is-readable.xml:1.3 --- phpdoc-it/reference/filesystem/functions/is-readable.xml:1.2 Wed Apr 17 03:06:39 2002 +++ phpdoc-it/reference/filesystem/functions/is-readable.xml Fri Feb 6 15:42:01 2004 @@ -1,8 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- splitted from ./it/functions/filesystem.xml, last change in rev 1.15 --> -<!-- last change to 'is-readable' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: cortesi Status: working --> -<!-- OLD-Revision: 1.134/EN.1.2 --> +<!-- EN-Revision: 1.5 Maintainer: cortesi Status: working --> <refentry id="function.is-readable"> <refnamediv> <refname>is_readable</refname> @@ -22,17 +19,14 @@ server (spesso 'nobody'). Non sono prese in conto limitazione di sicurezza. </para> + ¬e.clearstatcache; + + &tip.fopen-wrapper.stat; + <para> - I risultati di questa funzione vengono memorizzati nella cache. Vedi - <function>clearstatcache</function> per maggiori informazioni. - </para> - <simpara> - Questa funzione non lavora con i <link - linkend="features.remote-files">file remoti</link>; i file da - esaminare devono essere accessibili attraverso il filesystem del server. - </simpara> - <para> - Vedere anche <function>is_writable</function>. + Vedere anche <function>is_writable</function>, + <function>file_exists</function> e + <function>fgets</function>. </para> </refsect1> </refentry> http://cvs.php.net/diff.php/phpdoc-it/reference/filesystem/functions/is-uploaded-file.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/filesystem/functions/is-uploaded-file.xml diff -u phpdoc-it/reference/filesystem/functions/is-uploaded-file.xml:1.2 phpdoc-it/reference/filesystem/functions/is-uploaded-file.xml:1.3 --- phpdoc-it/reference/filesystem/functions/is-uploaded-file.xml:1.2 Wed Apr 17 03:06:39 2002 +++ phpdoc-it/reference/filesystem/functions/is-uploaded-file.xml Fri Feb 6 15:42:01 2004 @@ -1,8 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- splitted from ./it/functions/filesystem.xml, last change in rev 1.15 --> -<!-- last change to 'is-uploaded-file' in en/ tree in rev 1.39 --> -<!-- EN-Revision: 1.2 Maintainer: cortesi Status: working --> -<!-- OLD-Revision: 1.134/EN.1.39 --> +<!-- EN-Revision: 1.3 Maintainer: cortesi Status: working --> <refentry id="function.is-uploaded-file"> <refnamediv> <refname>is_uploaded_file</refname> @@ -15,7 +12,7 @@ <methodparam><type>string</type><parameter>filename</parameter></methodparam> </methodsynopsis> <para> - Returns &true; if the file named by <varname>filename</varname> was + Returns &true; if the file named by <parameter>filename</parameter> was uploaded via HTTP POST. This is useful to help ensure that a malicious user hasn't tried to trick the script into working on files upon which it should not be working--for instance, http://cvs.php.net/diff.php/phpdoc-it/reference/filesystem/functions/is-writable.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/filesystem/functions/is-writable.xml diff -u phpdoc-it/reference/filesystem/functions/is-writable.xml:1.2 phpdoc-it/reference/filesystem/functions/is-writable.xml:1.3 --- phpdoc-it/reference/filesystem/functions/is-writable.xml:1.2 Wed Apr 17 03:06:39 2002 +++ phpdoc-it/reference/filesystem/functions/is-writable.xml Fri Feb 6 15:42:01 2004 @@ -1,8 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- splitted from ./it/functions/filesystem.xml, last change in rev 1.15 --> -<!-- last change to 'is-writable' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: cortesi Status: working --> -<!-- OLD-Revision: 1.134/EN.1.2 --> +<!-- EN-Revision: 1.6 Maintainer: cortesi Status: working --> <refentry id="function.is-writable"> <refnamediv> <refname>is_writable</refname> @@ -15,7 +12,7 @@ <methodparam><type>string</type><parameter>filename</parameter></methodparam> </methodsynopsis> <para> - Restituisce &true; se filename esiste ed è scrivibile. L'argomento + Restituisce &true; se <parameter>filename</parameter> esiste ed è scrivibile. L'argomento filename può essere un nome di directory che ti permetta di verificare se una directory è scrivibile. </para> @@ -24,17 +21,14 @@ del web server (spesso 'nobody'). Non sono prese in considerazioni limitazioni di sicurezza. </para> + ¬e.clearstatcache; + + &tip.fopen-wrapper.stat; + <para> - I risultati di questa funzione vengono memorizzati nella cache. Vedi - <function>clearstatcache</function> per maggiori informazioni. - </para> - <simpara> - Questa funzione non lavora con i <link - linkend="features.remote-files">file remoti</link>; i file da - esaminare devono essere accessibili attraverso il filesystem del server. - </simpara> - <para> - Vedere anche <function>is_readable</function>. + Vedere anche <function>is_readable</function>, + <function>file_exists</function> e + <function>fwrite</function>. </para> </refsect1> </refentry> http://cvs.php.net/diff.php/phpdoc-it/reference/filesystem/functions/is-writeable.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/filesystem/functions/is-writeable.xml diff -u phpdoc-it/reference/filesystem/functions/is-writeable.xml:1.2 phpdoc-it/reference/filesystem/functions/is-writeable.xml:1.3 --- phpdoc-it/reference/filesystem/functions/is-writeable.xml:1.2 Wed Apr 17 03:06:40 2002 +++ phpdoc-it/reference/filesystem/functions/is-writeable.xml Fri Feb 6 15:42:01 2004 @@ -1,19 +1,12 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- splitted from ./it/functions/filesystem.xml, last change in rev 1.15 --> -<!-- last change to 'is-writeable' in en/ tree in rev 1.55 --> -<!-- EN-Revision: 1.2 Maintainer: cortesi Status: working --> -<!-- OLD-Revision: 1.134/EN.1.55 --> +<!-- EN-Revision: 1.3 Maintainer: cortesi Status: working --> <refentry id="function.is-writeable"> <refnamediv> <refname>is_writeable</refname> - <refpurpose>Dice se un file è scrivibile</refpurpose> + <refpurpose>Alias di <function>is_writable</function></refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> - <methodsynopsis> - <type>bool</type><methodname>is_writeable</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - </methodsynopsis> <para> Questo è un alias per <function>is_writable</function> </para> http://cvs.php.net/diff.php/phpdoc-it/reference/filesystem/functions/link.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/filesystem/functions/link.xml diff -u phpdoc-it/reference/filesystem/functions/link.xml:1.2 phpdoc-it/reference/filesystem/functions/link.xml:1.3 --- phpdoc-it/reference/filesystem/functions/link.xml:1.2 Wed Apr 17 03:06:40 2002 +++ phpdoc-it/reference/filesystem/functions/link.xml Fri Feb 6 15:42:01 2004 @@ -1,8 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- splitted from ./it/functions/filesystem.xml, last change in rev 1.15 --> -<!-- last change to 'link' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: cortesi Status: working --> -<!-- OLD-Revision: 1.134/EN.1.2 --> +<!-- EN-Revision: 1.6 Maintainer: cortesi Status: working --> <refentry id="function.link"> <refnamediv> <refname>link</refname> @@ -11,18 +8,22 @@ <refsect1> <title>Descrizione</title> <methodsynopsis> - <type>int</type><methodname>link</methodname> + <type>bool</type><methodname>link</methodname> <methodparam><type>string</type><parameter>target</parameter></methodparam> <methodparam><type>string</type><parameter>link</parameter></methodparam> </methodsynopsis> <para> - <function>link</function> crea un hard link.</para> + <function>link</function> crea un hard link. &return.success; + </para> + + ¬e.no-remote; + <para> Vedere anche <function>symlink</function> per creare soft link, e <function>readlink</function> assieme a <function>linkinfo</function>. </para> - ¬e.no-windows; + </refsect1> </refentry> http://cvs.php.net/diff.php/phpdoc-it/reference/filesystem/functions/linkinfo.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/filesystem/functions/linkinfo.xml diff -u phpdoc-it/reference/filesystem/functions/linkinfo.xml:1.2 phpdoc-it/reference/filesystem/functions/linkinfo.xml:1.3 --- phpdoc-it/reference/filesystem/functions/linkinfo.xml:1.2 Wed Apr 17 03:06:40 2002 +++ phpdoc-it/reference/filesystem/functions/linkinfo.xml Fri Feb 6 15:42:01 2004 @@ -1,8 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- splitted from ./it/functions/filesystem.xml, last change in rev 1.15 --> -<!-- last change to 'linkinfo' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: cortesi Status: working --> -<!-- OLD-Revision: 1.134/EN.1.2 --> +<!-- EN-Revision: 1.5 Maintainer: cortesi Status: working --> <refentry id="function.linkinfo"> <refnamediv> <refname>linkinfo</refname> @@ -16,17 +13,30 @@ </methodsynopsis> <para> <function>linkinfo</function> restituisce il campo st_dev della struttura stat - dello UNIX C restituita dalla chiamata di sistema lstat. Questa funzione è usata + dello Unix C restituita dalla chiamata di sistema lstat. Questa funzione è usata per verificare se un link (puntato da <parameter>path</parameter>) esiste davvero (usando lo stesso metodo della macro S_ISLNK definita in stat.h). Restituisce 0 o &false; in caso di errore. </para> <para> + <example> + <title>Esempio di uso di <function>linkinfo</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + +echo linkinfo('/vmlinuz'); // 835 + +?> +]]> + </programlisting> + </example> + </para> + <para> Vedere anche <function>symlink</function>, <function>link</function> e <function>readlink</function>. </para> - ¬e.no-windows; </refsect1> </refentry> http://cvs.php.net/diff.php/phpdoc-it/reference/filesystem/functions/move-uploaded-file.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/filesystem/functions/move-uploaded-file.xml diff -u phpdoc-it/reference/filesystem/functions/move-uploaded-file.xml:1.2 phpdoc-it/reference/filesystem/functions/move-uploaded-file.xml:1.3 --- phpdoc-it/reference/filesystem/functions/move-uploaded-file.xml:1.2 Wed Apr 17 03:06:40 2002 +++ phpdoc-it/reference/filesystem/functions/move-uploaded-file.xml Fri Feb 6 15:42:01 2004 @@ -1,8 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- splitted from ./it/functions/filesystem.xml, last change in rev 1.15 --> -<!-- last change to 'move-uploaded-file' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: cortesi Status: working --> -<!-- OLD-Revision: 1.134/EN.1.2 --> +<!-- EN-Revision: 1.3 Maintainer: cortesi Status: working --> <refentry id="function.move-uploaded-file"> <refnamediv> <refname>move_uploaded_file</refname> @@ -43,15 +40,15 @@ ¬e.sm.uidcheck; <note> <para> - <function>move_uploaded_file</function> is not affected by the normal - safe-mode UID-restrictions. This is not unsafe because - <function>move_uploaded_file</function> only operates on files uploaded + <function>move_uploaded_file</function> non è limitato dalle normali restrizioni + del &safemode; UID. QCiò non è insicuro poichè + <function>move_uploaded_file</function> operara solo sui file uplodati via PHP. </para> </note> <warning> <para> - If the destination file already exists, it will be overwritten. + Se il file di destinazione esiste, sarà sovrascritto. </para> </warning> <para>
http://cvs.php.net/diff.php/phpdoc-it/reference/filesystem/functions/fscanf.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/filesystem/functions/fscanf.xml diff -u phpdoc-it/reference/filesystem/functions/fscanf.xml:1.2 phpdoc-it/reference/filesystem/functions/fscanf.xml:1.3 --- phpdoc-it/reference/filesystem/functions/fscanf.xml:1.2 Wed Apr 17 03:06:38 2002 +++ phpdoc-it/reference/filesystem/functions/fscanf.xml Fri Feb 6 15:42:01 2004 @@ -1,7 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- splitted from ./it/functions/filesystem.xml, last change in rev 1.15 --> -<!-- last change to 'fscanf' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: cortesi Status: working --> +<!-- EN-Revision: 1.11 Maintainer: cortesi Status: working --> <!-- OLD-Revision: 1.134/EN.1.2 --> <refentry id="function.fscanf"> <refnamediv> @@ -12,7 +10,7 @@ <title>Descrizione</title> <methodsynopsis> <type>mixed</type><methodname>fscanf</methodname> - <methodparam><type>int</type><parameter>handle</parameter></methodparam> + <methodparam><type>resource</type><parameter>handle</parameter></methodparam> <methodparam><type>string</type><parameter>format</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>var1</parameter></methodparam> </methodsynopsis> @@ -21,36 +19,53 @@ <function>sscanf</function>, ma prende il proprio input da un file associato con <parameter>handle</parameter> e interpreta l'input in accordo con il parametro - <parameter>format</parameter>. Se vengono passati solo due parametri + <parameter>format</parameter>, che viene descritto nella documentazione della funzione + <function>sprintf</function>. Se vengono passati solo due parametri a questa funzione, i valori esaminati verranno restituiti in un vettore. Altrimenti, se vengono passati i parametri opzionali, la funzione restituirà il numero dei valori assegnati. I parametri opzionali devono essere passati da reference. + </para> + <para> + Ogni spazio nella stringa di formato identifica uno spazio nel flusso + di input. Questo significa che anche i tab <literal>\t</literal> presenti nella stringa + di formato possono identiicare uno spazio nel flusso di input. + </para> + <para> <example> <title>Esempio di <function>fscanf</function></title> <programlisting role="php"> <![CDATA[ -$fp = fopen ("users.txt","r"); -while ($userinfo = fscanf ($fp, "%s\t%s\t%s\n")) { +<?php +$handle = fopen("users.txt", "r"); +while ($userinfo = fscanf ($handle, "%s\t%s\t%s\n")) { list ($name, $profession, $countrycode) = $userinfo; //... fai quacosa coi valori ... } -fclose($fp); +fclose($handle); +?> ]]> </programlisting> </example> <example> <title>users.txt</title> - <programlisting> + <screen> <![CDATA[ javier argonaut pe hiroshi sculptor jp robert slacker us luigi florist it ]]> - </programlisting> + </screen> </example> </para> + <note> + <simpara> + Nelle versioni di PHP precedenti alla 4.3.0, il numero massimo di caratteri + letti da un file era di 512 (o fino al primo \n, dipende da quale si incontra prima). + Dal PHP 4.3.0 si possono esaminare linee di lunghezza arbitraria. + </simpara> + </note> <para> Vedere anche <function>fread</function>, <function>fgets</function>, <function>fgetss</function>, <function>sscanf</function>, http://cvs.php.net/diff.php/phpdoc-it/reference/filesystem/functions/ftell.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/filesystem/functions/ftell.xml diff -u phpdoc-it/reference/filesystem/functions/ftell.xml:1.2 phpdoc-it/reference/filesystem/functions/ftell.xml:1.3 --- phpdoc-it/reference/filesystem/functions/ftell.xml:1.2 Wed Apr 17 03:06:38 2002 +++ phpdoc-it/reference/filesystem/functions/ftell.xml Fri Feb 6 15:42:01 2004 @@ -1,7 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- splitted from ./it/functions/filesystem.xml, last change in rev 1.15 --> -<!-- last change to 'ftell' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: cortesi Status: working --> +<!-- EN-Revision: 1.6 Maintainer: cortesi Status: working --> <!-- OLD-Revision: 1.134/EN.1.2 --> <refentry id="function.ftell"> <refnamediv> @@ -12,20 +10,41 @@ <title>Descrizione</title> <methodsynopsis> <type>int</type><methodname>ftell</methodname> - <methodparam><type>int</type><parameter>fp</parameter></methodparam> + <methodparam><type>resource</type><parameter>handle</parameter></methodparam> </methodsynopsis> <para> - Restituisce la posizione del puntatore al file indicato da fp; cioè, + Restituisce la posizione del puntatore al file indicato da <parameter>handle</parameter>; cioè, il suo offset all'interno del flusso del file. </para> <para> Se si verifica un errore, restituisce &false;. </para> <para> - Il puntatore al file deve essere valido e deve puntare ad un file + Il puntatore al file deve essere valido e deve puntare ad un file aperto correttamente da <function>fopen</function> o da <function>popen</function>. </para> + <para> + <example> + <title>Esempio di uso di <function>ftell</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + +// apre un file e legge alcuni dati +$fp = fopen("/etc/passwd", "r"); +$data = fgets($fp, 12); + +// where are we ? +echo ftell($fp); // 11 + +fclose($fp); + +?> +]]> + </programlisting> + </example> + </para> <para> Vedere anche <function>fopen</function>, <function>popen</function>, <function>fseek</function> e <function>rewind</function>. http://cvs.php.net/diff.php/phpdoc-it/reference/filesystem/functions/is-dir.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-it/reference/filesystem/functions/is-dir.xml diff -u phpdoc-it/reference/filesystem/functions/is-dir.xml:1.3 phpdoc-it/reference/filesystem/functions/is-dir.xml:1.4 --- phpdoc-it/reference/filesystem/functions/is-dir.xml:1.3 Tue Apr 23 05:40:41 2002 +++ phpdoc-it/reference/filesystem/functions/is-dir.xml Fri Feb 6 15:42:01 2004 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.3 Maintainer: cortesi Status: working --> +<!-- EN-Revision: 1.9 Maintainer: cortesi Status: working --> <!-- splitted from ./it/functions/filesystem.xml, last change in rev 1.15 --> <refentry id="function.is-dir"> <refnamediv> @@ -17,17 +17,36 @@ <parameter>filename</parameter> è un nome file relativo, verrà controllato relativamente alla directory di lavoro in uso. </para> + ¬e.clearstatcache; <para> - I risultati di questa funzione vengono memorizzati nella cache. Vedi - <function>clearstatcache</function> per maggiori informazioni. + <example> + <title>Esempio di uso di <function>is_dir</function></title> + <programlisting role="php"> +<![CDATA[ +<? +var_dump(is_dir('a_file.txt')) . "\n"; +var_dump(is_dir('bogus_dir/abc')) . "\n"; +var_dump(is_dir('..')); //su di una dir +?> +]]> + </programlisting> + <para> + L'esempio precedente visualizzerà: + </para> + <screen> +<![CDATA[ +bool(false) +bool(false) +bool(true) +]]> + </screen> + </example> </para> - <simpara> - Questa funzione non lavora con i <link - linkend="features.remote-files">file remoti</link>; i file da - esaminare devono essere accessibili attraverso il filesystem del server. - </simpara> + &tip.fopen-wrapper.stat; + <para> - Vedere anche <function>chdir</function>, <function>is_file</function> e + Vedere anche <function>chdir</function>, <link linkend="class.dir">dir</link>, + <function>opendir</function>, <function>is_file</function> e <function>is_link</function>. </para> </refsect1> http://cvs.php.net/diff.php/phpdoc-it/reference/filesystem/functions/is-executable.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/filesystem/functions/is-executable.xml diff -u phpdoc-it/reference/filesystem/functions/is-executable.xml:1.2 phpdoc-it/reference/filesystem/functions/is-executable.xml:1.3 --- phpdoc-it/reference/filesystem/functions/is-executable.xml:1.2 Wed Apr 17 03:06:39 2002 +++ phpdoc-it/reference/filesystem/functions/is-executable.xml Fri Feb 6 15:42:01 2004 @@ -1,8 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- splitted from ./it/functions/filesystem.xml, last change in rev 1.15 --> -<!-- last change to 'is-executable' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: cortesi Status: working --> -<!-- OLD-Revision: 1.134/EN.1.2 --> +<!-- EN-Revision: 1.10 Maintainer: cortesi Status: working --> <refentry id="function.is-executable"> <refnamediv> <refname>is_executable</refname> @@ -18,14 +15,33 @@ Restituisce &true; se il filename esiste ed è un eseguibile. </para> <para> - I risultati di questa funzione vengono memorizzati nella cache. Vedi - <function>clearstatcache</function> per maggiori informazioni. + La funzione <function>is_executable</function> sarà disponibile sui sistemi Windows + a partire dalla versione 5.0.0 di PHP. </para> - <simpara> - Questa funzione non lavora con i <link - linkend="features.remote-files">file remoti</link>; i file da - esaminare devono essere accessibili attraverso il filesystem del server. - </simpara> + <para> + <example> + <title>Esempio di uso di <function>is_executable</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + +$file = '/home/vincent/somefile.sh'; + +if (is_executable($file)) { + echo $file.' è eseguibile'; +} else { + echo $file.' non è eseguibile'; +} + +?> +]]> + </programlisting> + </example> + </para> + + ¬e.clearstatcache; + + &tip.fopen-wrapper.stat; <para> Vedere anche <function>is_file</function> e <function>is_link</function>. http://cvs.php.net/diff.php/phpdoc-it/reference/filesystem/functions/is-file.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/filesystem/functions/is-file.xml diff -u phpdoc-it/reference/filesystem/functions/is-file.xml:1.2 phpdoc-it/reference/filesystem/functions/is-file.xml:1.3 --- phpdoc-it/reference/filesystem/functions/is-file.xml:1.2 Wed Apr 17 03:06:39 2002 +++ phpdoc-it/reference/filesystem/functions/is-file.xml Fri Feb 6 15:42:01 2004 @@ -1,8 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- splitted from ./it/functions/filesystem.xml, last change in rev 1.15 --> -<!-- last change to 'is-file' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: cortesi Status: working --> -<!-- OLD-Revision: 1.134/EN.1.2 --> +<!-- EN-Revision: 1.6 Maintainer: cortesi Status: working --> <refentry id="function.is-file"> <refnamediv> <refname>is_file</refname> @@ -17,10 +14,10 @@ <para> Restituisce &true; se il filename esiste ed è un file regolare. </para> - <para> - I risultati di questa funzione vengono memorizzati nella cache. Vedi - <function>clearstatcache</function> per maggiori informazioni. - </para> + ¬e.clearstatcache; + + &tip.fopen-wrapper.stat; + <para> Vedere anche <function>is_dir</function> e <function>is_link</function>. http://cvs.php.net/diff.php/phpdoc-it/reference/filesystem/functions/is-link.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/filesystem/functions/is-link.xml diff -u phpdoc-it/reference/filesystem/functions/is-link.xml:1.2 phpdoc-it/reference/filesystem/functions/is-link.xml:1.3 --- phpdoc-it/reference/filesystem/functions/is-link.xml:1.2 Wed Apr 17 03:06:39 2002 +++ phpdoc-it/reference/filesystem/functions/is-link.xml Fri Feb 6 15:42:01 2004 @@ -1,8 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- splitted from ./it/functions/filesystem.xml, last change in rev 1.15 --> -<!-- last change to 'is-link' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: cortesi Status: working --> -<!-- OLD-Revision: 1.134/EN.1.2 --> +<!-- EN-Revision: 1.6 Maintainer: cortesi Status: working --> <refentry id="function.is-link"> <refnamediv> <refname>is_link</refname> @@ -17,20 +14,15 @@ <para> Restituisce &true; se il filename esiste ed è un link simbolico. </para> - <para> - I risultati di questa funzione vengono memorizzati nella cache. Vedi - <function>clearstatcache</function> per maggiori informazioni. - </para> + ¬e.clearstatcache; + + &tip.fopen-wrapper.stat; + <para> Vedere anche <function>is_dir</function> e <function>is_file</function>. </para> - <simpara> - Questa funzione non lavora con i <link - linkend="features.remote-files">file remoti</link>; i file da - esaminare devono essere accessibili attraverso il filesystem del server. - </simpara> - ¬e.no-windows; + </refsect1> </refentry> http://cvs.php.net/diff.php/phpdoc-it/reference/filesystem/functions/is-readable.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/filesystem/functions/is-readable.xml diff -u phpdoc-it/reference/filesystem/functions/is-readable.xml:1.2 phpdoc-it/reference/filesystem/functions/is-readable.xml:1.3 --- phpdoc-it/reference/filesystem/functions/is-readable.xml:1.2 Wed Apr 17 03:06:39 2002 +++ phpdoc-it/reference/filesystem/functions/is-readable.xml Fri Feb 6 15:42:01 2004 @@ -1,8 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- splitted from ./it/functions/filesystem.xml, last change in rev 1.15 --> -<!-- last change to 'is-readable' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: cortesi Status: working --> -<!-- OLD-Revision: 1.134/EN.1.2 --> +<!-- EN-Revision: 1.5 Maintainer: cortesi Status: working --> <refentry id="function.is-readable"> <refnamediv> <refname>is_readable</refname> @@ -22,17 +19,14 @@ server (spesso 'nobody'). Non sono prese in conto limitazione di sicurezza. </para> + ¬e.clearstatcache; + + &tip.fopen-wrapper.stat; + <para> - I risultati di questa funzione vengono memorizzati nella cache. Vedi - <function>clearstatcache</function> per maggiori informazioni. - </para> - <simpara> - Questa funzione non lavora con i <link - linkend="features.remote-files">file remoti</link>; i file da - esaminare devono essere accessibili attraverso il filesystem del server. - </simpara> - <para> - Vedere anche <function>is_writable</function>. + Vedere anche <function>is_writable</function>, + <function>file_exists</function> e + <function>fgets</function>. </para> </refsect1> </refentry> http://cvs.php.net/diff.php/phpdoc-it/reference/filesystem/functions/is-uploaded-file.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/filesystem/functions/is-uploaded-file.xml diff -u phpdoc-it/reference/filesystem/functions/is-uploaded-file.xml:1.2 phpdoc-it/reference/filesystem/functions/is-uploaded-file.xml:1.3 --- phpdoc-it/reference/filesystem/functions/is-uploaded-file.xml:1.2 Wed Apr 17 03:06:39 2002 +++ phpdoc-it/reference/filesystem/functions/is-uploaded-file.xml Fri Feb 6 15:42:01 2004 @@ -1,8 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- splitted from ./it/functions/filesystem.xml, last change in rev 1.15 --> -<!-- last change to 'is-uploaded-file' in en/ tree in rev 1.39 --> -<!-- EN-Revision: 1.2 Maintainer: cortesi Status: working --> -<!-- OLD-Revision: 1.134/EN.1.39 --> +<!-- EN-Revision: 1.3 Maintainer: cortesi Status: working --> <refentry id="function.is-uploaded-file"> <refnamediv> <refname>is_uploaded_file</refname> @@ -15,7 +12,7 @@ <methodparam><type>string</type><parameter>filename</parameter></methodparam> </methodsynopsis> <para> - Returns &true; if the file named by <varname>filename</varname> was + Returns &true; if the file named by <parameter>filename</parameter> was uploaded via HTTP POST. This is useful to help ensure that a malicious user hasn't tried to trick the script into working on files upon which it should not be working--for instance, http://cvs.php.net/diff.php/phpdoc-it/reference/filesystem/functions/is-writable.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/filesystem/functions/is-writable.xml diff -u phpdoc-it/reference/filesystem/functions/is-writable.xml:1.2 phpdoc-it/reference/filesystem/functions/is-writable.xml:1.3 --- phpdoc-it/reference/filesystem/functions/is-writable.xml:1.2 Wed Apr 17 03:06:39 2002 +++ phpdoc-it/reference/filesystem/functions/is-writable.xml Fri Feb 6 15:42:01 2004 @@ -1,8 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- splitted from ./it/functions/filesystem.xml, last change in rev 1.15 --> -<!-- last change to 'is-writable' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: cortesi Status: working --> -<!-- OLD-Revision: 1.134/EN.1.2 --> +<!-- EN-Revision: 1.6 Maintainer: cortesi Status: working --> <refentry id="function.is-writable"> <refnamediv> <refname>is_writable</refname> @@ -15,7 +12,7 @@ <methodparam><type>string</type><parameter>filename</parameter></methodparam> </methodsynopsis> <para> - Restituisce &true; se filename esiste ed è scrivibile. L'argomento + Restituisce &true; se <parameter>filename</parameter> esiste ed è scrivibile. L'argomento filename può essere un nome di directory che ti permetta di verificare se una directory è scrivibile. </para> @@ -24,17 +21,14 @@ del web server (spesso 'nobody'). Non sono prese in considerazioni limitazioni di sicurezza. </para> + ¬e.clearstatcache; + + &tip.fopen-wrapper.stat; + <para> - I risultati di questa funzione vengono memorizzati nella cache. Vedi - <function>clearstatcache</function> per maggiori informazioni. - </para> - <simpara> - Questa funzione non lavora con i <link - linkend="features.remote-files">file remoti</link>; i file da - esaminare devono essere accessibili attraverso il filesystem del server. - </simpara> - <para> - Vedere anche <function>is_readable</function>. + Vedere anche <function>is_readable</function>, + <function>file_exists</function> e + <function>fwrite</function>. </para> </refsect1> </refentry> http://cvs.php.net/diff.php/phpdoc-it/reference/filesystem/functions/is-writeable.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/filesystem/functions/is-writeable.xml diff -u phpdoc-it/reference/filesystem/functions/is-writeable.xml:1.2 phpdoc-it/reference/filesystem/functions/is-writeable.xml:1.3 --- phpdoc-it/reference/filesystem/functions/is-writeable.xml:1.2 Wed Apr 17 03:06:40 2002 +++ phpdoc-it/reference/filesystem/functions/is-writeable.xml Fri Feb 6 15:42:01 2004 @@ -1,19 +1,12 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- splitted from ./it/functions/filesystem.xml, last change in rev 1.15 --> -<!-- last change to 'is-writeable' in en/ tree in rev 1.55 --> -<!-- EN-Revision: 1.2 Maintainer: cortesi Status: working --> -<!-- OLD-Revision: 1.134/EN.1.55 --> +<!-- EN-Revision: 1.3 Maintainer: cortesi Status: working --> <refentry id="function.is-writeable"> <refnamediv> <refname>is_writeable</refname> - <refpurpose>Dice se un file è scrivibile</refpurpose> + <refpurpose>Alias di <function>is_writable</function></refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> - <methodsynopsis> - <type>bool</type><methodname>is_writeable</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - </methodsynopsis> <para> Questo è un alias per <function>is_writable</function> </para> http://cvs.php.net/diff.php/phpdoc-it/reference/filesystem/functions/link.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/filesystem/functions/link.xml diff -u phpdoc-it/reference/filesystem/functions/link.xml:1.2 phpdoc-it/reference/filesystem/functions/link.xml:1.3 --- phpdoc-it/reference/filesystem/functions/link.xml:1.2 Wed Apr 17 03:06:40 2002 +++ phpdoc-it/reference/filesystem/functions/link.xml Fri Feb 6 15:42:01 2004 @@ -1,8 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- splitted from ./it/functions/filesystem.xml, last change in rev 1.15 --> -<!-- last change to 'link' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: cortesi Status: working --> -<!-- OLD-Revision: 1.134/EN.1.2 --> +<!-- EN-Revision: 1.6 Maintainer: cortesi Status: working --> <refentry id="function.link"> <refnamediv> <refname>link</refname> @@ -11,18 +8,22 @@ <refsect1> <title>Descrizione</title> <methodsynopsis> - <type>int</type><methodname>link</methodname> + <type>bool</type><methodname>link</methodname> <methodparam><type>string</type><parameter>target</parameter></methodparam> <methodparam><type>string</type><parameter>link</parameter></methodparam> </methodsynopsis> <para> - <function>link</function> crea un hard link.</para> + <function>link</function> crea un hard link. &return.success; + </para> + + ¬e.no-remote; + <para> Vedere anche <function>symlink</function> per creare soft link, e <function>readlink</function> assieme a <function>linkinfo</function>. </para> - ¬e.no-windows; + </refsect1> </refentry> http://cvs.php.net/diff.php/phpdoc-it/reference/filesystem/functions/linkinfo.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/filesystem/functions/linkinfo.xml diff -u phpdoc-it/reference/filesystem/functions/linkinfo.xml:1.2 phpdoc-it/reference/filesystem/functions/linkinfo.xml:1.3 --- phpdoc-it/reference/filesystem/functions/linkinfo.xml:1.2 Wed Apr 17 03:06:40 2002 +++ phpdoc-it/reference/filesystem/functions/linkinfo.xml Fri Feb 6 15:42:01 2004 @@ -1,8 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- splitted from ./it/functions/filesystem.xml, last change in rev 1.15 --> -<!-- last change to 'linkinfo' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: cortesi Status: working --> -<!-- OLD-Revision: 1.134/EN.1.2 --> +<!-- EN-Revision: 1.5 Maintainer: cortesi Status: working --> <refentry id="function.linkinfo"> <refnamediv> <refname>linkinfo</refname> @@ -16,17 +13,30 @@ </methodsynopsis> <para> <function>linkinfo</function> restituisce il campo st_dev della struttura stat - dello UNIX C restituita dalla chiamata di sistema lstat. Questa funzione è usata + dello Unix C restituita dalla chiamata di sistema lstat. Questa funzione è usata per verificare se un link (puntato da <parameter>path</parameter>) esiste davvero (usando lo stesso metodo della macro S_ISLNK definita in stat.h). Restituisce 0 o &false; in caso di errore. </para> <para> + <example> + <title>Esempio di uso di <function>linkinfo</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + +echo linkinfo('/vmlinuz'); // 835 + +?> +]]> + </programlisting> + </example> + </para> + <para> Vedere anche <function>symlink</function>, <function>link</function> e <function>readlink</function>. </para> - ¬e.no-windows; </refsect1> </refentry> http://cvs.php.net/diff.php/phpdoc-it/reference/filesystem/functions/move-uploaded-file.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/filesystem/functions/move-uploaded-file.xml diff -u phpdoc-it/reference/filesystem/functions/move-uploaded-file.xml:1.2 phpdoc-it/reference/filesystem/functions/move-uploaded-file.xml:1.3 --- phpdoc-it/reference/filesystem/functions/move-uploaded-file.xml:1.2 Wed Apr 17 03:06:40 2002 +++ phpdoc-it/reference/filesystem/functions/move-uploaded-file.xml Fri Feb 6 15:42:01 2004 @@ -1,8 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- splitted from ./it/functions/filesystem.xml, last change in rev 1.15 --> -<!-- last change to 'move-uploaded-file' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: cortesi Status: working --> -<!-- OLD-Revision: 1.134/EN.1.2 --> +<!-- EN-Revision: 1.3 Maintainer: cortesi Status: working --> <refentry id="function.move-uploaded-file"> <refnamediv> <refname>move_uploaded_file</refname> @@ -43,15 +40,15 @@ ¬e.sm.uidcheck; <note> <para> - <function>move_uploaded_file</function> is not affected by the normal - safe-mode UID-restrictions. This is not unsafe because - <function>move_uploaded_file</function> only operates on files uploaded + <function>move_uploaded_file</function> non è limitato dalle normali restrizioni + del &safemode; UID. QCiò non è insicuro poichè + <function>move_uploaded_file</function> operara solo sui file uplodati via PHP. </para> </note> <warning> <para> - If the destination file already exists, it will be overwritten. + Se il file di destinazione esiste, sarà sovrascritto. </para> </warning> <para>