diff --git a/reference/filesystem/functions/file.xml b/reference/filesystem/functions/file.xml index 6dfdb87d3..663c25488 100644 --- a/reference/filesystem/functions/file.xml +++ b/reference/filesystem/functions/file.xml @@ -1,76 +1,206 @@ - - - - - - file - Legge l'intero file in un vettore - - - Descrizione - - arrayfile - stringfilename - intuse_include_path - resourcecontext - - - Identica a readfile, eccetto per il fatto che - file restituisce il file in un vettore. Ogni - elemento del vettore corrisponde ad una riga del file, con il carattere di - newline ancora inserito. Se la funzione non riesce restituisce - &false;. - - - Puoi impostare il secondo parametro, use_include_path, (opzionale) ad "1", - se vuoi cercare il file nel include_path. - - - - + + + + + + + file + Legge l'intero file in un array + + + + &reftitle.description; + + arrayfalsefile + stringfilename + intflags0 + resourcenullcontext&null; + + + Legge l'intero file in un array. + + + + In alternativa puoi usare file_get_contents per estrarre il contenuto + di un file sotto forma di stringa. + + + + + + &reftitle.parameters; + + + + filename + + + Percorso del file. + + &tip.fopen-wrapper; + + + + flags + + + Il parametro opzionale flags può essere uno, o + più valori, delle seguenti costanti: + + + + FILE_USE_INCLUDE_PATH + + + + Cerca il file in include_path. + + + + + + FILE_IGNORE_NEW_LINES + + + + Ometterà newline alla fine di ogni elemento dell'array + + + + + + FILE_SKIP_EMPTY_LINES + + + + Salta le righe vuote + + + + + + FILE_NO_DEFAULT_CONTEXT + + + + Non usa il context di default + + + + + + + + + context + + ¬e.context-support; + + + + + + + + &reftitle.returnvalues; + + Restituisce il file in un array. Ogni elemento dell'array corrisponde a una + riga nel file, con newline incluso. In caso di errore, + file restituisce &false;. + + + + Per ogni linea riportata nell'array risultante includerà newline, a meno + che non venga usato FILE_IGNORE_NEW_LINES. + + + ¬e.line-endings; + + + + &reftitle.errors; + + A partire da PHP 8.3.0, genera un ValueError + se flags include valori non validi, come + FILE_APPEND. + + + Emette un E_WARNING a livello d'errore + se il file non esiste. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.3.0 + + ValueError viene generato + per qualunque valore di flags non valido. + + + + + + + + + &reftitle.examples; + + + Esempio di <function>file</function> + $line) { + +// Ciclo attraverso l'array, si visualizzerà il sorgente come HTML ed i numeri di linea +foreach ($lines as $line_num => $line) { echo "Line #{$line_num} : " . htmlspecialchars($line) . "
\n"; } -// Un'altro esempio, inserisce la pagina web in una stringa. Vedere anche file_get_contents(). -$html = implode('', file ('http://www.example.com/')); +//Utilizzo del parametro flag opzionale +$trimmed = file('somefile.txt', FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES); ?> ]]> -
-
-
-&tip.fopen-wrapper; - - - Ciascuna riga dell'array restituito conterrà il carattere di fine riga, occorre, pertanto, - utilizzare rtrim se si desidera rimuovere il carattere - di fine riga. - - - ¬e.line-endings; - - - A partire da PHP 4.3.0 si può utilizzare file_get_contents per - memorizzare il contenuto di un file in una stringa in formato binario. - - - ¬e.context-support; - &warn.ssl-non-standard; - - Vedere anche readfile, - fopen, fsockopen, - popen, file_get_contents e - include. - -
-
+ + + + + + + &reftitle.notes; + &warn.ssl-non-standard; + + + + &reftitle.seealso; + + + file_get_contents + readfile + fopen + fsockopen + popen + include + stream_context_create + + + + +