Contributions are ready for review

From: Date: Mon, 30 Mar 2015 12:00:05 +0000
Subject: Contributions are ready for review
Groups: php.doc.it 
Request: Send a blank email to doc-it+get-1807@lists.php.net to get a copy of this message
Hello PHP IT Documentation team, There are contributions within the online editor queue for this language. Please review, then commit or delete these patches. Patches for review : ----------------------- New file: it/reference/misc/functions/eval.xml By: Federico Reghenzani on 2014-03-08 22:36:50 =================================================================== --- it/reference/misc/functions/eval.xml +++ it/reference/misc/functions/eval.xml @@ -0,0 +1,153 @@ +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: $ --> +<!-- EN-Revision: 321375 Maintainer: Federico Reghenzani Status: ready --> +<!-- Reviewed: no --> + +<refentry xml:id="function.eval" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>eval</refname> + <refpurpose>Esegue una stringa come codice PHP</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>mixed</type><methodname>eval</methodname> + <methodparam><type>string</type><parameter>code</parameter></methodparam> + </methodsynopsis> + <para> + Esegue la data stringa <parameter>code</parameter> come codcie PHP. + </para> + <caution> + <para> + <function>eval</function> è un costrutto del linguaggio <emphasis>molto pericoloso</emphasis> + perché permette l'esecuzione di codice PHP arbitrario. <emphasis>Il suo uso è pertanto + sconsigliato.</emphasis> Se si è certi che non esistono altre soluzioni al posto di usare + <function>eval</function>, fare particolare attenzione a <emphasis>non inserire codice fornito + dall'utente</emphasis> senza averlo preventivamente validato. + </para> + </caution> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>code</parameter></term> + <listitem> + <para> + Codice PHP valido da eseguire. + </para> + <para> + Il codice non deve essere incluso nei <link linkend="language.basic-syntax.phpmode">tag + di apertura e chisura</link> di PHP. Ad esempio <literal>'echo "Ciao!";'</literal> + è corretto invece di <literal>'&lt;? echo "Ciao!"; &gt;'</literal>. + E' comunque possibile lasciare il codice PHP (per tornare ad esempio in HTML): + <literal>'echo "In PHP mode!"; ?&gt;In HTML mode!&lt;? echo "Back in PHP mode!";'</literal>. + </para> + <para> + Oltre a questo, valgono tutte le regole del codice PHP, incluso l'inserimento al termine + di ogni istruzione del punto e virgola. + <literal>'echo "Ciao!"'</literal> causerà un parse error, mentre + <literal>'echo "Ciao!";'</literal> funziona. + </para> + <para> + Un'istruzione <literal>return</literal> causa immediatamente la terminazione del codice + in corso di esecuzione dalla <function>eval</function>. + </para> + <para> + L'ambito di esecuzione è ristretto a dove <function>eval</function> viene chiamata, quindi + qualsiasi variabile definita o modificata al suo interno rimarrà visibile dopo la sua + terminazione. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + <function>eval</function> ritorna &null; a meno che + <literal>return</literal> è chiamata nel codice da valutare, in tal caso + il valore passato a <literal>return</literal> viene ritornato. Se avviene + un parse error, <function>eval</function> ritorna + &false; e l'esecuzione del codice seguente continua normalmente. Non + è possibile catturare un parse error in <function>eval</function> + usando <function>set_error_handler</function>. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>eval</function> Esempio</title> + <programlisting role="php"> +<![CDATA[ +<?php +$string = 'cup'; +$name = 'coffee'; +$str = 'This is a $string with my $name in it.'; +echo $str. "n"; +eval("$str = "$str";"); +echo $str. "n"; +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +This is a $string with my $name in it. +This is a cup with my coffee in it. +]]> + </screen> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + + &note.language-construct; + + &tip.ob-capture; + <note> + <para> + In caso di fatal error nel codce valutato, l'intero script termina. + </para> + </note> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>call_user_func</function></member> + </simplelist> + </para> + </refsect1> +</refentry> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"~/.phpdoc/manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=52764 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=52764 ------------------------------------------------------------------ New file: it/reference/misc/functions/die.xml By: Federico Reghenzani on 2014-03-08 22:37:53 =================================================================== --- it/reference/misc/functions/die.xml +++ it/reference/misc/functions/die.xml @@ -0,0 +1,40 @@ +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: $ --> +<!-- EN-Revision: 325214 Maintainer: Federico Reghenzani Status: ready --> +<!-- Reviewed: no --> + +<refentry xml:id="function.die" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>die</refname> + <refpurpose>Equivale a <literal>exit</literal></refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <para> + Questo costrutto è equivalente a <function>exit</function>. + </para> + </refsect1> + +</refentry> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"~/.phpdoc/manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=52765 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=52765 ------------------------------------------------------------------ New file: it/reference/misc/functions/defined.xml By: Federico Reghenzani on 2014-03-11 03:25:07 =================================================================== --- it/reference/misc/functions/defined.xml +++ it/reference/misc/functions/defined.xml @@ -0,0 +1,109 @@ +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: $ --> +<!-- EN-Revision: 297028 Maintainer: Federico Reghenzani Status: ready --> +<!-- Reviewed: no --> + +<refentry xml:id="function.defined" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>defined</refname> + <refpurpose>Verifica se dato nome di una costante, essa esiste</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>defined</methodname> + <methodparam><type>string</type><parameter>name</parameter></methodparam> + </methodsynopsis> + <para> + Verifica se la data costante esiste ed è definita. + </para> + <note> + <para> + Se vuoi verificare che una funzione esista usa <function>function_exists</function>. + Se vuoi verificare invece che una variabile esista, usa <function>isset</function> + infatti <function>defined</function> si applica solo a <link + linkend="language.constants">constants</link>. + </para> + </note> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>name</parameter></term> + <listitem> + <para> + Il nome della costante. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Ritorna &true; se il nome della costante specificato da <parameter>name</parameter> + è stata definita, &false; altrimenti. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Controllo Costanti</title> + <programlisting role="php"> +<![CDATA[ +<?php +/* Notare l'uso degli apici. Questo esempio controlla se la stringa + * 'TEST' e' il nome di una costante esistente TEST */ +if (defined('TEST')) { + echo TEST; +} +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>define</function></member> + <member><function>constant</function></member> + <member><function>get_defined_constants</function></member> + <member><function>function_exists</function></member> + <member><link linkend="language.constants">Costanti</link></member> + </simplelist> + </para> + </refsect1> + +</refentry> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"~/.phpdoc/manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=52766 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=52766 ------------------------------------------------------------------ New file: it/reference/misc/functions/constant.xml By: Federico Reghenzani on 2014-03-11 03:28:50 =================================================================== --- it/reference/misc/functions/constant.xml +++ it/reference/misc/functions/constant.xml @@ -0,0 +1,130 @@ +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: $ --> +<!-- EN-Revision: 299326 Maintainer: Federico Reghenzani Status: ready --> +<!-- Reviewed: no --> + +<refentry xml:id="function.constant" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>constant</refname> + <refpurpose>Ritorna il valore di una costante</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>mixed</type><methodname>constant</methodname> + <methodparam><type>string</type><parameter>name</parameter></methodparam> + </methodsynopsis> + <simpara> + Ritorna il valore di una costante di nome + <parameter>name</parameter>. + </simpara> + <simpara> + <function>constant</function> e' utile se hai bisogno di ottenere + il valore di una costante, ma non ne conosci il nome. Per esempio se + e' in una variabile ritornata da una funzione. + </simpara> + <simpara> + Questa funzione puo' essere usata anche con le <link + linkend="language.oop5.constants">costanti di classe</link>. + </simpara> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>name</parameter></term> + <listitem> + <para> + Il nome della costante. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Ritorna il valore della costante o &null; se la costante non e' definita. + </para> + </refsect1> + + <refsect1 role="errors"> + &reftitle.errors; + <para> + Un errore <constant>E_WARNING</constant> e' generato se la costante non e' definita. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Esempio d'uso di <function>constant</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + +define("MAXSIZE", 100); + +echo MAXSIZE; +echo constant("MAXSIZE"); // Equivalente alla riga precedetne + + +interface bar { + const test = 'foobar!'; +} + +class foo { + const test = 'foobar!'; +} + +$const = 'test'; + +var_dump(constant('bar::'. $const)); // string(7) "foobar!" +var_dump(constant('foo::'. $const)); // string(7) "foobar!" + +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>define</function></member> + <member><function>defined</function></member> + <member>La sezione <link linkend="language.constants">Costanti</link></member> + </simplelist> + </para> + </refsect1> + +</refentry> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"~/.phpdoc/manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=52815 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=52815 ------------------------------------------------------------------ New file: it/reference/misc/functions/define.xml By: Federico Reghenzani on 2014-03-11 03:33:23 =================================================================== --- it/reference/misc/functions/define.xml +++ it/reference/misc/functions/define.xml @@ -0,0 +1,132 @@ +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: $ --> +<!-- EN-Revision: 297028 Maintainer: Federico Reghenzani Status: ready --> +<!-- Reviewed: no --> + +<refentry xml:id="function.define" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>define</refname> + <refpurpose>Definisce una costante</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>define</methodname> + <methodparam><type>string</type><parameter>name</parameter></methodparam> + <methodparam><type>mixed</type><parameter>value</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>case_insensitive</parameter><initializer>false</initializer></methodparam> + </methodsynopsis> + <para> + Definisce una costante alfanumerica durante l'esecuzione. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>name</parameter></term> + <listitem> + <para> + Il nome della costante. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>value</parameter></term> + <listitem> + <para> + Il valore della costante; solo valori scalari e &null; sono consentiti. + + I valori scalari comprendono <type>integer</type>, + <type>float</type>, <type>string</type> o <type>boolean</type>. + E' anche possibile definire costanti di tipo <type>resource</type> + tuttavia non è raccomandato e può causare comportamenti imprevedibili. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>case_insensitive</parameter></term> + <listitem> + <para> + Se settato a &true;, la costante viene definita case-insensitive. + Il comportamento di default è case-sensitive; per esempio + <literal>CONSTANT</literal> e <literal>Constant</literal> rappresentano + valori diversi. + </para> + <note> + <para> + Le costanti case-insensitive vengono salvate internamente in minuscolo. + </para> + </note> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Definire costanti</title> + <programlisting role="php"> +<![CDATA[ +<?php +define("CONSTANT", "Ciao Mondo!"); +echo CONSTANT; // output "Ciao Mondo!" +echo Constant; // output "Ciao Mondo!" e genera un notice. + +define("GREETING", "Ciao Mondo!", true); +echo GREETING; // output "Ciao Mondo!" +echo Greeting; // output "Ciao Mondo!" + +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>defined</function></member> + <member><function>constant</function></member> + <member>La sezione <link linkend="language.constants">Costanti</link></member> + </simplelist> + </para> + </refsect1> + +</refentry> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"~/.phpdoc/manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=52816 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=52816 ------------------------------------------------------------------ New file: it/reference/misc/functions/sleep.xml By: Federico Reghenzani on 2014-03-11 03:37:40 =================================================================== --- it/reference/misc/functions/sleep.xml +++ it/reference/misc/functions/sleep.xml @@ -0,0 +1,153 @@ +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: $ --> +<!-- EN-Revision: 305811 Maintainer: Federico Reghenzani Status: ready --> +<!-- Reviewed: no --> + +<refentry xml:id="function.sleep" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>sleep</refname> + <refpurpose>Pausa dell'esecuzione</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>sleep</methodname> + <methodparam><type>int</type><parameter>seconds</parameter></methodparam> + </methodsynopsis> + <simpara> + Mette in pausa l'esecuzione del programma per il numero indicato di secondi. + </simpara> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>seconds</parameter></term> + <listitem> + <para> + Tempo di pausa in secondi. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Ritorna zero in caso di successo o &false; in caso di errore. + </para> + <para> + Se la chiamata viene interrotta da un segnale, <function>sleep</function> ritorna + un valore non-zero. Su Windows questo valore è sempre + <literal>192</literal> (cioè il valore di + <constant>WAIT_IO_COMPLETION</constant> nelle Windows API). + In altre piattaforme il valore di ritorno è il numero di secondi rimanenti di pausa. + </para> + </refsect1> + + <refsect1 role="errors"> + &reftitle.errors; + <para> + Se <parameter>seconds</parameter> (cioè il numero di secondi specificato) è negativo, + la funzione genera un errore <constant>E_WARNING</constant>. + </para> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>5.3.4</entry> + <entry> + Prima di PHP 5.3.4 in Windows, <function>sleep</function> ritorna + sempre &null; in ogni caso. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Esempio <function>sleep</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + +// current time +echo date('h:i:s') . "n"; + +// sleep for 10 seconds +sleep(10); + +// wake up ! +echo date('h:i:s') . "n"; + +?> +]]> + </programlisting> + <para> + Questo esempio stampa (dopo 10 secondi) + </para> + <screen> +<![CDATA[ +05:31:23 +05:31:33 +]]> + </screen> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>usleep</function></member> + <member><function>time_nanosleep</function></member> + <member><function>time_sleep_until</function></member> + <member><function>set_time_limit</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"~/.phpdoc/manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=52817 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=52817 ------------------------------------------------------------------ New file: it/reference/misc/functions/usleep.xml By: Federico Reghenzani on 2014-03-11 03:38:55 =================================================================== --- it/reference/misc/functions/usleep.xml +++ it/reference/misc/functions/usleep.xml @@ -0,0 +1,136 @@ +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: $ --> +<!-- EN-Revision: 297028 Maintainer: Federico Reghenzani Status: ready --> +<!-- Reviewed: no --> + +<refentry xml:id="function.usleep" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>usleep</refname> + <refpurpose>Delay execution in microseconds</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>void</type><methodname>usleep</methodname> + <methodparam><type>int</type><parameter>micro_seconds</parameter></methodparam> + </methodsynopsis> + <para> + Mette in pausa l'esecuzione del programma per il numero indicato di micro-secondi. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>micro_seconds</parameter></term> + <listitem> + <para> + Tempo di pausa in micro-secondi. Un micro-secondo è un milionesimo di secondo. + second. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.void; + </para> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>5.0.0</entry> + <entry> + Questa funzione ora funziona anche sui sistemi windows. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Esempio <function>usleep</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + +// Current time +echo date('h:i:s') . "n"; + +// wait for 2 seconds +usleep(2000000); + +// back! +echo date('h:i:s') . "n"; + +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +11:13:28 +11:13:30 +]]> + </screen> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>sleep</function></member> + <member><function>time_nanosleep</function></member> + <member><function>time_sleep_until</function></member> + <member><function>set_time_limit</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"~/.phpdoc/manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=52818 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=52818 ------------------------------------------------------------------ New file: it/reference/misc/functions/show-source.xml By: Federico Reghenzani on 2014-03-11 03:39:11 =================================================================== --- it/reference/misc/functions/show-source.xml +++ it/reference/misc/functions/show-source.xml @@ -0,0 +1,41 @@ +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: $ --> +<!-- EN-Revision: 288721 Maintainer: Federico Reghenzani Status: ready --> +<!-- Reviewed: no --> + +<refentry xml:id="function.show-source" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>show_source</refname> + <refpurpose>&Alias; <function>highlight_file</function></refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <function>highlight_file</function>. + </simpara> + </refsect1> + +</refentry> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"~/.phpdoc/manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=52819 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=52819 ------------------------------------------------------------------ New file: it/reference/misc/functions/highlight-file.xml By: Federico Reghenzani on 2014-03-11 03:44:52 =================================================================== --- it/reference/misc/functions/highlight-file.xml +++ it/reference/misc/functions/highlight-file.xml @@ -0,0 +1,144 @@ +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: $ --> +<!-- EN-Revision: 330680 Maintainer: Federico Reghenzani Status: ready --> +<!-- Reviewed: no --> + +<refentry xml:id="function.highlight-file" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>highlight_file</refname> + <refpurpose>Evidenziatore di sintassi per file.</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>mixed</type><methodname>highlight_file</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>return</parameter><initializer>false</initializer></methodparam> + </methodsynopsis> + <para> + Stampa o ritorna la sintassi evidenziata del codice contenuto nel file + di nome <parameter>filename</parameter> usando i colori predefiniti + nel syntax highlighter per PHP. + </para> + <para> + Molti server sono configurati per evidenziare i file automaticamente + con l'estensione <emphasis>phps</emphasis>. Per esempio, + <filename>example.phps</filename> mostrerà la sintassi evidenziata + del file. Per abilitarlo aggiungi queste righe all'&httpd.conf; (su webserver Apache): + </para> + <screen> +<![CDATA[ +AddType application/x-httpd-php-source .phps +]]> + </screen> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>filename</parameter></term> + <listitem> + <para> + Percorso del file PHP che deve essere evidenziato. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>return</parameter></term> + <listitem> + <para> + Se settata a &true; la funzione ritornerà il codice evidenziato anziché stamparlo. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Se <parameter>return</parameter> è &true;, ritorna il codice evidenziato, altrimenti + &true; in caso di successo o &false; in caso di fallimento. + </para> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>4.2.1</entry> + <entry> + Questa funzione dipende ora da <link + linkend="ini.safe-mode">safe_mode</link> e <link + linkend="ini.open-basedir">open_basedir</link>. + </entry> + </row> + <row> + <entry>4.2.0</entry> + <entry> + Il parametro <parameter>return</parameter> è stato aggiunto. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + <caution> + <para> + Prestare attenzione quando si usa <function>highlight_file</function> + a non rivelare nessun dato sensibile come password o altri tipi di informazioni + che possano causare problemi di sicurezza. + </para> + </caution> + &note.uses-ob; + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>highlight_string</function></member> + <member><link linkend="ini.syntax-highlighting">Evidenziare direttive INI</link></member> + </simplelist> + </para> + </refsect1> + +</refentry> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"~/.phpdoc/manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=52820 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=52820 ------------------------------------------------------------------ New file: it/reference/misc/functions/highlight-string.xml By: Federico Reghenzani on 2014-03-11 03:48:41 =================================================================== --- it/reference/misc/functions/highlight-string.xml +++ it/reference/misc/functions/highlight-string.xml @@ -0,0 +1,158 @@ +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: $ --> +<!-- EN-Revision: 332597 Maintainer: Federico Reghenzani Status: ready --> +<!-- Reviewed: no --> + +<refentry xml:id="function.highlight-string" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>highlight_string</refname> + <refpurpose>Evidenziatore di sintassi per stringhe</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>mixed</type><methodname>highlight_string</methodname> + <methodparam><type>string</type><parameter>str</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>return</parameter><initializer>false</initializer></methodparam> + </methodsynopsis> + <simpara> + Stampa o ritorna la sintassi evidenziata del codice contenuto nella stringa + <parameter>str</parameter> usando i colori predefiniti nel syntax highlighter per PHP. + </simpara> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>str</parameter></term> + <listitem> + <para> + Il codice PHP che deve essere evidenziato. Questo deve includere il tag di apertura. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>return</parameter></term> + <listitem> + <para> + Se settata a &true; la funzione ritornerà il codice evidenziato anziché stamparlo. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Se <parameter>return</parameter> è &true;, ritorna il codice evidenziato, altrimenti + &true; in caso di successo o &false; in caso di fallimento. + </para> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>4.2.0</entry> + <entry> + Il parametro <parameter>return</parameter> è stato aggiunto. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Esempio di <function>highlight_string</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +highlight_string('<?php phpinfo(); ?>'); +?> +]]> + </programlisting> + <para> + L'esempio sopra stamperà (in PHP 4): + </para> + <screen> +<![CDATA[ +<code><font color="#000000"> +<font color="#0000BB">&lt;?php phpinfo</font><font color="#007700">(); </font><font color="#0000BB">?&gt;</font> +</font> +</code> +]]> + </screen> + <para> + L'esempio sopra stamperà (in PHP 5): + </para> + <screen> +<![CDATA[ +<code><span style="color: #000000"> +<span style="color: #0000BB">&lt;?php phpinfo</span><span style="color: #007700">(); </span><span style="color: #0000BB">?&gt;</span> +</span> +</code> +]]> + </screen> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + &note.uses-ob; + <para> + Il markup HTML può essere soggetto a cambiamenti. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>highlight_file</function></member> + <member><link linkend="ini.syntax-highlighting">Evidenziare direttive INI</link></member> + </simplelist> + </para> + </refsect1> + +</refentry> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"~/.phpdoc/manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=52821 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=52821 ------------------------------------------------------------------ New file: it/reference/misc/functions/halt-compiler.xml By: Federico Reghenzani on 2014-03-11 03:54:17 =================================================================== --- it/reference/misc/functions/halt-compiler.xml +++ it/reference/misc/functions/halt-compiler.xml @@ -0,0 +1,93 @@ +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: $ --> +<!-- EN-Revision: 297028 Maintainer: Federico Reghenzani Status: ready --> +<!-- Reviewed: no --> + +<refentry xml:id="function.halt-compiler" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>__halt_compiler</refname> + <refpurpose> + Blocca l'esecuzione del compilatore. + </refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>void</type><methodname>__halt_compiler</methodname> + <void/> + </methodsynopsis> + <para> + Blocca l'esecuzione del compilatore. Può essere utile per inserire dati + negli script PHP. + </para> + <para> + La posizione in byte iniziale dei dati può essere determinata dalla costante + <constant>__COMPILER_HALT_OFFSET__</constant> che viene definita solo se è invocata + la funzione <function>__halt_compiler</function> nel file. + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.void; + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Esempio <function>__halt_compiler</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + +// open this file +$fp = fopen(__FILE__, 'r'); + +// seek file pointer to data +fseek($fp, __COMPILER_HALT_OFFSET__); + +// and output it +var_dump(stream_get_contents($fp)); + +// the end of the script execution +__halt_compiler(); the installation data (eg. tar, gz, PHP, etc.) +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + <note> + <para> + <function>__halt_compiler</function> può essere usata solo dallo scope principale. + </para> + </note> + </refsect1> + +</refentry> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"~/.phpdoc/manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=52822 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=52822 ------------------------------------------------------------------ Modified: it/chapters/tutorial.xml By: anonymous on 2013-09-12 07:14:57 =================================================================== --- it/chapters/tutorial.xml +++ it/chapters/tutorial.xml @@ -1,14 +1,15 @@ -<?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: 335484 Maintainer: pastore Status: ready --> +<?xml version="1.0" encoding="UTF-8"?> +<!-- EN-Revision: 325214 Maintainer: pastore Status: ready --> <chapter xml:id="tutorial" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <info><title>Una semplice introduzione</title></info> + <title>Una semplice introduzione</title> <para> Di seguito, in una breve e semplice introduzione, vorremmo mostrare alcuni esempi per l'utilizzo di PHP. Essi sono relativi soltanto alla creazione dinamica di pagine web, anche se PHP non ha funzionalità limitate esclusivamente alla creazione delle sole pagine web. Fare riferimento alla sezione intitolata - <link linkend="intro-whatcando">Cosa può fare PHP</link> per avere ulteriori informazioni. + <link linkend="intro-whatcando">Cosa può fare PHP</link> per avere ulteriori + informazioni. </para> <para> Le pagine web create con PHP vengono trattate come normali pagine HTML e @@ -19,17 +20,19 @@ <section xml:id="tutorial.requirements"> <title>Di cosa ho bisogno?</title> <para> - In questo tutorial assumiamo che il vostro server abbia il suporto PHP attivato - e che tutti i file con estensione <filename>.php</filename> - vengano gestiti da questo. Quasi in tutti i server questa è l'estensione di default - per i file PHP., ma consultatevi col vostro system administrator per sicurezza. Se - il vostro server supporta PHP, allora, non è necessario fare nulla. Semplicemente - create i vostri file <filename>.php</filename> e scaricateli nella vostra - directory web, il server le analizzerà e le eseguirà magicamente. - Non è necessario compilare nulla nè installare - strumenti aggiuntivi. Si pensi ai file PHP come a dei semplici file - HTML con una intera famiglia aggiuntiva di magici tag che consentono di fare - ogni sorta di cose. + In questo tutorial assumiamo che il vostro server abbia il suporto PHP attivato e che tutti + i file con estensione <filename>.php</filename> vengano gestiti da questo. Quasi in tutti + i server questa è l'estensione di default per i file PHP., ma consultatevi col vostro + system administrator per sicurezza. Se il vostro server supporta PHP, allora, non è + necessario fare nulla. Semplicemente create i vostri file <filename>.php</filename> e + scaricateli nella vostra directory web, il server le analizzerà e le eseguirà + magicamente. Non è necessario compilare nulla nè installare strumenti aggiuntivi. + Si pensi ai file PHP come a dei semplici file HTML con una intera famiglia aggiuntiva di magici + tags che consentono di fare ogni sorta di cose. + Molti web host offrono il supporto PHP, ma se il vostro + host non ce l'ha considerate la lettura della sezione <link xlink:href="&url.php.links;"> + Link di PHP</link> per delle risorse per trovare web host che supportano + PHP. </para> <para> Diciamo che si vuole risparmiare larghezza di banda preziosa e sviluppare a livello locale. @@ -443,7 +446,8 @@ <varname>$_GET</varname>. Si può anche usare la variabile autoglobale <varname>$_REQUEST</varname> se la provenienza dei dati richiesti non ci interessa. Questa variabile - contiene un misto di dati GET, POST e COOKIE. + contiene un misto di dati GET, POST, COOKIE e FILE. Vedere anche la funzione + <function>import_request_variables</function>. </para> <para> Si può anche trattare con gli input XForms input in PHP, anche se vi troverete @@ -455,27 +459,31 @@ </section> <section xml:id="tutorial.oldcode"> - <info><title>L'uso di vecchi codici con le nuove versioni di PHP</title></info> + <title>L'uso di vecchi codici con le nuove versioni di PHP</title> <para> - Da quando il PHP è divenuto un linguaggio di scripting popolare, esistono - tante repository e librerie che contengono codice che si può riutilizzare. - La maggioranza degli sviluppatori PHP ha cercato di renderlo compatibile con le versioni precedenti, - perciò uno script creato per una vecchia versione del PHP dovrebbe girare senza modifiche (in teoria) - in una più recente. In pratica, spesso possono servire delle correzioni. + Da quando il PHP è divenuto un linguaggio di scripting popolare, + esistono più fonti che producono listati di codice che si possono adoperare + nei propri scripts. La maggioranza degli sviluppatori del PHP ha cercato di renderlo + compatibile con le versioni precedenti, perciò uno script creato per una + vecchia versione del PHP dovrebbe girare senza modifiche (in teoria) in una più + recente. In pratica, spesso possono servire delle correzioni. </para> <para> Ecco due delle più importanti modifiche apportate al vecchio codice: <itemizedlist> <listitem> <simpara> - I vecchi array <varname>$HTTP_*_VARS</varname> non sono disponibili da - PHP 5.4.0. In PHP - <link xlink:href="&url.php.release4.1.0;">4.1.0</link> furono introdotti - i seguenti <link linkend="language.variables.superglobals">array superglobal</link>. - Essi sono: <varname>$_GET</varname>, <varname>$_POST</varname>, - <varname>$_COOKIE</varname>, <varname>$_SERVER</varname>, - <varname>$_FILES</varname>, <varname>$_ENV</varname>, - <varname>$_REQUEST</varname>, e <varname>$_SESSION</varname>. + Il disuso dei vecchi arrays <varname>$HTTP_*_VARS</varname> (che devono essere + dichiarati global quando vengano adoperati all' interno di una funzione o di un metodo). + In PHP <link xlink:href="&url.php.release4.1.0;">4.1.0</link> + furono introdotti i seguenti <link linkend="language.variables.superglobals">autoglobal arrays</link>: + Essi sono: <varname>$_GET</varname>, <varname>$_POST</varname>, + <varname>$_COOKIE</varname>, <varname>$_SERVER</varname>, + <varname>$_FILES</varname>, <varname>$_ENV</varname>, + <varname>$_REQUEST</varname>, e <varname>$_SESSION</varname>. Anche i + vecchi arrays <varname>$HTTP_*_VARS</varname>, quali + <varname>$HTTP_POST_VARS</varname>, esistono. + &avail.register-long-arrays; </simpara> </listitem> <listitem> @@ -487,7 +495,7 @@ <emphasis>off</emphasis> per default in &php.ini;. Il metodo consigliato per accedere a questi valori è quello che fa uso degli array autoglobali suddetti. Scripts, libri e tutorials più vecchi possono contare su questa - direttiva su <literal>on</literal>. Se essa fosse <literal>on</literal>, per esempio, qualcuno + direttiva su <literal>on</literal>. Se essa è <literal>on</literal>, per esempio, qualcuno potrebbe usare <varname>$id</varname> dall'URL <literal>http://www.example.com/foo.php?id=42</literal>. La variabile, <varname>$_GET['id']</varname> sarebbe disponibile indifferentemente del fatto che sia on od off. @@ -505,7 +513,9 @@ <para> Con quello che sapete ora dovreste essere in grado di comprendere la maggior parte del manuale ed anche i vari scripts di esempio reperibili nelle - raccolte di esempi. + raccolte di esempi. Inoltre potete trovarne altri sui siti web di + php.net nella sezione links: + <link xlink:href="&url.php.links;">&url.php.links;</link>. </para> <para> Per vedere varie slide delle presentazioni che mostrano di più ciò che PHP può fare, => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=50019 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=50019 ------------------------------------------------------------------ Modified: it/reference/errorfunc/functions/set-error-handler.xml By: Federico Reghenzani on 2014-03-07 06:49:55 =================================================================== --- it/reference/errorfunc/functions/set-error-handler.xml +++ it/reference/errorfunc/functions/set-error-handler.xml @@ -10,29 +10,209 @@ Configura una funzione di gestione dell'errore definita dall'utente. </refpurpose> </refnamediv> - <refsect1> - <title>Descrizione</title> - <methodsynopsis> - <type>string</type><methodname>set_error_handler</methodname> - <methodparam><type>string</type><parameter>error_handler</parameter></methodparam> - </methodsynopsis> - <para> - Configura una funzione utente (<parameter>error_handler</parameter> per - gestire gli errori in uno script. Restituisce, se esistente, il precedente - gestore degli errori, o &false; in caso di errore. Questa funzione può - essere utilizzata per definire un sistema personalizzato di gestione degli - errori durante l'esecuzione, per esempio in applicazioni dove sia - necessario svuotare dati o file in caso di un determinato errore - critico, o quando sia necessario, in determinate condizioni, attivare - un errore (con <function>trigger_error</function>) - </para> - <para> - La funzione utente richiede 2 parametri: il codice errore e una stringa - descrittiva dell'errore. Da PHP 4.0.2, è possibile opzionalmente fornire - altri 3 parametri aggiuntivi: il nome del file, il numero di riga e il - contesto dove è avvenuto l'errore (un array che punto alla tabella - dei simboli attiva nel punto in cui è avvenuto l'errore). + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>mixed</type><methodname>set_error_handler</methodname> + <methodparam><type>callable</type><parameter>error_handler</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>error_types</parameter><initializer>E_ALL | E_STRICT</initializer></methodparam> + </methodsynopsis> + <para> + Configura una funzione utente (<parameter>error_handler</parameter>) per + gestire gli errori in uno script. + </para> + <para> + Questa funzione può essere utilizzata per definire un sistema + personalizzato di gestione degli errori durante l'esecuzione, per esempio + in applicazioni dove sia necessario svuotare dati o file in caso di un + determinato errore critico, o quando sia necessario, in determinate + condizioni, attivare un errore (con <function>trigger_error</function>) + </para> + <para> + E' importante ricordare che il gestore degli errori standard di PHP viene + completamente saltato. La configurazione di <link linkend="ini.error-reporting">error_reporting</link> + non avrà effetto e il vostro gestore di errore sarà richiamato senza considerarla - in ogni + caso sarà possibile leggere il valore corrente di <function>error_reporting</function> + ed agire di conseguenza. E' di particolare rilevanza il fatto che questo + valore sarà 0 se la riga che causa l'errore viene precedura dall' + <link linkend="language.operators.errorcontrol">operatore di controllo errore @</link>. + </para> + <para> + Notare anche che è vostra responsabilità definire <function>die</function> + se necessario. Se la funzione di gestione dell'errore ritorna, lo script + continerà l'esecuzione con la riga seguente a quella che ha causato + l'errore. + </para> + <para> + Il seguenti tipi di errori non saranno gestiti dalla funzione definita dall'utente: + <constant>E_ERROR</constant>, <constant>E_PARSE</constant>, + <constant>E_CORE_ERROR</constant>, <constant>E_CORE_WARNING</constant>, + <constant>E_COMPILE_ERROR</constant>, + <constant>E_COMPILE_WARNING</constant>, e buona parte degli + <constant>E_STRICT</constant>. + </para> + <para> + Gli errori che occorrono prima che lo script sia in esecuzione (ad esempio + durante l'upload di file) la funzione definita dell'utente non può essere + chiamata perché non sarebbe ancora stata registrata. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>error_handler</parameter></term> + <listitem> + <para> + Una funzione di callback con la seguente struttura oppure &null; per + ripristinare il gestore di default. + </para> + <para> + <methodsynopsis> + <type>bool</type><methodname><replaceable>handler</replaceable></methodname> + <methodparam><type>int</type><parameter>errno</parameter></methodparam> + <methodparam><type>string</type><parameter>errstr</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>errfile</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>errline</parameter></methodparam> + <methodparam choice="opt"><type>array</type><parameter>errcontext</parameter></methodparam> + </methodsynopsis> + <variablelist> + <varlistentry> + <term><parameter>errno</parameter></term> + <listitem> + <simpara> + Il primo parametro, <parameter>errno</parameter>, contiene il livello + dell'errore come un intero. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>errstr</parameter></term> + <listitem> + <simpara> + Il secondo parametro, <parameter>errstr</parameter>, contiene il messaggio + di errore come stringa. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>errfile</parameter></term> + <listitem> + <simpara> + Il terzo parametro opzionale, <parameter>errfile</parameter>, + contiene il nome del file che ha generato l'errore, come stringa. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>errline</parameter></term> + <listitem> + <simpara> + Il quarto parametro opzionale, <parameter>errline</parameter>, + Contiene il numero di riga relativo al file che ha generato l'errore, come intero. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>errcontext</parameter></term> + <listitem> + <simpara> + Il quinto parametro opzionale, <parameter>errcontext</parameter>, + che e' un array che punta alla tabella simboli al punto dove l'errore è + stato generato. In altre parole <parameter>errcontext</parameter> conterrà un vettore di tutte le variabili + che esistono e sono visibili dove l'errore è avvenuto. + La funzione utente non dovrebbe mai modificare <parameter>errcontext</parameter>. + </simpara> + </listitem> + </varlistentry> + </variablelist> + </para> + <para> + Se la funzione ritorna &false; allora viene eseguito il normale gestore degli errori. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>error_types</parameter></term> + <listitem> + <para> + Può essere usato per mascherare alcuni errori, allo stesso modo + di <link linkend="ini.error-reporting">error_reporting</link> che controlla + quali errori mostrare. Se non viene specificato + <parameter>error_handler</parameter> rispecchierà le impostazioni di <link + linkend="ini.error-reporting">error_reporting</link>. + </para> + </listitem> + </varlistentry> + </variablelist> </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Ritorna una stringa contenente l'eventuale precedente funzione degli errori. + Ritorna &null; se <parameter>error_handler</parameter> è &null; o in caso di errore + (come un'invalida funzione di callback). Se il gestore precedente era un metodo di + classe, allora il valore ritornato sarà un array con due elementi: nome della classe + e nome del metodo. + </para> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>5.5.0</entry> + <entry> + <parameter>error_handler</parameter> ora accetta &null;. + </entry> + </row> + <row> + <entry>5.2.0</entry> + <entry> + <parameter>error_handler</parameter> deve ritornare &false; per + popolare <varname>$php_errormsg</varname>. + </entry> + </row> + <row> + <entry>5.0.0</entry> + <entry> + Il parametro <parameter>error_types</parameter> viene introdotto. + </entry> + </row> + <row> + <entry>4.3.0</entry> + <entry> + Al posto del nome della funzione, un vettore contenente il riferimento + all'oggetto e al nome del metodo può essere utilizzato in + <parameter>error_handler</parameter>. + </entry> + </row> + <row> + <entry>4.0.2</entry> + <entry> + Sono aggiunti tre parametri opzioni a <parameter>error_handler</parameter>: + nome del file, numero di riga e contesto. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="examples"> <para> L'esempio sottostante mostra la gestione delle eccezioni interne attivando gli errori e gestendoli tramite @@ -159,28 +339,22 @@ </programlisting> </informalexample> </para> - <para> - E' importante ricordare che il gestore degli errori standard di PHP viene - completamente saltato. La configurazione di <function>error_reporting</function> non avrà effetto - e il vostro gestore di errore sarà richiamato senza considerarla - in ogni - caso sarà possibile leggere il valore corrente di <function>error_reporting</function> - ed agire di conseguenza. E' di particolare rilevanza il fatto che questo - valore sarà 0 se la riga che causa l'errore viene precedura dall' - <link linkend="language.operators.errorcontrol">operatore di controllo errore @</link>. - </para> - <para> - Notare anche che è vostra responsabilità definire <function>die</function> - se necessario. Se la funzione di gestione dell'errore ritorna, lo script - continerà l'esecuzione con la riga seguente a quella che ha causato - l'errore. - </para> - <para> - Vedere anche <function>error_reporting</function>, - <function>restore_error_handler</function>, - <function>trigger_error</function>, <function>user_error</function> - </para> </refsect1> - </refentry> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><classname>ErrorException</classname></member> + <member><function>error_reporting</function></member> + <member><function>restore_error_handler</function></member> + <member><function>trigger_error</function></member> + <member><link linkend="errorfunc.constants">error level constants</link></member> + <member>&seealso.callback;</member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=52756 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=52756 ------------------------------------------------------------------ -- https://edit.php.net/ This email is send automatically by the Php Docbook Online Editor.

« previous php.doc.it (#1807) next »