Contributions are ready for review
| From: | doc-it at lists dot php dot net | 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>'<? echo "Ciao!";
>'</literal>.
+ E' comunque possibile lasciare il codice PHP (per tornare ad esempio in HTML):
+ <literal>'echo "In PHP mode!"; ?>In HTML mode!<? 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;
+
+ ¬e.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>
+ ¬e.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"><?php phpinfo</font><font
color="#007700">(); </font><font
color="#0000BB">?></font>
+</font>
+</code>
+]]>
+ </screen>
+ <para>
+ L'esempio sopra stamperà (in PHP 5):
+ </para>
+ <screen>
+<![CDATA[
+<code><span style="color: #000000">
+<span style="color: #0000BB"><?php phpinfo</span><span
style="color: #007700">(); </span><span style="color:
#0000BB">?></span>
+</span>
+</code>
+]]>
+ </screen>
+ </example>
+ </para>
+ </refsect1>
+
+ <refsect1 role="notes">
+ &reftitle.notes;
+ ¬e.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.