cvs: phpdoc-it /reference/crack configure.xml ini.xml reference.xml /reference/ctype configure.xml reference.xml /reference/curl configure.xml
reference.xml /reference/cybercash reference.xml /reference/datetime reference.xml /reference/dbm configure.xml reference.xml /reference/dir
constants.xml reference.xml /reference/dotnet reference.xml /reference/errorfunc constants.xml examples.xml ini.xml reference.xml
/reference/strings charsets.xml constants.xml reference.xml /reference/strings/functions addcslashes.xml addslashes.xml bin2hex.xml chop.xml chr.xml
chunk-split.xml convert-cyr-string.xml convert-uudecode.xml convert-uuencode.xml count-chars.xml crc32.xml crypt.xml echo.xml explode.xml

From:	Andrioli Darvin	Date:	Wed, 23 Jun 2004 12:27:31 +0000
Subject:	cvs: phpdoc-it /reference/crack configure.xml ini.xml reference.xml /reference/ctype configure.xml reference.xml /reference/curl configure.xml reference.xml /reference/cybercash reference.xml /reference/datetime reference.xml /reference/dbm configure.xml reference.xml /reference/dir constants.xml reference.xml /reference/dotnet reference.xml /reference/errorfunc constants.xml examples.xml ini.xml reference.xml /reference/strings charsets.xml constants.xml reference.xml /reference/strings/functions addcslashes.xml addslashes.xml bin2hex.xml chop.xml chr.xml chunk-split.xml convert-cyr-string.xml convert-uudecode.xml convert-uuencode.xml count-chars.xml crc32.xml crypt.xml echo.xml explode.xml
Groups:	php.doc.it
Request:	Send a blank email to doc-it+get-601@lists.php.net to get a copy of this message

darvina Wed Jun 23 08:27:31 2004 EDT Added files: /phpdoc-it/reference/crack configure.xml ini.xml /phpdoc-it/reference/ctype configure.xml /phpdoc-it/reference/dbm configure.xml /phpdoc-it/reference/dir constants.xml /phpdoc-it/reference/errorfunc constants.xml examples.xml ini.xml /phpdoc-it/reference/strings charsets.xml constants.xml reference.xml /phpdoc-it/reference/strings/functions addcslashes.xml addslashes.xml bin2hex.xml chop.xml chr.xml chunk-split.xml convert-cyr-string.xml convert-uudecode.xml convert-uuencode.xml count-chars.xml crc32.xml crypt.xml echo.xml explode.xml Modified files: /phpdoc-it/reference/crack reference.xml /phpdoc-it/reference/ctype reference.xml /phpdoc-it/reference/curl configure.xml reference.xml /phpdoc-it/reference/cybercash reference.xml /phpdoc-it/reference/datetime reference.xml /phpdoc-it/reference/dbm reference.xml /phpdoc-it/reference/dir reference.xml /phpdoc-it/reference/dotnet reference.xml /phpdoc-it/reference/errorfunc reference.xml Log: Sync to En tree and added new files to the chapters

http://cvs.php.net/diff.php/phpdoc-it/reference/crack/reference.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-it/reference/crack/reference.xml diff -u phpdoc-it/reference/crack/reference.xml:1.3 phpdoc-it/reference/crack/reference.xml:1.4 --- phpdoc-it/reference/crack/reference.xml:1.3 Mon Apr 29 14:35:08 2002 +++ phpdoc-it/reference/crack/reference.xml Wed Jun 23 08:27:30 2004 @@ -1,51 +1,46 @@ <?xml version="1.0" encoding="iso-8859-1"?> - + <reference id="ref.crack"> <title>Funzioni di Crack</title> - <titleabbrev>Funzioni di Crack</titleabbrev> + <titleabbrev>Crack</titleabbrev> <partintro> - <para id="crack.intro"> - Queste funzioni permettono di usare la libreria CrackLib per testare la 'forza' - di una password. La 'forza' di una password è testata attraverso un - controllo sulla lunghezza, sull'uso di maiuscole e minuscole ed un controllo - attraverso lo specifico dizionario di CrackLib. CrackLib darà anche utili messaggi - diagnostici che aiuteranno nel 'rafforzare' la password. - </para> + <section id="crack.intro"> + &reftitle.intro; + <para> + Queste funzioni permettono di usare la libreria CrackLib per testare la 'forza' + di una password. La 'forza' di una password è testata attraverso un + controllo sulla lunghezza, sull'uso di maiuscole e minuscole ed un controllo + attraverso lo specifico dizionario di CrackLib. CrackLib darà anche utili messaggi + diagnostici che aiuteranno nel 'rafforzare' la password. + </para> + &note.pecl-php5; + </section> <section id="crack.requirements"> - <title>Requisiti</title> + &reftitle.required; <para> Maggiori informazioni riguardo CrackLib possono essere trovate, insieme alla libreria, a <ulink url="&url.crack;">&url.crack;</ulink>. </para> </section> - <section id="crack.installation"> - <title>Installazione</title> - <para> - Per utilizzare queste funzioni, bisogna compilare il PHP con il supporto Crack - usando l'opzione <option role="configure">--with-crack[=DIR]</option>. - </para> - </section> + &reference.crack.configure; - <section id="crack.configuration"> - <title>Configurazione a Runtime</title> - &no.config; - </section> + &reference.crack.ini; <section id="crack.resources"> - <title>Tipi di risorsa</title> - &no.config; + &reftitle.resources; + &no.resource; </section> <section id="crack.constants"> - <title>Costanti predefinite</title> - &no.config; + &reftitle.constants; + &no.constants; </section> <section id="crack.examples"> - <title>Esempio</title> + &reftitle.examples; <para> Questo esempio mostra come aprire un dizionario di CrackLib, testare una determinata password, recuperare ogni messaggio diagnostico e chiudere il dizionario. @@ -103,4 +98,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 - --> \ No newline at end of file + --> http://cvs.php.net/diff.php/phpdoc-it/reference/ctype/reference.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-it/reference/ctype/reference.xml diff -u phpdoc-it/reference/ctype/reference.xml:1.3 phpdoc-it/reference/ctype/reference.xml:1.4 --- phpdoc-it/reference/ctype/reference.xml:1.3 Mon Apr 29 14:35:08 2002 +++ phpdoc-it/reference/ctype/reference.xml Wed Jun 23 08:27:30 2004 @@ -1,59 +1,56 @@ <?xml version="1.0" encoding="iso-8859-1"?> -  +  <reference id="ref.ctype"> <title>Funzioni di tipo dei caratteri</title> <titleabbrev>ctype</titleabbrev> <partintro> - <para id="ctype.intro"> - Le funzioni fornite da questa estensione controllano se un carattere - o una stringa rientrano in una classe di caratteri in accordo con - l'ambiente corrente (vedere anche <function>setlocale</function>). - </para> - <para> - Quando vengono chiamate con un numero intero come argomento queste funzioni - si comportano esattamente come il loro equivalente in C presente in "ctype.h". - </para> - <para> - Quando vengono chiamate con una stringa come argomento controlleranno - ogni carattere della stringa e ritorneranno - &true; se ogni carattere della stringa soddisfa il - criterio richiesto. - </para> - <para> - Passare qualsiasi cosa eccetto una stringa o un numero intero - restituirà immediatamenente &false;. - </para> - + <section id="ctype.intro"> + &reftitle.intro; + <para> + Le funzioni fornite da questa estensione controllano se un carattere + o una stringa rientrano in una classe di caratteri in accordo con + l'ambiente corrente (vedere anche <function>setlocale</function>). + </para> + <para> + Quando vengono chiamate con un numero intero come argomento queste funzioni + si comportano esattamente come il loro equivalente in C presente in + <filename>ctype.h</filename>. + </para> + <para> + Quando vengono chiamate con una stringa come argomento controlleranno + ogni carattere della stringa e ritorneranno + &true; se ogni carattere della stringa soddisfa il + criterio richiesto. Quando sono eseguite con una stringa vuota + il risultato è sempre &true; + </para> + <para> + Passare qualsiasi cosa eccetto una stringa o un numero intero + restituirà immediatamenente &false;. + </para> + </section> <section id="ctype.requirements"> - <title>Requisiti</title> + &reftitle.required; <para> Nessuno oltre alle funzioni della libreria standard del C che sono sempre disponibili. </para> </section> - <section id="ctype.installation"> - <title>Installazione</title> - <para> - A partire da PHP 4.2.0 queste funzioni sono abilitate di default. - Per le versioni più vecchie bisogna configurare e compilare PHP - con <option role="configure">--enable-ctype</option>. - </para> - </section> + &reference.ctype.configure; <section id="ctype.configuration"> - <title>Configurazione a Runtime</title> - &no.config; + &reftitle.runtime; + &no.config; </section> <section id="ctype.resources"> - <title>Tipi di risorsa</title> - &no.config; + &reftitle.resources; + &no.resource; </section> <section id="ctype.constants"> - <title>Costanti predefinite</title> - &no.config; + &reftitle.constants; + &no.constants; </section> </partintro> @@ -80,4 +77,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> \ No newline at end of file +--> http://cvs.php.net/diff.php/phpdoc-it/reference/curl/configure.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/curl/configure.xml diff -u phpdoc-it/reference/curl/configure.xml:1.2 phpdoc-it/reference/curl/configure.xml:1.3 --- phpdoc-it/reference/curl/configure.xml:1.2 Fri Jan 16 15:55:15 2004 +++ phpdoc-it/reference/curl/configure.xml Wed Jun 23 08:27:30 2004 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> - + <section id="curl.installation"> &reftitle.install; <para> @@ -10,7 +10,7 @@ chiamata "curl" che dovrebbe contenere i file <filename>easy.h</filename> e <filename>curl.h</filename>. Ci dovrebbe essere un file chiamato <filename>libcurl.a</filename> nella directory "lib". A cominciare da - PHP 4.3.0 si può configurare PHP all'uso di CURL per gli url stream + PHP 4.3.0 si può configurare PHP all'uso di CURL per gli URL stream <option role="configure">--with-curlwrappers</option>. </para> <note> http://cvs.php.net/diff.php/phpdoc-it/reference/curl/reference.xml?r1=1.7&r2=1.8&ty=u Index: phpdoc-it/reference/curl/reference.xml diff -u phpdoc-it/reference/curl/reference.xml:1.7 phpdoc-it/reference/curl/reference.xml:1.8 --- phpdoc-it/reference/curl/reference.xml:1.7 Fri Jan 16 15:55:15 2004 +++ phpdoc-it/reference/curl/reference.xml Wed Jun 23 08:27:30 2004 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> - +  <reference id="ref.curl"> <title>Funzioni CURL, Client URL Library</title> http://cvs.php.net/diff.php/phpdoc-it/reference/cybercash/reference.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-it/reference/cybercash/reference.xml diff -u phpdoc-it/reference/cybercash/reference.xml:1.4 phpdoc-it/reference/cybercash/reference.xml:1.5 --- phpdoc-it/reference/cybercash/reference.xml:1.4 Wed May 1 04:12:58 2002 +++ phpdoc-it/reference/cybercash/reference.xml Wed Jun 23 08:27:30 2004 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> - + <reference id="ref.cybercash"> <title>Funzioni di pagamento Cybercash</title> <titleabbrev>Cybercash</titleabbrev> @@ -12,6 +12,17 @@ con l'opzione <option role="configure">--with-cybercash=[DIR]</option>. </para> + <simpara> + A partire da PHP 4.3.0 questo modulo è stato spostato, ed ora + è reperibile in <ulink url="&url.pecl.package;cybercash">PECL</ulink>. + </simpara> + <simpara> + Se si hanno dubbi sullo stato di CyberCash vedere + <ulink url="&url.cybercash.faq;">CyberCash Faq</ulink> + In breve, CyberCash è stato acquisito da VeriSign e, sebbene il + servizio CyberCash continui ad esistere, VeriSign incoraggia + gli utenti a spostarsi. Vedere la faq precedente e PECL per dettagli. + </simpara> </section> </partintro> http://cvs.php.net/diff.php/phpdoc-it/reference/datetime/reference.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-it/reference/datetime/reference.xml diff -u phpdoc-it/reference/datetime/reference.xml:1.4 phpdoc-it/reference/datetime/reference.xml:1.5 --- phpdoc-it/reference/datetime/reference.xml:1.4 Wed May 1 04:12:59 2002 +++ phpdoc-it/reference/datetime/reference.xml Wed Jun 23 08:27:30 2004 @@ -1,13 +1,12 @@ <?xml version="1.0" encoding="iso-8859-1"?> - + <reference id="ref.datetime"> <title>Funzioni di Data e Ora</title> - <titleabbrev>Data/ora</titleabbrev> + <titleabbrev>Data/Ora</titleabbrev> <partintro> <section id="datetime.intro"> &reftitle.intro; - <para> - Puoi usare queste funzione per la data e l'ora. + <para> Queste funzioni ti permettono di scaricare la data e l'orario dal server dove gira il PHP. Puoi usare queste funzioni per formattare l'output delle date e degli orari in diversi modi. http://cvs.php.net/diff.php/phpdoc-it/reference/dbm/reference.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-it/reference/dbm/reference.xml diff -u phpdoc-it/reference/dbm/reference.xml:1.3 phpdoc-it/reference/dbm/reference.xml:1.4 --- phpdoc-it/reference/dbm/reference.xml:1.3 Mon Apr 29 14:35:10 2002 +++ phpdoc-it/reference/dbm/reference.xml Wed Jun 23 08:27:30 2004 @@ -5,18 +5,62 @@ <titleabbrev>DBM</titleabbrev> <partintro> - <simpara> + <section id="dbm.intro"> + &reftitle.intro; + <para> Questa funzioni consentono lo storage di records memorizzati in un dbm-style database. Questo tipo di database (supportato da Berkeley DB, - GDBM, e qualche libreria di sistema, così come una built-in flatfile library) + <ulink url="&url.gdbm;">GDBM</ulink>, e qualche libreria di sistema, così come una built-in flatfile library) memorizza coppie key/value (al contrario dei full-blown records supportati dai database relazionali). - </simpara> + </para> + <note> + <para> + Il supporto per dbm è deprecato e si incoraggia ad utilizzare + <link linkend="ref.dba">Database (dbm-style) abstraction layer functions</link>. + </para> + </note> + &note.pecl-php5; + </section> + + <section id="dbm.required"> + &reftitle.required; + <para> + Per utilizzare queste funzioni occorre compilare il PHP con il supporto + per un database sottostante. Vedere + <link linkend="dba.requirements">l'elenco</link> dei database supoprtati. + </para> + </section> + + &reference.dbm.configure; + + <section id="dbm.runtime"> + &reftitle.runtime; + &no.config; + </section> + + <section id="dbm.resources"> + &reftitle.resources; + <para> + La funzione <function>dbmopen</function> restituisce un identificatore di database + che può essere utilizzato con le altre funzioni dbm. + </para> + </section> + + <section id="dbm.constants"> + &reftitle.constants; + &no.constants; + </section> + + <section id="dbm.examples"> + &reftitle.examples; <para> <example> <title>Esempio DBM</title> <programlisting role="php"> <![CDATA[ +<?php + $dbm = dbmopen ("lastseen", "w"); if (dbmexists ($dbm, $userid)) { $last_seen = dbmfetch ($dbm, $userid); @@ -24,12 +68,15 @@ dbminsert ($dbm, $userid, time()); } do_stuff(); -dbmreplace ($dbm, $userid, time()); -dbmclose ($dbm); +dbmreplace($dbm, $userid, time()); +dbmclose($dbm); + +?> ]]> </programlisting> </example> </para> + </section> </partintro> &reference.dbm.functions; http://cvs.php.net/diff.php/phpdoc-it/reference/dir/reference.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-it/reference/dir/reference.xml diff -u phpdoc-it/reference/dir/reference.xml:1.5 phpdoc-it/reference/dir/reference.xml:1.6 --- phpdoc-it/reference/dir/reference.xml:1.5 Tue Sep 24 10:33:01 2002 +++ phpdoc-it/reference/dir/reference.xml Wed Jun 23 08:27:30 2004 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> - + <reference id="ref.dir"> <title>Funzioni per le directory</title> <titleabbrev>Directory</titleabbrev> @@ -33,10 +33,7 @@ </para> </section> - <section id="dir.constants"> - &reftitle.constants; - &no.constants; - </section> + &reference.dir.constants; <section id="dir.seealso"> &reftitle.seealso; http://cvs.php.net/diff.php/phpdoc-it/reference/dotnet/reference.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-it/reference/dotnet/reference.xml diff -u phpdoc-it/reference/dotnet/reference.xml:1.3 phpdoc-it/reference/dotnet/reference.xml:1.4 --- phpdoc-it/reference/dotnet/reference.xml:1.3 Mon Apr 29 14:35:12 2002 +++ phpdoc-it/reference/dotnet/reference.xml Wed Jun 23 08:27:30 2004 @@ -1,12 +1,14 @@ <?xml version="1.0" encoding="iso-8859-1"?> - + <reference id="ref.dotnet"> <title>Funzioni .NET</title> - <titleabbrev>Funzioni .NET</titleabbrev> + <titleabbrev>.NET</titleabbrev> <partintro> - <para> - </para> + <section id="dotnet.intro"> + &reftitle.intro; + &warn.experimental; + </section> </partintro> &reference.dotnet.functions; http://cvs.php.net/diff.php/phpdoc-it/reference/errorfunc/reference.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-it/reference/errorfunc/reference.xml diff -u phpdoc-it/reference/errorfunc/reference.xml:1.3 phpdoc-it/reference/errorfunc/reference.xml:1.4 --- phpdoc-it/reference/errorfunc/reference.xml:1.3 Mon Apr 29 14:35:12 2002 +++ phpdoc-it/reference/errorfunc/reference.xml Wed Jun 23 08:27:31 2004 @@ -1,10 +1,12 @@ <?xml version="1.0" encoding="iso-8859-1"?> - + <reference id="ref.errorfunc"> <title>Funzioni di gestione degli errori e di logging</title> <titleabbrev>Errori e logging</titleabbrev> <partintro> + <section id="errorfunc.intro"> + &reftitle.intro; <para> Le seguenti sono le funzioni per la gestione degli errori ed il logging. Esse permettono di definire regole personalizzate per la gestione degli errori, e anche di modificarne @@ -22,6 +24,30 @@ livello e del tipo di errore, dal semplice avviso sino a funzioni personalizzate restituite durante gli errori. </para> + </section> + + <section id="errorfunc.requirements"> + &reftitle.required; + &no.requirement; + </section> + + <section id="errorfunc.installation"> + &reftitle.install; + &no.install; + </section> + + &reference.errorfunc.ini; + + &reference.errorfunc.constants; + + &reference.errorfunc.examples; + + <section id="errorfunc.seealso"> + &reftitle.seealso; + <para> + Vedere anche <function>syslog</function>. + </para> + </section> </partintro> &reference.errorfunc.functions; http://cvs.php.net/co.php/phpdoc-it/reference/crack/configure.xml?r=1.1&p=1 Index: phpdoc-it/reference/crack/configure.xml +++ phpdoc-it/reference/crack/configure.xml <?xml version="1.0" encoding="iso-8859-1"?>  <section id="crack.installation"> &reftitle.install; <para> Per potere utilizzare queste funzioni, occorre compilare il PHP con il supporto per Crack utilizzando <option role="configure">--with-crack[=DIR]</option> option. </para> </section>  http://cvs.php.net/co.php/phpdoc-it/reference/crack/ini.xml?r=1.1&p=1 Index: phpdoc-it/reference/crack/ini.xml +++ phpdoc-it/reference/crack/ini.xml <?xml version="1.0" encoding="iso-8859-1"?>  <section id="crack.configuration"> &reftitle.runtime; &extension.runtime; <para> <table> <title>Opzioni di configurazione per Crack</title> <tgroup cols="3"> <thead> <row> <entry>Nome</entry> <entry>Default</entry> <entry>Modificabile</entry> </row> </thead> <tbody> <row> <entry>crack.default_dictionary</entry> <entry>NULL</entry> <entry>PHP_INI_SYSTEM</entry> </row> </tbody> </tgroup> </table> Per maggiori dettagli e definizioni delle costanti PHP_INI_* vedere <function>ini_set</function>. </para> </section>  http://cvs.php.net/co.php/phpdoc-it/reference/ctype/configure.xml?r=1.1&p=1 Index: phpdoc-it/reference/ctype/configure.xml +++ phpdoc-it/reference/ctype/configure.xml <?xml version="1.0" encoding="iso-8859-1"?>  <section id="ctype.installation"> &reftitle.install; <para> A partire da PHP 4.2.0 queste funzioni sono abilitate di default. Per le versioni più vecchie bisogna configurare e compilare PHP con <option role="configure">--enable-ctype</option>. </para> &windows.builtin; <note> <simpara> Il supporto per CType pre-compilato è disponibile a partire dalla versione 4.3.0. </simpara> </note> </section>  http://cvs.php.net/co.php/phpdoc-it/reference/dbm/configure.xml?r=1.1&p=1 Index: phpdoc-it/reference/dbm/configure.xml +++ phpdoc-it/reference/dbm/configure.xml <?xml version="1.0" encoding="iso-8859-1"?>  <section id="dbm.installation"> &reftitle.install; <para> Per potere utilizzare queste funzioni occorre compilare il PHP con il supporto dbm utilizzando l'opzione <option role="configure">--with-db</option>. Inoltre occorre garantire il <link linkend="dba.installation">supporto</link> per il sottostante database oppure occorre utilizzare qualche libreria di sistema. </para> </section>  http://cvs.php.net/co.php/phpdoc-it/reference/dir/constants.xml?r=1.1&p=1 Index: phpdoc-it/reference/dir/constants.xml +++ phpdoc-it/reference/dir/constants.xml <?xml version='1.0' encoding='iso-8859-1'?>  <section id="dir.constants"> &reftitle.constants; &extension.constants; <variablelist> <varlistentry> <term> <constant>DIRECTORY_SEPARATOR</constant> (<type>string</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>PATH_SEPARATOR</constant> (<type>string</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> </variablelist> <note> <simpara> La costante <constant>PATH_SEPARATOR</constant> è stata inserita dalla versione 4.3.0-RC2. </simpara> </note> </section>  http://cvs.php.net/co.php/phpdoc-it/reference/errorfunc/constants.xml?r=1.1&p=1 Index: phpdoc-it/reference/errorfunc/constants.xml +++ phpdoc-it/reference/errorfunc/constants.xml <?xml version="1.0" encoding="iso-8859-1"?>  <section id="errorfunc.constants"> &reftitle.constants; &extension.constants.core; <note> <simpara> Si possono utilizzare queste constanti in &php.ini; ma non all'esterno del PHP, tipo in in &httpd.conf;, dove occorre utilizzare in valori. </simpara> </note> <table id="errorlevels"> <title>Errori e log</title> <tgroup cols="4"> <thead> <row> <entry>Valore</entry> <entry>Costante</entry> <entry>Descrizione</entry> <entry>Note</entry> </row> </thead> <tbody> <row id="e-error"> <entry>1</entry> <entry> <constant>E_ERROR</constant> (<type>integer</type>) </entry> <entry> Errori fatali di esecuzione. Questi indicano errori che non si possono ignorare, come, ad esempio, errori di allocazione della memoria. L'esecuzione dello script è bloccata. </entry> <entry></entry> </row> <row id="e-warning"> <entry>2</entry> <entry> <constant>E_WARNING</constant> (<type>integer</type>) </entry> <entry> Warning di esecuzione (errori non fatali). L'esecuzione dello script non viene bloccata. </entry> <entry></entry> </row> <row id="e-parse"> <entry>4</entry> <entry> <constant>E_PARSE</constant> (<type>integer</type>) </entry> <entry> Errore di parsing in fase di compila. Essendo errori di parsing sono generati dal parser del codice PHP. </entry> <entry></entry> </row> <row id="e-notice"> <entry>8</entry> <entry> <constant>E_NOTICE</constant> (<type>integer</type>) </entry> <entry> Informazioni di esecuzione. Questo messaggio indica che lo script ha incontrato qualcosa che potrebbe indicare un errore, ma è una sitauzione che può accadere durante una normale esecuzione di uno script. </entry> <entry></entry> </row> <row id="e-core-error"> <entry>16</entry> <entry> <constant>E_CORE_ERROR</constant> (<type>integer</type>) </entry> <entry> Errori fatali che accadono durante la fase di inizializzazione del PHP. Questo è come un <constant>E_ERROR</constant>, tranne che viene generato dall'interno del PHP. </entry> <entry>dal PHP 4</entry> </row> <row id="e-core-warning"> <entry>32</entry> <entry> <constant>E_CORE_WARNING</constant> (<type>integer</type>) </entry> <entry> Warning (errore non fatale) che accade durante la fase di inizializzazione del PHP. Questo è come un <constant>E_WARNING</constant>, tranne che viene generato dall'interno del PHP. </entry> <entry>dal PHP 4</entry> </row> <row id="e-compile-error"> <entry>64</entry> <entry> <constant>E_COMPILE_ERROR</constant> (<type>integer</type>) </entry> <entry> Errore fatale di compila. Questo è come <constant>E_ERROR</constant>, tranne che viene generato dal motore Zend. </entry> <entry>dal PHP 4</entry> </row> <row id="e-compile-warning"> <entry>128</entry> <entry> <constant>E_COMPILE_WARNING</constant> (<type>integer</type>) </entry> <entry> Warning di compila (errore non fatale). Questo è come <constant>E_WARNING</constant>, tranne che viene generato dal motore Zend. </entry> <entry>dal PHP 4</entry> </row> <row id="e-user-error"> <entry>256</entry> <entry> <constant>E_USER_ERROR</constant> (<type>integer</type>) </entry> <entry> Messaggio di errore generato dall'utente. Questo è come <constant>E_ERROR</constant>, tranne che viene generato dal codice PHP tramite la funzione <function>trigger_error</function>. </entry> <entry>dal PHP 4</entry> </row> <row id="e-user-warning"> <entry>512</entry> <entry> <constant>E_USER_WARNING</constant> (<type>integer</type>) </entry> <entry> Messaggio di warning generato dall'utente. Questo è come <constant>E_WARNING</constant>,tranne che viene generato dal codice PHP tramite la funzione <function>trigger_error</function>. </entry> <entry>dal PHP 4</entry> </row> <row id="e-user-notice"> <entry>1024</entry> <entry> <constant>E_USER_NOTICE</constant> (<type>integer</type>) </entry> <entry> Messaggio di informazione generato dall'utente. Questo è come <constant>E_NOTICE</constant>, tranne che viene generato dal codice PHP tramite la funzione <function>trigger_error</function>. </entry> <entry>dal PHP 4</entry> </row> <row id="e-all"> <entry>2047</entry> <entry> <constant>E_ALL</constant> (<type>integer</type>) </entry> <entry> Tutti gli errori ed i warning supportati tranne quelli di livello <constant>E_STRICT</constant>. </entry> <entry></entry> </row> <row id="e-strict"> <entry>2048</entry> <entry> <constant>E_STRICT</constant> (<type>integer</type>) </entry> <entry> Informazione di esecuzione. Abilitare questo messaggio per avere dal PHP suggerimenti sulle modifiche da apportare al codice per avere la migliore interoperabilità e compatibilità del codice. </entry> <entry>dal PHP 5</entry> </row> </tbody> </tgroup> </table> <para> I valori precedenti (sia numerici, sia simbolici) possono essere utilizzati per costruire delle maschere di bit che indichino quali errori visualizzare. Si può utilizzare gli <link linkend="language.operators.bitwise">operatori sui bit</link> per combinare questi valori o per mascherare certi tipi di errori. Fare attenzione che soltanto '|', '~', '!', '^' e '&' sono compresi dal &php.ini;, e che nessun operatore sui bit è gestito dal <filename>php3.ini</filename>. </para> </section>  http://cvs.php.net/co.php/phpdoc-it/reference/errorfunc/examples.xml?r=1.1&p=1 Index: phpdoc-it/reference/errorfunc/examples.xml +++ phpdoc-it/reference/errorfunc/examples.xml <?xml version="1.0" encoding="iso-8859-1"?>  <section id="errorfunc.examples"> &reftitle.examples; <para> Di seguito sarà illustrato un esempio di utilizzo delle procedure di gestione dell'errore in PHP. Qui si definisce una funzione di gestione dell'errore che registra le informazioni in un file (in formato XML) e invia tramite e-mail allo sviluppare dei messaggi in caso di errori critici. <example> <title>Esempio dell'utilizzo di della gestione degli erorri in uno script</title> <programlisting role="php"> <![CDATA[ <?php // attiveremo la nostra gestione degli errori error_reporting(0); // funzione personalizzata di gestione dell'errore function userErrorHandler($errno, $errmsg, $filename, $linenum, $vars) { // orario per la registrazione $dt = date("Y-m-d H:i:s (T)"); // definisce una matrice associativa con i messaggi di errore // in realtà i soli campi che saranno considerati sono // E_WARNING, E_NOTICE, E_USER_ERROR, // E_USER_WARNING and E_USER_NOTICE $errortype = array ( E_ERROR => "Error", E_WARNING => "Warning", E_PARSE => "Parsing Error", E_NOTICE => "Notice", E_CORE_ERROR => "Core Error", E_CORE_WARNING => "Core Warning", E_COMPILE_ERROR => "Compile Error", E_COMPILE_WARNING => "Compile Warning", E_USER_ERROR => "User Error", E_USER_WARNING => "User Warning", E_USER_NOTICE => "User Notice", E_STRICT => "Runtime Notice" ); // indica gli errori per i quali fare salvare la trace delle variabili $user_errors = array(E_USER_ERROR, E_USER_WARNING, E_USER_NOTICE); $err = "<errorentry>\n"; $err .= "\t<datetime>" . $dt . "</datetime>\n"; $err .= "\t<errornum>" . $errno . "</errornum>\n"; $err .= "\t<errortype>" . $errortype[$errno] . "</errortype>\n"; $err .= "\t<errormsg>" . $errmsg . "</errormsg>\n"; $err .= "\t<scriptname>" . $filename . "</scriptname>\n"; $err .= "\t<scriptlinenum>" . $linenum . "</scriptlinenum>\n"; if (in_array($errno, $user_errors)) { $err .= "\t<vartrace>" . wddx_serialize_value($vars, "Variables") . "</vartrace>\n"; } $err .= "</errorentry>\n\n"; // for testing // echo $err; // salva nell'errorlog e invia un e-mail se vi sono errori critici error_log($err, 3, "/usr/local/php4/error.log"); if ($errno == E_USER_ERROR) { mail("phpdev@example.com", "Critical User Error", $err); } } function distance($vect1, $vect2) { if (!is_array($vect1) || !is_array($vect2)) { trigger_error("Incorrect parameters, arrays expected", E_USER_ERROR); return NULL; } if (count($vect1) != count($vect2)) { trigger_error("Vectors need to be of the same size", E_USER_ERROR); return NULL; } for ($i=0; $i<count($vect1); $i++) { $c1 = $vect1[$i]; $c2 = $vect2[$i]; $d = 0.0; if (!is_numeric($c1)) { trigger_error("Coordinate $i in vector 1 is not a number, using zero", E_USER_WARNING); $c1 = 0.0; } if (!is_numeric($c2)) { trigger_error("Coordinate $i in vector 2 is not a number, using zero", E_USER_WARNING); $c2 = 0.0; } $d += $c2*$c2 - $c1*$c1; } return sqrt($d); } $old_error_handler = set_error_handler("userErrorHandler"); // variabile non definita, genera un warning $t = I_AM_NOT_DEFINED; // definisce dei vettori $a = array(2, 3, "foo"); $b = array(5.5, 4.3, -1.6); $c = array(1, -3); // genera un errore utente $t1 = distance($c, $b) . "\n"; // un'altro errore utente $t2 = distance($b, "i am not an array") . "\n"; // genera un warning $t3 = distance($a, $b) . "\n"; ?> ]]> </programlisting> </example> </para> </section>  http://cvs.php.net/co.php/phpdoc-it/reference/errorfunc/ini.xml?r=1.1&p=1 Index: phpdoc-it/reference/errorfunc/ini.xml +++ phpdoc-it/reference/errorfunc/ini.xml <?xml version="1.0" encoding="iso-8859-1"?>  <section id="errorfunc.configuration"> &reftitle.runtime; &extension.runtime; <para> <table> <title>Parametri di configurazione per la gestione degli errori e dei log</title> <tgroup cols="3"> <thead> <row> <entry>Nome</entry> <entry>Default</entry> <entry>Modificabile</entry> </row> </thead> <tbody> <row> <entry>error_reporting</entry> <entry>E_ALL & ~E_NOTICE</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>display_errors</entry> <entry>"1"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>display_startup_errors</entry> <entry>"0"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>log_errors</entry> <entry>"0"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>log_errors_max_len</entry> <entry>"1024"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>ignore_repeated_errors</entry> <entry>"0"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>ignore_repeated_source</entry> <entry>"0"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>report_memleaks</entry> <entry>"1"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>track_errors</entry> <entry>"0"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>html_errors</entry> <entry>"1"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>docref_root</entry> <entry>""</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>docref_ext</entry> <entry>""</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>error_prepend_string</entry> <entry>NULL</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>error_append_string</entry> <entry>NULL</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>error_log</entry> <entry>NULL</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>warn_plus_overloading</entry> <entry>NULL</entry> <entry>PHP_INI??</entry> </row> </tbody> </tgroup> </table> Per maggiori dettaglii e per le definizioni delle costanti PHP_INI_* vedere <function>ini_set</function>. </para> &ini.descriptions.title; <para> <variablelist> <varlistentry id="ini.error-reporting"> <term> <parameter>error_reporting</parameter> <type>integer</type> </term> <listitem> <para> Imposta il livello di errore da visualizzare. Il parametro è sia un intero rappresentante un campo di bit, o una costante nominale. I livelli ri report degli errori e le costanti previste sono descritte in <link linkend="errorfunc.constants">Costanti Predefinite</link>, e in &php.ini;. Per impostare il livello in fase di esecuzione utilizzare la funzione <function>error_reporting</function>. Vedere anche il parametro <link linkend="ini.display-errors">display_errors</link>. </para> <para> In PHP 4 e PHP 5 il valore di default è E_ALL & ~E_NOTICE. Questa impostazione non visualizza gli errori di livello <constant>E_NOTICE</constant>. Tuttavia può essere comodo visualizzare questi messaggi in fase di sviluppo. </para> <note> <para>Abilitare <constant>E_NOTICE</constant> durante la fase di sviluppo ha dei benefici. Ad esempio per scopi di debug: i messaggi di tipo NOTICE avvisano su possibili bug nel codice. L'uso di variabili non assegnate, ad esempio, viene rilevato con questo livello di errore. Particolare che è molto utile per trovare errori di battitura e risparmiare tempo in fase di debug. I messaggi di tipo NOTICE segnalano il codice scritto con un cattivo stile. Ad esempio, $arr[item] è meglio che sia scritto come $arr['item'] poichè il PHP tenta di trattare "item" come costante. Se non esiste una simile costante, il PHP presume che si tratti dell'indice di una matrice. </para> </note> <note> <para> Nel PHP 5 è stato introdotto un nuovo livello di errore <constant>E_STRICT</constant>. Come <constant>E_STRICT</constant> non viene incluso nel <constant>E_ALL</constant> e, pertanto, occorre abilitarlo in modo esplicito. Abilitare <constant>E_STRICT</constant> durante la fase di sviluppo porta alcuni benefici. Questa casistica di messaggi servono ad aiutare le più recenti, e consigliate, metodologie di programamzione, avvisando, ad esempio, sull'uso di funzioni deprecate. </para> </note> <para> In PHP 3 l'impostazione di default è <literal>(E_ERROR | E_WARNING | E_PARSE)</literal>, che significa la medesima cosa. Occorre rilevare, tuttavia, che le costanti non sono supportate nel <filename>php3.ini</filename> del PHP 3, e pertanto occorre utilizzare la codifica numerica, che corrisponde a <literal>7</literal>. </para> </listitem> </varlistentry> <varlistentry id="ini.display-errors"> <term> <parameter>display_errors</parameter> <type>boolean</type> </term> <listitem> <para> Questo parametro determina se gli errori devono essere visualizzati sullo schermo come parte dell'output o se devono essere nascosti all'utente. </para> <note> <para> Questa opzione è di supporto allo sviluppo, e non deve mai essere utilizzata nei sistemi di produzione (ad esempio collegati ad Internet). </para> </note> </listitem> </varlistentry> <varlistentry id="ini.display-startup-errors"> <term> <parameter>display_startup_errors</parameter> <type>boolean</type> </term> <listitem> <para> Anche quando è abilitata la visualizzazione degli errori, gli errori che avvengono durante l'avvio del PHP non sono visualizzati. Si raccomanda di mantenere display_startup_errors impostato a off, tranne che nelle fasi di sviluppo. </para> </listitem> </varlistentry> <varlistentry id="ini.log-errors"> <term> <parameter>log_errors</parameter> <type>boolean</type> </term> <listitem> <para> Indica se i messaggi di errore debbano essere registrati nell'errorlog del server o in <link linkend="ini.error-log">error_log</link>. Questo opzione dipende dal server. </para> <note> <para> Sui siti di produzione si raccomanda di utilizzare la registrazione degli errori piuttosto che visualizzarli. </para> </note> </listitem> </varlistentry> <varlistentry id="ini.log-errors-max-len"> <term> <parameter>log_errors_max_len</parameter> <type>integer</type> </term> <listitem> <para> Imposta la massima lunghezza del log degli errori in byte. Nell'errorlog <link linkend="ini.error-log">error_log</link> viene indicata anche la fonte del messaggio. Il valore di default è 1024 e 0 indica di non applicare alcuna limitazione. </para> </listitem> </varlistentry> <varlistentry id="ini.ignore-repeated-errors"> <term> <parameter>ignore_repeated_errors</parameter> <type>boolean</type> </term> <listitem> <para> Do not log repeated messages. Repeated errors must occur in the same file on the same line until <link linkend="ini.ignore-repeated-source">ignore_repeated_source</link> is set true. </para> </listitem> </varlistentry> <varlistentry id="ini.ignore-repeated-source"> <term> <parameter>ignore_repeated_source</parameter> <type>boolean</type> </term> <listitem> <para> Ignore source of message when ignoring repeated messages. When this setting is On you will not log errors with repeated messages from different files or sourcelines. </para> </listitem> </varlistentry> <varlistentry id="ini.report-memleaks"> <term> <parameter>report_memleaks</parameter> <type>boolean</type> </term> <listitem> <para> If this parameter is set to Off, then memory leaks will not be shown (on stdout or in the log). This has only effect in a debug compile, and if <link linkend="ini.error-reporting">error_reporting</link> includes E_WARNING in the allowed list </para> </listitem> </varlistentry> <varlistentry id="ini.track-errors"> <term> <parameter>track_errors</parameter> <type>boolean</type> </term> <listitem> <para> If enabled, the last error message will always be present in the variable <link linkend="reserved.variables.phperrormsg">$php_errormsg</link>. </para> </listitem> </varlistentry> <varlistentry id="ini.html-errors"> <term> <parameter>html_errors</parameter> <type>boolean</type> </term> <listitem> <para> Turn off HTML tags in error messages. The new format for HTML errors produces clickable messages that direct the user to a page describing the error or function in causing the error. These references are affected by <link linkend="ini.docref-root">docref_root</link> and <link linkend="ini.docref-ext">docref_ext</link>. </para> </listitem> </varlistentry> <varlistentry id="ini.docref-root"> <term> <parameter>docref_root</parameter> <type>string</type> </term> <listitem> <para> The new error format contains a reference to a page describing the error or function causing the error. In case of manual pages you can download the manual in your language and set this ini directive to the URL of your local copy. If your local copy of the manual can be reached by '/manual/' you can simply use <userinput>docref_root=/manual/</userinput>. Additional you have to set docref_ext to match the fileextensions of your copy <userinput>docref_ext=.html</userinput>. It is possible to use external references. For example you can use <userinput>docref_root=http://manual/en/</userinput> or <userinput>docref_root="http://landonize.it/?how=url&theme=classic&filter=Landon &url=http%3A%2F%2Fwww.php.net%2F"</userinput> </para> <para> Most of the time you want the docref_root value to end with a slash '/'. But see the second example above which does not have nor need it. </para> <note> <para> This is a feature to support your development since it makes it easy to lookup a function description. However it should never be used on production systems (e.g. systems connected to the internet). </para> </note> </listitem> </varlistentry> <varlistentry id="ini.docref-ext"> <term> <parameter>docref_ext</parameter> <type>string</type> </term> <listitem> <para> See <link linkend="ini.docref-root">docref_root</link>. </para> <note> <para> The value of docref_ext must begin with a dot '.'. </para> </note> </listitem> </varlistentry> <varlistentry id="ini.error-prepend-string"> <term> <parameter>error_prepend_string</parameter> <type>string</type> </term> <listitem> <para> String to output before an error message. </para> </listitem> </varlistentry> <varlistentry id="ini.error-append-string"> <term> <parameter>error_append_string</parameter> <type>string</type> </term> <listitem> <para> String to output after an error message. </para> </listitem> </varlistentry> <varlistentry id="ini.error-log"> <term> <parameter>error_log</parameter> <type>string</type> </term> <listitem> <para> Name of the file where script errors should be logged. If the special value <literal>syslog</literal> is used, the errors are sent to the system logger instead. On Unix, this means syslog(3) and on Windows NT it means the event log. The system logger is not supported on Windows 95. See also: <function>syslog</function>. </para> </listitem> </varlistentry> <varlistentry id="ini.warn-plus-overloading"> <term> <parameter>warn_plus_overloading</parameter> <type>boolean</type> </term> <listitem> <para> If enabled, this option makes PHP output a warning when the plus (<literal>+</literal>) operator is used on strings. This is to make it easier to find scripts that need to be rewritten to using the string concatenator instead (<literal>.</literal>). </para> </listitem> </varlistentry> </variablelist> </para> </section>  http://cvs.php.net/co.php/phpdoc-it/reference/strings/charsets.xml?r=1.1&p=1 Index: phpdoc-it/reference/strings/charsets.xml +++ phpdoc-it/reference/strings/charsets.xml <?xml version="1.0" encoding="iso-8859-1"?>  <para> Elenco dei set di caratteri supportati dal PHP 4.3.0 e successivi. <table> <title>set di caratteri supportati</title> <tgroup cols="3"> <thead> <row> <entry>Set di caratteri</entry> <entry>Alias</entry> <entry>Descrizione</entry> </row> </thead> <tbody> <row> <entry>ISO-8859-1</entry> <entry>ISO8859-1</entry> <entry> Western European, Latin-1 </entry> </row> <row> <entry>ISO-8859-15</entry> <entry>ISO8859-15</entry> <entry> Western European, Latin-9. Con in più il simbolo dell'Euro e i caratteri francesi e finnici mancanti in Latin-1(ISO-8859-1). </entry> </row> <row> <entry>UTF-8</entry> <entry></entry> <entry> Set ASCII compatibile con il set multi-byte Unicode su 8-bit. </entry> </row> <row> <entry>cp866</entry> <entry>ibm866, 866</entry> <entry> Set di caratteri cirillico specifico del Dos. Supportato dalla 4.3.2. </entry> </row> <row> <entry>cp1251</entry> <entry>Windows-1251, win-1251, 1251</entry> <entry> Set di caratteri cirillico specifico di Windows, Supportato dalla 4.3.2. </entry> </row> <row> <entry>cp1252</entry> <entry>Windows-1252, 1252</entry> <entry> Set di caratteri specifico di Windows per l'Europa occidentale. </entry> </row> <row> <entry>KOI8-R</entry> <entry>koi8-ru, koi8r</entry> <entry> Russo. Supportato dalla 4.3.2. </entry> </row> <row> <entry>BIG5</entry> <entry>950</entry> <entry> Cinese tradizionale, usato principalmente a Taiwan. </entry> </row> <row> <entry>GB2312</entry> <entry>936</entry> <entry> Cinese semplificato, set di caratteri nazionale standard. </entry> </row> <row> <entry>BIG5-HKSCS</entry> <entry></entry> <entry> Big5 con estensioni per Hong Kong, cinese tradizionale. </entry> </row> <row> <entry>Shift_JIS</entry> <entry>SJIS, 932</entry> <entry> Giapponese. </entry> </row> <row> <entry>EUC-JP</entry> <entry>EUCJP</entry> <entry> Giapponese. </entry> </row> </tbody> </tgroup> </table> <note> <simpara> Ogni altro set di caratteri non è riconosciuto e sarà sostituito con con il set ISO-8859-1. </simpara> </note> </para>  http://cvs.php.net/co.php/phpdoc-it/reference/strings/constants.xml?r=1.1&p=1 Index: phpdoc-it/reference/strings/constants.xml +++ phpdoc-it/reference/strings/constants.xml <?xml version='1.0' encoding='iso-8859-1'?>  <section id="string.constants"> &reftitle.constants; &extension.constants; <variablelist> <varlistentry> <term> <constant>CRYPT_SALT_LENGTH</constant> <type>integer</type> </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>CRYPT_STD_DES</constant> <type>integer</type> </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>CRYPT_EXT_DES</constant> <type>integer</type> </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>CRYPT_MD5</constant> <type>integer</type> </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>CRYPT_BLOWFISH</constant> <type>integer</type> </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>HTML_SPECIALCHARS</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>HTML_ENTITIES</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>ENT_COMPAT</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>ENT_QUOTES</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>ENT_NOQUOTES</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>CHAR_MAX</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LC_CTYPE</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LC_NUMERIC</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LC_TIME</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LC_COLLATE</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LC_MONETARY</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LC_ALL</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>LC_MESSAGES</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>STR_PAD_LEFT</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>STR_PAD_RIGHT</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>STR_PAD_BOTH</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> </variablelist> </section>  http://cvs.php.net/co.php/phpdoc-it/reference/strings/reference.xml?r=1.1&p=1 Index: phpdoc-it/reference/strings/reference.xml +++ phpdoc-it/reference/strings/reference.xml <?xml version="1.0" encoding="iso-8859-1"?>  <reference id="ref.strings"> <title>Stringhe</title> <titleabbrev>Strings</titleabbrev> <partintro> <section id="strings.intro"> &reftitle.intro; <para> Queste funzioni permettono di manipolare le stringhe in vari modi. Ulteriori funzioni specializzate possono essere trovate nel capitolo dedicato alle espressioni regolari e nel capitolo <link linkend="ref.url">trattamento degli URL</link>. </para> <para> Per dettagli su come si comportano le stringhe, in particolare a riguardo l'uso degli apici singoli, doppi apici, e sequenze di escape, vedere il paragrafo <link linkend="language.types.string">Stringhe</link> nel capitolo <link linkend="language.types">Tipi</link> del manuale. </para> </section> <section id="strings.requirements"> &reftitle.required; &no.requirement; </section> <section id="strings.installation"> &reftitle.install; &no.install; </section> &reference.strings.constants; <section id="strings.seealso"> &reftitle.seealso; <para> Per funzioni più potenti nel gestire e manipolare le stringhe vedere anche i capitoli <link linkend="ref.regex">Funzioni per espressioni regolari POSIX</link> e <link linkend="ref.pcre">Funzioni per espressioni regolari compatibili Perl</link>. </para> </section> </partintro> &reference.strings.functions; </reference>  http://cvs.php.net/co.php/phpdoc-it/reference/strings/functions/addcslashes.xml?r=1.1&p=1 Index: phpdoc-it/reference/strings/functions/addcslashes.xml +++ phpdoc-it/reference/strings/functions/addcslashes.xml <?xml version="1.0" encoding="iso-8859-1"?>   <refentry id="function.addcslashes"> <refnamediv> <refname>addcslashes</refname> <refpurpose>Esegue il quoting di una stringa con gli slash nello stile del C</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>string</type><methodname>addcslashes</methodname> <methodparam><type>string</type><parameter>str</parameter></methodparam> <methodparam><type>string</type><parameter>charlist</parameter></methodparam> </methodsynopsis> <para> La funzione restituisce una stringa con il carattere di backslash '\' anteposto ai caratteri che sono indicati nel parametro <parameter>charlist</parameter>. La funzione inserisce il carattere di escape nello stile C in caso di <literal>\n</literal>, <literal>\r</literal> ecc., in caso di caratteri con codifica ASCII minore di 32 o superiore a 126 si applica la conversione nella rappresentazione ottale. </para> <para> Occorre prestare attenzione se si imposta di anteporre il carattere di escape ai caratteri 0, a, b, f, n, r, t e v. Questi sranno convertiti in \0, \a, \b, \f, \n, \r, \t e \v. In PHP \0 (&null;), \r (carriage return), \n (newline) e \t (tab) sono sequenze di escape predefinite, anche in C tutte queste sono sequenze di escape predefinite. </para> <para> Valorizzare il parametro <parameter>charlist</parameter> con "\0..\37", significa che si vuole inserire il carattere di escape davanti ai caratteri la cui codifica ASCII è comprese tra 0 e 37. <example> <title>Esempio di uso di <function>addcslashes</function></title> <programlisting role="php"> <![CDATA[ <?php $escaped = addcslashes($not_escaped, "\0..\37!@\177..\377"); ?> ]]> </programlisting> </example> </para> <para> Quando si definisca una sequenza di caratteri nel parametro <parameter>charlist</parameter> occorre essere consapevoli di quali caratteri sono compresi nel range. <informalexample> <programlisting role="php"> <![CDATA[ <?php echo addcslashes('foo[ ]', 'A..z'); // output: \f\o\o\[ \] // Inserisce l'escape davanti a tutti i caratteri maiuscoli e minuscoli // ... ma anche [\]^_` i tab, line // feeds, carriage returns, etc. ?> ]]> </programlisting> </informalexample> Inoltre, se il primo carattere di un range ha una codifica ASCII maggiore del secondo, il range non sarà applicato. Soltanto il primo, i punti, e l'ultimo carattere avrà la sequenza di escape. Utilizzare la funzione <function>ord</function> per ottenere la codifica ASCII di un carattere. <informalexample> <programlisting role="php"> <![CDATA[ <?php echo addcslashes("zoo['.']", 'z..A'); // output: \zoo['\.'] ?> ]]> </programlisting> </informalexample> </para> <para> Vedere anche <function>stripcslashes</function>, <function>stripslashes</function>, <function>htmlspecialchars</function> e <function>quotemeta</function>. </para> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/strings/functions/addslashes.xml?r=1.1&p=1 Index: phpdoc-it/reference/strings/functions/addslashes.xml +++ phpdoc-it/reference/strings/functions/addslashes.xml <?xml version="1.0" encoding="iso-8859-1"?>   <refentry id="function.addslashes"> <refnamediv> <refname>addslashes</refname> <refpurpose>Esegue il quoting di una stringa con gli slash '/'</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>string</type><methodname>addslashes</methodname> <methodparam><type>string</type><parameter>str</parameter></methodparam> </methodsynopsis> <para> La funzione restituisce una stringa con il carattere di backslah '\' anteposto ai caratteri che richiedono il quoting nelle query dei database. Questi caratteri sono: apici singoli (<literal>'</literal>), doppi apici (<literal>"</literal>), backslash (<literal>\</literal>) e NUL (il byte &null;). </para> <para> Un esempio di utilizzo di <function>addslashes</function> è dato dal caso in cui si inserisce dei dati in un database. Ad esempio, per inserire il nome <literal>O'reilly</literal> in un database, occorre anteporre il carattere di escape. Molti database eseguono questo compito con il carattere <literal>\</literal>, quindi il nostro esempio diventerebbe <literal>O\'reilly</literal>. Questo serve solo per inserire i dati nel database, il carattere in più <literal>\</literal> non sarà inserito. Impostando la direttiva PHP <link linkend="ini.magic-quotes-sybase"> magic_quotes_sybase</link> a <literal>on</literal> si indica che <literal>'</literal> deve essere preceduto da un'altro <literal>'</literal>. </para> <para> La direttiva PHP <link linkend="ini.magic-quotes-gpc"> magic_quotes_gpc</link> è impostata a <literal>on</literal> per default, ed in pratica esegue <function>addslashes</function> su tuti i dati GET, POST, e COOKIE. Non utilizzare <function>addslashes</function> su stringhe che hanno già il carattere di escape per via del parametro <link linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link> altrimenti si ottiene un doppio escape. La funzione <function>get_magic_quotes_gpc</function> può aiutare nella verifica di questa situazione. </para> <para> <example> <title>Esempio di uso di <function>addslashes</function></title> <programlisting role="php"> <![CDATA[ <?php $str = "Is your name O'reilly?"; // Outputs: Is your name O\'reilly? echo addslashes($str); ?> ]]> </programlisting> </example> </para> <para> Vedere anche <function>stripslashes</function>, <function>htmlspecialchars</function>, <function>quotemeta</function> e <function>get_magic_quotes_gpc</function>. </para> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/strings/functions/bin2hex.xml?r=1.1&p=1 Index: phpdoc-it/reference/strings/functions/bin2hex.xml +++ phpdoc-it/reference/strings/functions/bin2hex.xml <?xml version="1.0" encoding="iso-8859-1"?>   <refentry id="function.bin2hex"> <refnamediv> <refname>bin2hex</refname> <refpurpose> Converte i dati binari nella rappresentazione esadecimale </refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>string</type><methodname>bin2hex</methodname> <methodparam><type>string</type><parameter>str</parameter></methodparam> </methodsynopsis> <para> La funzione restituisce una stringa ASCII contenente la rappresentazione esadecimale del parametro <parameter>str</parameter>. La conversione viene eseguita byte per byte considerando prima il semi-byte più significativo. </para> <para> Vedere anche <function>pack</function> e <function>unpack</function>. </para> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/strings/functions/chop.xml?r=1.1&p=1 Index: phpdoc-it/reference/strings/functions/chop.xml +++ phpdoc-it/reference/strings/functions/chop.xml <?xml version="1.0" encoding="iso-8859-1"?>   <refentry id="function.chop"> <refnamediv> <refname>chop</refname> <refpurpose>Alias di <function>rtrim</function></refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <para> Questa funzione è un alias di <function>rtrim</function>. </para> <note> <para> <function>chop</function> è differente rispetto alla omonima funzione di Perl <literal>chop()</literal>, la quale rimuove l'ultimo carattere della stringa. </para> </note> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/strings/functions/chr.xml?r=1.1&p=1 Index: phpdoc-it/reference/strings/functions/chr.xml +++ phpdoc-it/reference/strings/functions/chr.xml <?xml version="1.0" encoding="iso-8859-1"?>   <refentry id="function.chr"> <refnamediv> <refname>chr</refname> <refpurpose>Restituisce un carattere specifico</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>string</type><methodname>chr</methodname> <methodparam><type>int</type><parameter>ascii</parameter></methodparam> </methodsynopsis> <para> La funzione restituisce una stringa di un carattere contenente il carattere indicato come codifica ASCII nel parametro <parameter>ascii</parameter>. <example> <title>Esempio di uso di <function>chr</function></title> <programlisting role="php"> <![CDATA[ <?php $str = "La stringa termina con un escape: "; $str .= chr(27); /* aggiunge il carattere diescape al termine di $str */ /* Spesso è più pratico */ $str = sprintf("The string ends in escape: %c", 27); ?> ]]> </programlisting> </example> </para> <para> A questo link <ulink url="&url.asciitable;" >&url.asciitable;</ulink> si può trovare una tavola delle codifiche ASCII. </para> <para> Questa funzione è complementare rispetto a <function>ord</function>. Vedere anche <function>sprintf</function> con la stringa di formato <literal>%c</literal>. </para> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/strings/functions/chunk-split.xml?r=1.1&p=1 Index: phpdoc-it/reference/strings/functions/chunk-split.xml +++ phpdoc-it/reference/strings/functions/chunk-split.xml <?xml version="1.0" encoding="iso-8859-1"?>   <refentry id="function.chunk-split"> <refnamediv> <refname>chunk_split</refname> <refpurpose>Divide una stringa in segmento più piccoli</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>string</type><methodname>chunk_split</methodname> <methodparam><type>string</type><parameter>body</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>chunklen</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>end</parameter></methodparam> </methodsynopsis> <para> Questa funzione può essere utilizzata per suddividere una stringa in segmenti più ridotti, per possono essere utili, ad esempio, nel convertire l'output della funzione <function>base64_encode</function> in modo da aderire alle specifiche indicate nella RFC 2045. La funzione inserisce <parameter>end</parameter> (il default è "\r\n") ad ogni <parameter>chunklen</parameter> caratteri (default è 76). La funzione restituisce una nuova stringa lasciando inalterata la stringa originale. <example> <title>Esempio di uso di <function>chunk_split</function></title> <programlisting role="php"> <![CDATA[ <?php // format $data using RFC 2045 semantics $new_string = chunk_split(base64_encode($data)); ?> ]]> </programlisting> </example> </para> <simpara> Vedere anche <function>str_split</function>, <function>explode</function>, <function>split</function>, <function>wordwrap</function> e <ulink url="&url.rfc;2045">RFC 2045</ulink>. </simpara> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/strings/functions/convert-cyr-string.xml?r=1.1&p=1 Index: phpdoc-it/reference/strings/functions/convert-cyr-string.xml +++ phpdoc-it/reference/strings/functions/convert-cyr-string.xml <?xml version="1.0" encoding="iso-8859-1"?>   <refentry id="function.convert-cyr-string"> <refnamediv> <refname>convert_cyr_string</refname> <refpurpose> Converte da un set di caratteri Cirillico ad un'altro </refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>string</type><methodname>convert_cyr_string</methodname> <methodparam><type>string</type><parameter>str</parameter></methodparam> <methodparam><type>string</type><parameter>from</parameter></methodparam> <methodparam><type>string</type><parameter>to</parameter></methodparam> </methodsynopsis> <para> Questa funzione restituisce la stringa data convertita da un set di caratteri Cirillico ad un altro. I parametri <parameter>from</parameter> e <parameter>to</parameter> rappresentano il set di caratteri Cirillici di origine e di destinazione. I tipi supportati sono: <itemizedlist> <listitem> <simpara> k - koi8-r </simpara> </listitem> <listitem> <simpara> w - windows-1251 </simpara> </listitem> <listitem> <simpara> i - iso8859-5 </simpara> </listitem> <listitem> <simpara> a - x-cp866 </simpara> </listitem> <listitem> <simpara> d - x-cp866 </simpara> </listitem> <listitem> <simpara> m - x-mac-cyrillic </simpara> </listitem> </itemizedlist> </para> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/strings/functions/convert-uudecode.xml?r=1.1&p=1 Index: phpdoc-it/reference/strings/functions/convert-uudecode.xml +++ phpdoc-it/reference/strings/functions/convert-uudecode.xml <?xml version='1.0' encoding='iso-8859-1'?>  <refentry id="function.convert-uudecode"> <refnamediv> <refname>convert_uudecode</refname> <refpurpose> Decodifica una stringa codificata con uuencode </refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>string</type><methodname>convert_uudecode</methodname> <methodparam><type>string</type><parameter>data</parameter></methodparam> </methodsynopsis> &warn.undocumented.func; </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/strings/functions/convert-uuencode.xml?r=1.1&p=1 Index: phpdoc-it/reference/strings/functions/convert-uuencode.xml +++ phpdoc-it/reference/strings/functions/convert-uuencode.xml <?xml version='1.0' encoding='iso-8859-1'?>  <refentry id="function.convert-uuencode"> <refnamediv> <refname>convert_uuencode</refname> <refpurpose> Codifica uuencode di una stringa </refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>string</type><methodname>convert_uuencode</methodname> <methodparam><type>string</type><parameter>data</parameter></methodparam> </methodsynopsis> &warn.undocumented.func; </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/strings/functions/count-chars.xml?r=1.1&p=1 Index: phpdoc-it/reference/strings/functions/count-chars.xml +++ phpdoc-it/reference/strings/functions/count-chars.xml <?xml version="1.0" encoding="iso-8859-1"?>   <refentry id="function.count-chars"> <refnamediv> <refname>count_chars</refname> <refpurpose> Restituisce informazioni sui caratteri usati in una stringa </refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>mixed</type><methodname>count_chars</methodname> <methodparam><type>string</type><parameter>string</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam> </methodsynopsis> <para> La funzione conta il numero di occorrenze di ogni carattere (0..255) nella stringa <parameter>string</parameter> e li restituisce in vari modi. Il parametro opzionale <parameter>mode</parameter> ha come default 0. In base alle impostazioni di <parameter>mode</parameter> la funzione <function>count_chars</function> restituisce: <itemizedlist> <listitem> <simpara> 0 - una matrice in cui ogni carattere (come codifica ASCII) è la chiave e la sua frequenza il valore. </simpara> </listitem> <listitem> <simpara> 1 - come lo 0 ma saranno restituiti solo i caratteri con frequenza maggiore di zero. </simpara> </listitem> <listitem> <simpara> 2 - come lo 0 ma saranno restituiti solo i caratteri con frequenza uguale a zero. </simpara> </listitem> <listitem> <simpara> 3 - la funzione restituisce una stringa con tutti i caratteri utilizzati. </simpara> </listitem> <listitem> <simpara> 4 - la funzione restituisce una stringa con tutti i caratteri non utilizzati. </simpara> </listitem> </itemizedlist> </para> <para> <example> <title>Esempio di uso di <function>count_chars</function></title> <programlisting role="php"> <![CDATA[ <?php $data = "Two Ts and one F."; $result = count_chars($data, 0); for ($i=0; $i < count($result); $i++) { if ($result[$i] != 0) echo "Vi sono $result[$i] istanze di \"" , chr($i) , "\" nella stringa.\n"; } ?> ]]> </programlisting> <para> Questo esempio visualizzerà: </para> <screen> <![CDATA[ Vi sono 4 istanze di " " nella stringa. Vi sono 1 istanze di "." nella stringa. Vi sono 1 istanze di "F" nella stringa. Vi sono 2 istanze di "T" nella stringa. Vi sono 1 istanze di "a" nella stringa. Vi sono 1 istanze di "d" nella stringa. Vi sono 1 istanze di "e" nella stringa. Vi sono 2 istanze di "n" nella stringa. Vi sono 2 istanze di "o" nella stringa. Vi sono 1 istanze di "s" nella stringa. Vi sono 1 istanze di "w" nella stringa. ]]> </screen> </example> </para> <simpara> Vedere anche <function>strpos</function> e <function>substr_count</function>. </simpara> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/strings/functions/crc32.xml?r=1.1&p=1 Index: phpdoc-it/reference/strings/functions/crc32.xml +++ phpdoc-it/reference/strings/functions/crc32.xml <?xml version="1.0" encoding="iso-8859-1"?>   <refentry id="function.crc32"> <refnamediv> <refname>crc32</refname> <refpurpose>Cacola il crc32 polinomiale di una stringa</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>int</type><methodname>crc32</methodname> <methodparam><type>string</type><parameter>str</parameter></methodparam> </methodsynopsis> <para> La funzione calcola il checksum lungo 32 bit della stringa <parameter>str</parameter>. Solitamente questo viene utilizzato per validare i dati trasmessi. </para> <para> Poichè il tipo intero del PHP è segnato, è diversi checksum crc32 hanno risultati negativi, occorre utilizzare il formato "%u" di <function>sprintf</function> o di <function>printf</function> per ottenere una rappresentazione stringa di un checksum crc32 privo di segno. </para> <para> Questo secondo esempio mostra come visualizzare un checksum convertito con la funzione <function>printf</function>: <example> <title>Visualizzazione di un checksum crc32</title> <programlisting role="php"> <![CDATA[ <?php $checksum = crc32("The quick brown fox jumped over the lazy dog."); printf("%u\n", $checksum); ?> ]]> </programlisting> </example> </para> <para> Vedere anche <function>md5</function> e <function>sha1</function>. </para> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/strings/functions/crypt.xml?r=1.1&p=1 Index: phpdoc-it/reference/strings/functions/crypt.xml +++ phpdoc-it/reference/strings/functions/crypt.xml <?xml version="1.0" encoding="iso-8859-1"?>   <refentry id="function.crypt"> <refnamediv> <refname>crypt</refname> <refpurpose>Criptazione di una stringa a senso unico (hashing)</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>string</type><methodname>crypt</methodname> <methodparam><type>string</type><parameter>str</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>salt</parameter></methodparam> </methodsynopsis> <para> La funzione <function>crypt</function> restituisce una stringa criptata tramite l'algoritmo standard di crittografia di UNIX basato sul <abbrev>DES</abbrev> o su algoritmo alternativi disponibili sul sistema. I parametri sono la stringa che deve essere crittografata, e un parametro opzionale da usarsi come base per la crittografia. Vedere le pagine Unix relative alla funzione cript per maggiori dettagli. </para> <simpara> Se il parametro salt non viene fornito, il PHP ne genererà uno casuale. </simpara> <simpara> Alcuni sistemi operativi supportano più di un tipo di criptazione. Infatti in alcuni casi lo standard basato sul DES viene sostituito da un algoritmo basato su MD5. Il tipo di crittografia da utilizzare viene attivato tramite il parametro salt. Al momento dell'installazione il PHP cerca di determinare le caratteristiche della funzione crypt e accetterà salt per altri tipi di funzioni. Se il parametro salt non viene passato, il PHP genererà, per default, una chiave di due caratteri a meno che il sistema di cifratura di default del sistema non sia MD5, in questo caso si genererà una chiave casuale compatibile con MD5. Il PHP imposta una costante chiamata CRYPT_SALT_LENGTH dalla quale si può sapere se sul sistema si può utilizzare una chiave di due caratteri o la chiave più lunga di 12 caratteri. </simpara> <simpara> Se si usa la chiave generata, bisogna fare attenzione che questa viene generata una sola volta. Se si chiama la funzione ricorsivamente, si possono avere dei problemi di formato e di sicurezza. </simpara> <simpara> La crittografia basa sullo standard DES restituisce la chiave come primi due caratteri dell'output. Inoltre utilizza solo i primi 8 caratteri del parametro <parameter>str</parameter>, pertanto stringhe più lunghe che inizino con i medesimi otto caratteri, creeranno il medesimo risultato (se si utilizza la medesima chiave). </simpara> <simpara> Sui sistemi nei quali la funzione cript() supporta più tipi di crittografia, si imposteranno le seguenti costanti a 0 o a 1 in base al tipo disponibile. </simpara> <itemizedlist> <listitem> <simpara> CRYPT_STD_DES - Standard basato su DES con chiave di due caratteri </simpara> </listitem> <listitem> <simpara> CRYPT_EXT_DES - Estensione basato su DES con chiave di nove caratteri </simpara> </listitem> <listitem> <simpara> CRYPT_MD5 - Crittografia basata su MD5 con 12 caratteri di chiave inizianti con $1$ </simpara> </listitem> <listitem> <simpara> CRYPT_BLOWFISH - Crittografia Blowfish con 16 caratteri di chiave inizianti con $2$ </simpara> </listitem> </itemizedlist> <note> <simpara> Non esiste una funzione di decriptazione, poiché <function>crypt</function> è un algoritmo ad una via. </simpara> </note> <example> <title>Esempio di uso di <function>crypt</function></title> <programlisting role="php"> <![CDATA[ <?php $password = crypt("My1sTpassword"); // let salt be generated # Si dovrebbe passare l'intero risultato di crypt() come chiave di confronto # della password per evitare problemi con differenti algoritmi di hash. (Come detto prima # lo standard basato su DES usa chiavi di 2 caratteri, # mentre lo standard basato su MD5 ne usa 12). if (crypt($user_input, $password) == $password) { echo "Password verified!"; } ?> ]]> </programlisting> </example> <simpara> Vedere anche <function>md5</function> e <link linkend="ref.mcrypt">il modulo Mcrypt</link>. </simpara> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/strings/functions/echo.xml?r=1.1&p=1 Index: phpdoc-it/reference/strings/functions/echo.xml +++ phpdoc-it/reference/strings/functions/echo.xml <?xml version="1.0" encoding="iso-8859-1"?>   <refentry id="function.echo"> <refnamediv> <refname>echo</refname> <refpurpose>Visualizza una o più stringhe</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>void</type><methodname>echo</methodname> <methodparam><type>string</type><parameter>arg1</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>argn...</parameter></methodparam> </methodsynopsis> <simpara> Visualizza tutti i parametri. </simpara> <para> <function>echo</function> in realtà non è una funzione (è un costrutto del linguaggio) pertanto non richiede l'uso di parametri. Infatti, se si vuole passare più di un parametro, non bisogna racchiuderli tra parentesi. </para> <para> <example> <title>Esempi di uso di <function>echo</function></title> <programlisting role="php"> <![CDATA[ <?php echo "Hello World"; echo "This spans multiple lines. The newlines will be output as well"; echo "This spans\nmultiple lines. The newlines will be\noutput as well."; echo "Escaping characters is done \"Like this\"."; // Si possono utilizzare variabili all'interno dei parametri di echo $foo = "foobar"; $bar = "barbaz"; echo "foo is $foo"; // foo is foobar // Si possono utilizzare anche delle matrici $bar = array("value" => "foo"); echo "this is {$bar['value']} !"; // this is foo ! // Utilizzando gli apici singoli viene visualizzato il nome della variabile, non il valore echo 'foo is $foo'; // foo is $foo // Se non vi sono altri caratteri, si può visualizzare soltanto il contenuto delle variabili echo $foo; // foobar echo $foo,$bar; // foobarbarbaz // Alcuni programmatori preferiscono passare i parametri come sequenza di stringhe concatenate. echo 'This ', 'string ', 'was ', 'made ', 'with multiple parameters.', chr(10); echo 'This ' . 'string ' . 'was ' . 'made ' . 'with concatenation.' . "\n"; echo <<<END Questo esempio utilizza la sintassi "here document" per visualizzare più linee oltre al contenuto di $variable Notare che il terminatore del testo richiede anche il punto e virgola, senza alcun spazio aggiuntivo! END; // Poichè echo non è una funzione la seguente riga non è valida. ($some_var) ? echo 'true' : echo 'false'; // Tuttavia la seguente funziona ($some_var) ? print('true'): print('false'); // print è una funzione echo $some_var ? 'true': 'false'; // altra versione dell'istruzione ?> ]]> </programlisting> </example> </para> <para> <function>echo</function> ha una sintassi alternativa abbreviata in cui si può fare seguire alle tag di apertura il segno di uguale. Questa sintassi abbreviata funziona solo se il parametro di configurazione <link linkend="ini.short-open-tag">short_open_tag</link> è abilitato. <informalexample> <programlisting role="php"> <![CDATA[ I have <?=$foo?> foo. ]]> </programlisting> </informalexample> </para> <simpara> Per una breve discussione sulle differenze tra <function>print</function> e <function>echo</function>, vedere FAQTs Knowledge Base Article: <ulink url="&url.echo-print;">&url.echo-print; </ulink> </simpara> &note.language-construct; <simpara> Vedere anche <function>print</function>, <function>printf</function> e <function>flush</function>. </simpara> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/strings/functions/explode.xml?r=1.1&p=1 Index: phpdoc-it/reference/strings/functions/explode.xml +++ phpdoc-it/reference/strings/functions/explode.xml <?xml version="1.0" encoding="iso-8859-1"?>   <refentry id="function.explode"> <refnamediv> <refname>explode</refname> <refpurpose>Suddivide una stringa</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>array</type><methodname>explode</methodname> <methodparam><type>string</type><parameter>separator</parameter></methodparam> <methodparam><type>string</type><parameter>string</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>limit</parameter></methodparam> </methodsynopsis> <para> Questa funzione restituisce una matrice di stringhe, ciascuna delle quali è una parte di <parameter>string</parameter> ottenuta dividendo la stringa originale utilizzando <parameter>separator</parameter> come separatore di stringa. Se si imposta <parameter>limit</parameter> la matrice restituita conterrà al massimo <parameter>limit</parameter> elementi di cui l'ultimo conterrà la parte restante di <parameter>string</parameter>. </para> <para> Se il parametro <parameter>separator</parameter> è impostato ad una stringa vuota (""), la funzione <function>explode</function> restituirà &false;. Se <parameter>separator</parameter> contiene caratteri non presenti in <parameter>string</parameter>, allora <function>explode</function> restituirà una matrice contenente <parameter>string</parameter>. </para> <para> Sebbene <function>implode</function> può, per ragioni storiche, accettare i parametri in entrambi gli ordini, <function>explode</function> non può. Occorre accertarsi che il parametro <parameter>separator</parameter> sia antecedente al parametro <parameter>string</parameter>. </para> <note> <para> Il parametro <parameter>limit</parameter> è stato aggiunto dalla versione 4.0.1 </para> </note> <para> <example> <title>Esempi di uso di <function>explode</function></title> <programlisting role="php"> <![CDATA[ <?php // Esempio 1 $pizza = "piece1 piece2 piece3 piece4 piece5 piece6"; $pieces = explode(" ", $pizza); echo $pieces[0]; // piece1 echo $pieces[1]; // piece2 // Esempio 2 $data = "foo:*:1023:1000::/home/foo:/bin/sh"; list($user, $pass, $uid, $gid, $gecos, $home, $shell) = explode(":", $data); echo $user; // foo echo $pass; // * ?> ]]> </programlisting> </example> </para> <para> Vedere anche <function>preg_split</function>, <function>spliti</function>, <function>split</function> e <function>implode</function>. </para> </refsect1> </refentry>