Skip to content

Filesystem updated reference/filesystem/functions/file.xml #68

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 9 commits into
base: master
Choose a base branch
from
Open

Filesystem updated reference/filesystem/functions/file.xml #68

Changes from 4 commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
4540819
updated reference/filesystem/functions/file.xml
ManueldG Feb 8, 2025
5fca991
Fix build (#64)
DavidePastore Feb 10, 2025
11b97b5
Merge branch 'filesystem' into fixing-file
ManueldG Feb 13, 2025
921b85b
fix credits and comments
ManueldG Feb 17, 2025
6eeb343
corrections from Davide Pastore
ManueldG Feb 19, 2025
88e4a52
Update file.xml
ManueldG Feb 26, 2025
15abe0f
Merge branch 'filesystem' of https://github.com/ManueldG/doc-it into …
ManueldG Feb 27, 2025
4da6a53
minor corrections file.xml
ManueldG Feb 27, 2025
f3c787f
Merge branch 'master' into filesystem
ManueldG Apr 5, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
253 changes: 191 additions & 62 deletions reference/filesystem/functions/file.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,76 +1,205 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: n/a Maintainer: fernando Status: working -->
<!-- CREDITS: cortesi -->
<refentry xml:id="function.file" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>file</refname>
<refpurpose>Legge l'intero file in un vettore</refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
<methodsynopsis>
<type>array</type><methodname>file</methodname>
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>use_include_path</parameter></methodparam>
<methodparam choice="opt"><type>resource</type><parameter>context</parameter></methodparam>
</methodsynopsis>
<para>
Identica a <function>readfile</function>, eccetto per il fatto che
<function>file</function> 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;.
</para>
<para>
Puoi impostare il secondo parametro, <parameter>use_include_path</parameter>, (opzionale) ad "1",
se vuoi cercare il file nel <link
linkend="ini.include-path">include_path</link>.
</para>
<para>
<informalexample>
<programlisting role="php">
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: e3ae86b439c1963f0cd6d262712e2d3f7e85bc37 Maintainer: ManueldG Status: working -->
<!-- CREDITS: cortesi-->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.file">
<refnamediv>
<refname>file</refname>
<refpurpose>Legge l'intero file in un array</refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type class="union"><type>array</type><type>false</type></type><methodname>file</methodname>
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer>0</initializer></methodparam>
<methodparam choice="opt"><type class="union"><type>resource</type><type>null</type></type><parameter>context</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
Legge l'intero file in un array.
</para>
<note>
<para>
In alternativa puoi usare <function>file_get_contents</function> per estrarre il contenuto
Copy link
Member

@DavidePastore DavidePastore May 6, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Puoi rimuovere In alternativa e partire direttamente con Puoi.

Copy link
Contributor Author

@ManueldG ManueldG May 6, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

allora "è possibile" avevamo detto di usare forme impersonali

di un file sottoforma di stringa.
</para>
</note>
</refsect1>

<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>filename</parameter></term>
<listitem>
<para>
Percorso del file.
</para>
&tip.fopen-wrapper;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>flags</parameter></term>
<listitem>
<para>
Il parametro opzionale <parameter>flags</parameter> può essere uno, o
più valori, delle seguenti costanti:
<variablelist>
<varlistentry>
<term>
<constant>FILE_USE_INCLUDE_PATH</constant>
</term>
<listitem>
<simpara>
Cerca il file in <link
linkend="ini.include-path">include_path</link>.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>FILE_IGNORE_NEW_LINES</constant>
</term>
<listitem>
<simpara>
Ometterà newline alla fine di ogni elemento dell'array
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>FILE_SKIP_EMPTY_LINES</constant>
</term>
<listitem>
<simpara>
Salta le righe vuote
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>FILE_NO_DEFAULT_CONTEXT</constant>
</term>
<listitem>
<simpara>
Non usa il context di default
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>context</parameter></term>
<listitem>
&note.context-support;
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Restituisce il file in un array. Ogni elemento dell'array corrisponde a una
riga nel file, con newline incluso. In caso di errore,
<function>file</function> restituisce &false;.
</para>
<note>
<para>
Per ogni linea riportata nell'array risultante includerà newline, a meno
che non venga usato <constant>FILE_IGNORE_NEW_LINES</constant>.
</para>
</note>
&note.line-endings;
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<simpara>
A partire da PHP 8.3.0, genera un <exceptionname>ValueError</exceptionname>
se <parameter>flags</parameter> include valori non validi, come
<constant>FILE_APPEND</constant>.
</simpara>
<para>
Emette un <constant>E_WARNING</constant> a livello d'errore
se il file non esiste.
</para>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.3.0</entry>
<entry>
<exceptionname>ValueError</exceptionname> viene generato
per qualunque valore di <parameter>flags</parameter> non valido.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>file</function> esempio</title>
<programlisting role="php">
<![CDATA[
<?php
// inserisce una pagina web in un array e la stampa. In questo esempio useremo il protocollo
// HTTP per ottenere il sorgente di un URL
$lines = file('http://www.example.com/');
// Ciclo attraverso l'array, si visualizzerà il sorgente come html ed i numeri di linea
foreach($lines as $line_num => $line) {
foreach ($lines as $line_num => $line) {
echo "Line #<b>{$line_num}</b> : " . htmlspecialchars($line) . "<br />\n";
}
// Un'altro esempio, inserisce la pagina web in una stringa. Vedere anche file_get_contents().
$html = implode('', file ('http://www.example.com/'));
//Utilizzando i flag come parametro opzionale
$trimmed = file('somefile.txt', FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
?>
]]>
</programlisting>
</informalexample>
</para>
&tip.fopen-wrapper;
<note>
<para>
Ciascuna riga dell'array restituito conterrà il carattere di fine riga, occorre, pertanto,
utilizzare <function>rtrim</function> se si desidera rimuovere il carattere
di fine riga.
</para>
</note>
&note.line-endings;
<note>
<para>
A partire da PHP 4.3.0 si può utilizzare <function>file_get_contents</function> per
memorizzare il contenuto di un file in una stringa in formato binario.
</para>
</note>
&note.context-support;
&warn.ssl-non-standard;
<para>
Vedere anche <function>readfile</function>,
<function>fopen</function>, <function>fsockopen</function>,
<function>popen</function>, <function>file_get_contents</function> e
<function>include</function>.
</para>
</refsect1>
</refentry>
</programlisting>
</example>
</para>
</refsect1>

<refsect1 role="notes">
&reftitle.notes;
&warn.ssl-non-standard;
</refsect1>

<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>file_get_contents</function></member>
<member><function>readfile</function></member>
<member><function>fopen</function></member>
<member><function>fsockopen</function></member>
<member><function>popen</function></member>
<member><function>include</function></member>
<member><function>stream_context_create</function></member>
</simplelist>
</para>
</refsect1>

</refentry>

<!-- Keep this comment at the end of the file
Local variables:
Expand Down