cvs: phpdoc-it /reference/classobj/functions get-class.xml /reference/cyrus reference.xml /reference/dir/functions chdir.xml chroot.xml
/reference/domxml/functions DomAttribute-name.xml DomAttribute-specified.xml DomAttribute-value.xml DomDocument-add-root.xml /reference/sqlite
constants.xml ini.xml reference.xml /reference/sqlite/functions sqlite-array-query.xml sqlite-busy-timeout.xml sqlite-changes.xml sqlite-close.xml
sqlite-column.xml sqlite-create-aggregate.xml sqlite-create-function.xml sqlite-current.xml sqlite-error-string.xml sqlite-escape-string.xml
sqlite-fetch-array.xml sqlite-fetch-single.xml sqlite-fetch-string.xml sqlite-field-name.xml sqlite-has-more.xml sqlite-last-error.xml
sqlite-last-insert-rowid.xml sqlite-libencoding.xml sqlite-libversion.xml sqlite-next.xml sqlite-num-fields.xml sqlite-num-rows.xml sqlite-open.xml
sqlite-popen.xml sqlite-query.xml sqlite-rewind.xml sqlite-seek.xml sqlite-udf-decode-binary.xml sqlite-udf-encode-binary.xml
sqlite-unbuffered-query.xml

From:	Andrioli Darvin	Date:	Fri, 28 May 2004 20:20:37 +0000
Subject:	cvs: phpdoc-it /reference/classobj/functions get-class.xml /reference/cyrus reference.xml /reference/dir/functions chdir.xml chroot.xml /reference/domxml/functions DomAttribute-name.xml DomAttribute-specified.xml DomAttribute-value.xml DomDocument-add-root.xml /reference/sqlite constants.xml ini.xml reference.xml /reference/sqlite/functions sqlite-array-query.xml sqlite-busy-timeout.xml sqlite-changes.xml sqlite-close.xml sqlite-column.xml sqlite-create-aggregate.xml sqlite-create-function.xml sqlite-current.xml sqlite-error-string.xml sqlite-escape-string.xml sqlite-fetch-array.xml sqlite-fetch-single.xml sqlite-fetch-string.xml sqlite-field-name.xml sqlite-has-more.xml sqlite-last-error.xml sqlite-last-insert-rowid.xml sqlite-libencoding.xml sqlite-libversion.xml sqlite-next.xml sqlite-num-fields.xml sqlite-num-rows.xml sqlite-open.xml sqlite-popen.xml sqlite-query.xml sqlite-rewind.xml sqlite-seek.xml sqlite-udf-decode-binary.xml sqlite-udf-encode-binary.xml sqlite-unbuffered-query.xml
Groups:	php.doc.it
Request:	Send a blank email to doc-it+get-578@lists.php.net to get a copy of this message

darvina Fri May 28 16:20:37 2004 EDT Added files: /phpdoc-it/reference/sqlite constants.xml ini.xml reference.xml /phpdoc-it/reference/sqlite/functions sqlite-array-query.xml sqlite-busy-timeout.xml sqlite-changes.xml sqlite-close.xml sqlite-column.xml sqlite-create-aggregate.xml sqlite-create-function.xml sqlite-current.xml sqlite-error-string.xml sqlite-escape-string.xml sqlite-fetch-array.xml sqlite-fetch-single.xml sqlite-fetch-string.xml sqlite-field-name.xml sqlite-has-more.xml sqlite-last-error.xml sqlite-last-insert-rowid.xml sqlite-libencoding.xml sqlite-libversion.xml sqlite-next.xml sqlite-num-fields.xml sqlite-num-rows.xml sqlite-open.xml sqlite-popen.xml sqlite-query.xml sqlite-rewind.xml sqlite-seek.xml sqlite-udf-decode-binary.xml sqlite-udf-encode-binary.xml sqlite-unbuffered-query.xml Modified files: /phpdoc-it/reference/classobj/functions get-class.xml /phpdoc-it/reference/cyrus reference.xml /phpdoc-it/reference/dir/functions chdir.xml chroot.xml /phpdoc-it/reference/domxml/functions DomAttribute-name.xml DomAttribute-specified.xml DomAttribute-value.xml DomDocument-add-root.xml Log: Sync to En tree

http://cvs.php.net/diff.php/phpdoc-it/reference/classobj/functions/get-class.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-it/reference/classobj/functions/get-class.xml diff -u phpdoc-it/reference/classobj/functions/get-class.xml:1.4 phpdoc-it/reference/classobj/functions/get-class.xml:1.5 --- phpdoc-it/reference/classobj/functions/get-class.xml:1.4 Sun Apr 4 15:44:35 2004 +++ phpdoc-it/reference/classobj/functions/get-class.xml Fri May 28 16:20:36 2004 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?>   - +  <refentry id="function.get-class"> <refnamediv> @@ -21,9 +21,10 @@ </para> <note> <simpara> - <function>get_class</function> restituisce il nome delle classi - definite dagli utenti in minuscolo. Viceversa le classi definite - nelle estensioni di PHP sono restituite nella notazione originale. + Le classi definite nei moduli di PHP sono restituite nella notazione originale. + In PHP 4, <function>get_class</function> restituisce il nome delle classi + definite dagli utenti in minuscolo, mentre in PHP 5 i nomi delle classi saranno restituiti nella + notazione originale, come i nomi delle classi nei moduli. </simpara> </note> <para> http://cvs.php.net/diff.php/phpdoc-it/reference/cyrus/reference.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc-it/reference/cyrus/reference.xml diff -u phpdoc-it/reference/cyrus/reference.xml:1.1 phpdoc-it/reference/cyrus/reference.xml:1.2 --- phpdoc-it/reference/cyrus/reference.xml:1.1 Fri Feb 6 15:44:05 2004 +++ phpdoc-it/reference/cyrus/reference.xml Fri May 28 16:20:36 2004 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> - + <reference id="ref.cyrus"> <title>Funzioni di amministrazione Cyrus IMAP</title> <titleabbrev>Cyrus IMAP</titleabbrev> http://cvs.php.net/diff.php/phpdoc-it/reference/dir/functions/chdir.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-it/reference/dir/functions/chdir.xml diff -u phpdoc-it/reference/dir/functions/chdir.xml:1.3 phpdoc-it/reference/dir/functions/chdir.xml:1.4 --- phpdoc-it/reference/dir/functions/chdir.xml:1.3 Tue Sep 24 10:33:02 2002 +++ phpdoc-it/reference/dir/functions/chdir.xml Fri May 28 16:20:36 2004 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> - +  <refentry id="function.chdir"> <refnamediv> @@ -14,9 +14,38 @@ </methodsynopsis> <para> Cambia la directory in uso da parte del PHP in - <parameter>directory</parameter>. Restituisce &false; se non in grado di - cambiare directory, &true; altrimenti. + <parameter>directory</parameter>. &return.success; </para> + <para> + <example> + <title>Esempio di uso di <function>chdir</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + +// directory corrente +echo getcwd() . "\n"; + +chdir('public_html'); + +// directory corrente +echo getcwd() . "\n"; + +?> +]]> + </programlisting> + <para> + Questo esempio visualizzerà: + </para> + <screen> +<![CDATA[ +/home/vincent +/home/vincent/public_html +]]> + </screen> + </example> + </para> + &note.sm.uidcheck.dir; <para> Vedere anche <function>getcwd</function>. </para> http://cvs.php.net/diff.php/phpdoc-it/reference/dir/functions/chroot.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-it/reference/dir/functions/chroot.xml diff -u phpdoc-it/reference/dir/functions/chroot.xml:1.3 phpdoc-it/reference/dir/functions/chroot.xml:1.4 --- phpdoc-it/reference/dir/functions/chroot.xml:1.3 Tue Sep 24 10:33:02 2002 +++ phpdoc-it/reference/dir/functions/chroot.xml Fri May 28 16:20:36 2004 @@ -1,10 +1,10 @@ <?xml version="1.0" encoding="iso-8859-1"?> - +  <refentry id="function.chroot"> <refnamediv> <refname>chroot</refname> - <refpurpose>cambia la direcory di root</refpurpose> + <refpurpose>Cambia la direcory di root</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> @@ -14,17 +14,13 @@ </methodsynopsis> <para> Cambia la directory di root del processo in esecuzione in - <parameter>directory</parameter>. Restituisce &false; se non in grado - di cambiare la directory root, altrimenti &true;. + <parameter>directory</parameter>. &return.success; + </para> + <para> + Questa funzione è disponibile soltanto se il sistema la supporta e + se si sta utilizzando il PHP come CLI, CGI o Embed SAPI. </para> - <note> - <para> - Non è intelligente usare questa funzione quando ci si trova nell'ambiente di lavoro - di un webserver, poiché non è possibile resettare la directory root - nuovamente a / alla fine della richiesta. Questa funzione - si comporta correttamente solo quando eseguita come CGI. - </para> - </note> + <note><simpara><function>chroot</function> richiede i privilegi di root.</simpara></note> &note.no-windows; </refsect1> </refentry> http://cvs.php.net/diff.php/phpdoc-it/reference/domxml/functions/DomAttribute-name.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/domxml/functions/DomAttribute-name.xml diff -u phpdoc-it/reference/domxml/functions/DomAttribute-name.xml:1.2 phpdoc-it/reference/domxml/functions/DomAttribute-name.xml:1.3 --- phpdoc-it/reference/domxml/functions/DomAttribute-name.xml:1.2 Sat Feb 8 07:38:00 2003 +++ phpdoc-it/reference/domxml/functions/DomAttribute-name.xml Fri May 28 16:20:36 2004 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> - +  - <refentry id='function.DomAttribute-name'> + <refentry id='function.domattribute-name'> <refnamediv> <refname>DomAttribute->name</refname> <refpurpose> http://cvs.php.net/diff.php/phpdoc-it/reference/domxml/functions/DomAttribute-specified.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc-it/reference/domxml/functions/DomAttribute-specified.xml diff -u phpdoc-it/reference/domxml/functions/DomAttribute-specified.xml:1.1 phpdoc-it/reference/domxml/functions/DomAttribute-specified.xml:1.2 --- phpdoc-it/reference/domxml/functions/DomAttribute-specified.xml:1.1 Mon Sep 9 15:34:36 2002 +++ phpdoc-it/reference/domxml/functions/DomAttribute-specified.xml Fri May 28 16:20:36 2004 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> - +  - <refentry id='function.DomAttribute-specified'> + <refentry id='function.domattribute-specified'> <refnamediv> <refname>DomAttribute->specified</refname> <refpurpose> http://cvs.php.net/diff.php/phpdoc-it/reference/domxml/functions/DomAttribute-value.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/domxml/functions/DomAttribute-value.xml diff -u phpdoc-it/reference/domxml/functions/DomAttribute-value.xml:1.2 phpdoc-it/reference/domxml/functions/DomAttribute-value.xml:1.3 --- phpdoc-it/reference/domxml/functions/DomAttribute-value.xml:1.2 Sat Feb 8 07:38:00 2003 +++ phpdoc-it/reference/domxml/functions/DomAttribute-value.xml Fri May 28 16:20:36 2004 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> - +  - <refentry id='function.DomAttribute-value'> + <refentry id='function.domattribute-value'> <refnamediv> <refname>DomAttribute->value</refname> <refpurpose> http://cvs.php.net/diff.php/phpdoc-it/reference/domxml/functions/DomDocument-add-root.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/domxml/functions/DomDocument-add-root.xml diff -u phpdoc-it/reference/domxml/functions/DomDocument-add-root.xml:1.2 phpdoc-it/reference/domxml/functions/DomDocument-add-root.xml:1.3 --- phpdoc-it/reference/domxml/functions/DomDocument-add-root.xml:1.2 Sun Apr 4 15:44:36 2004 +++ phpdoc-it/reference/domxml/functions/DomDocument-add-root.xml Fri May 28 16:20:36 2004 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> - +  - <refentry id="function.DomDocument-add-root"> + <refentry id="function.domdocument-add-root"> <refnamediv> <refname>DomDocument->add_root</refname> <refpurpose> http://cvs.php.net/co.php/phpdoc-it/reference/sqlite/constants.xml?r=1.1&p=1 Index: phpdoc-it/reference/sqlite/constants.xml +++ phpdoc-it/reference/sqlite/constants.xml <?xml version='1.0' encoding='iso-8859-1'?>  <section id="sqlite.constants"> <title>Costanti predefinite</title> <para> Le funzioni <function>sqlite_fetch_array</function> e <function>sqlite_current</function> utilizzano costanti per indicare i differenti tipi di matrici da restituire. Tali costanti sono: </para> <para> <table> <title>Costanti di SQLiteper scaricare le righe</title> <tgroup cols="2"> <thead> <row> <entry>costante</entry> <entry>significato</entry> </row> </thead> <tbody> <row> <entry>SQLITE_ASSOC</entry> <entry> Le colonne sono restituite in una matrice il cui indice è il nome del campo. </entry> </row> <row> <entry>SQLITE_BOTH</entry> <entry> Le colonne sono restituite in una matrice il cui indice è costituito sia dal nome del campo sia numero della posizione di questo nella riga. </entry> </row> <row> <entry>SQLITE_NUM</entry> <entry> Le colonne sono restituite in una matrice il cui indice è costituito dalla posizione del campo nella riga. La prima colonna parte da 0. </entry> </row> </tbody> </tgroup> </table> </para> </section>  http://cvs.php.net/co.php/phpdoc-it/reference/sqlite/ini.xml?r=1.1&p=1 Index: phpdoc-it/reference/sqlite/ini.xml +++ phpdoc-it/reference/sqlite/ini.xml <?xml version="1.0" encoding="iso-8859-1"?>  <section id="sqlite.configuration"> &reftitle.runtime; &extension.runtime; <para> <table> <title>Parametri di configurazione di SQLite</title> <tgroup cols="3"> <thead> <row> <entry>Nome</entry> <entry>Default</entry> <entry>Modificabile</entry> </row> </thead> <tbody> <row> <entry>sqlite.assoc_case</entry> <entry>0</entry> <entry>PHP_INI_ALL</entry> </row> </tbody> </tgroup> </table> Per maggiori dettagli e definizioni delle costanti PHP_INI_* vedere <function>ini_set</function>. </para> &ini.descriptions.title; <para> <variablelist> <varlistentry id="ini.sqlite.assoc-case"> <term> <parameter>sqlite.assoc_case</parameter> <type>int</type> </term> <listitem> <para> Indica se utilizzare indici misti (<literal>0</literal>), solo maiuscole (<literal>1</literal>) oppure solo minuscoli (<literal>2</literal>). </para> <para> Questa opzione è utile quando si ha necessità di avere compatibilità con altri database, nei quali i nomi delle colonne sono sempre restituiti o maiuscoli o minuscoli, a prescindere dalla definizione del campo nello schema del database. </para> <para> La libreria SQLite restituisce i nomi delle colonne così come sono definiti (ovvero rispettando le maiuscole o le minuscole indicate nello schema). Quando si imposta <parameter>sqlite.assoc_case</parameter> a <literal>0</literal> si rispetta la definizione. Quando si imposta il parametro a <literal>1</literal> oppure a <literal>2</literal>, il PHP converte i nomi rispettivamente in maiuscolo o minuscolo. </para> <para> L'utilizzo di questa opzione comporta una lieve penalità nelle performance, ma è molto più veloce che convertire i nomi dallo script PHP. </para> </listitem> </varlistentry> </variablelist> </para> </section>  http://cvs.php.net/co.php/phpdoc-it/reference/sqlite/reference.xml?r=1.1&p=1 Index: phpdoc-it/reference/sqlite/reference.xml +++ phpdoc-it/reference/sqlite/reference.xml <?xml version="1.0" encoding="iso-8859-1"?>  <reference id="ref.sqlite"> <title>SQLite</title> <titleabbrev>SQLite</titleabbrev> <partintro> <section id="sqlite.intro"> &reftitle.intro; <para> Questo è un modulo per l'uso di SQLite Embeddable SQL Database Engine. SQLite è una libreria C che implementa al proprio interno un motore per database SQL. I programmi che compilano al proprio interno la libreria SQLite possono accedere ad un database senza dovere eseguire un processo RDBMS separato. </para> <para> SQLite non è una libreria client che si deve collegare ad un qualche grosso server database. SQLite è il server. La libreria SQLite legge e scrive direttamente sul file del database. </para> <note> <para> Per maggiori informazioni vedere il sito web di SQLite (<ulink url="&url.sqlite;">&url.sqlite;</ulink>). </para> </note> </section> <section id="sqlite.install"> <title>Installazione</title> <para> Leggere il file INSTALL allegato al pacchetto. Oppure utilizzare l'installatore PEAR con i parametri "pear install sqlite". La libreria SQLite è già inclusa. Non occorre installare altro software. </para> <para> Gli utenti di Windows possono scaricare la versione DLL del module SQLite da qui: (<ulink url="&url.pecl.get.win;php_sqlite.dll">php_sqlite.dll</ulink>). </para> <para> Da PHP 5, il modulo SQLite e il motore stesso saranno inclusi per default. </para> </section> <section id="sqlite.requirements"> &reftitle.required; <para> Per potere utilizzare questa funzioni, occorre compilare il PHP con il supporto per SQLite, oppure caricare dinamicamente il modulo da &php.ini;. </para> </section> <section id="sqlite.resources"> &reftitle.resources; <para> SQLite utilizza due risorse. La prima è la connessione con il database, la seconda è il set di risultati. </para> </section> &reference.sqlite.constants; &reference.sqlite.ini; </partintro> &reference.sqlite.functions; </reference>  http://cvs.php.net/co.php/phpdoc-it/reference/sqlite/functions/sqlite-array-query.xml?r=1.1&p=1 Index: phpdoc-it/reference/sqlite/functions/sqlite-array-query.xml +++ phpdoc-it/reference/sqlite/functions/sqlite-array-query.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-array-query"> <refnamediv> <refname>sqlite_array_query</refname> <refpurpose>Esegue una query in un dato database e restituisce una matrice.</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>array</type><methodname>sqlite_array_query</methodname> <methodparam><type>resource</type><parameter>dbhandle</parameter></methodparam> <methodparam><type>string</type><parameter>query</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>result_type</parameter></methodparam> <methodparam choice="opt"><type>bool</type><parameter>decode_binary</parameter></methodparam> </methodsynopsis> <methodsynopsis> <type>array</type><methodname>sqlite_array_query</methodname> <methodparam><type>string</type><parameter>query</parameter></methodparam> <methodparam><type>resource</type><parameter>dbhandle</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>result_type</parameter></methodparam> <methodparam choice="opt"><type>bool</type><parameter>decode_binary</parameter></methodparam> </methodsynopsis> <para> Chiamare <function>sqlite_array_query</function> equivale ad eseguire <function>sqlite_query</function> e <function>sqlite_fetch_array</function> per ciascuna riga del set di risultati e memorizzare queste righe in una matrice, come illustrato nell'esempio sottostante. La chiamata a <function>sqlite_array_query</function> è significativamente più veloce di uno script del genere. </para> <example> <title><function>sqlite_array_query</function> implementato via script</title> <programlisting role="php"> <![CDATA[ <?php $q = sqlite_query($dbhandle, "SELECT * from foo LIMIT 100"); $rows = array(); while ($r = sqlite_fetch_array($q)) { $rows[] = $r; } ?> ]]> </programlisting> </example> <tip> <para> Le migliori performance con <function>sqlite_array_query</function> si ottengono con query che restituiscono fino a 45 righe. Se si ha più dati si raccomanda di scrivere una propria funzione e di utilizzare <function>sqlite_unbuffered_query</function>. </para> </tip> <para> Vedere anche <function>sqlite_query</function>, <function>sqlite_fetch_array</function> e <function>sqlite_fetch_string</function>. </para> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/sqlite/functions/sqlite-busy-timeout.xml?r=1.1&p=1 Index: phpdoc-it/reference/sqlite/functions/sqlite-busy-timeout.xml +++ phpdoc-it/reference/sqlite/functions/sqlite-busy-timeout.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-busy-timeout"> <refnamediv><refname>sqlite_busy_timeout</refname> <refpurpose>Imposta il timeout di 'in uso', o disabilita l'handle di 'in uso'.</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>void</type><methodname>sqlite_busy_timeout</methodname> <methodparam><type>resource</type><parameter>dbhandle</parameter></methodparam> <methodparam><type>int</type><parameter>milliseconds</parameter></methodparam> </methodsynopsis> <para> Imposta il tempo massimo che sqlite attenderà che un <parameter>dbhandle</parameter> diventi disponibile all'uso. Se il parametro <parameter>milliseconds</parameter> è impostato a <literal>0</literal>, l'handle di 'in uso' viene disattivato e sqlite ritornerà immediatamente con un errore <literal>SQLITE_BUSY</literal> se un'altro processo/thread ha bloccato il database per un aggiornamento. </para> <para> Il PHP imposta per default il timeout di 'in uso' a 60 secondi durante l'apertura del database. </para> <note> <para> Ci sono 1000 (1000) millisecondi in un secondo. </para> </note> <para> Vedere anche <function>sqlite_open</function>. </para> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/sqlite/functions/sqlite-changes.xml?r=1.1&p=1 Index: phpdoc-it/reference/sqlite/functions/sqlite-changes.xml +++ phpdoc-it/reference/sqlite/functions/sqlite-changes.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-changes"> <refnamediv> <refname>sqlite_changes</refname> <refpurpose> Restituisce il numero di righe modificate dall'ultima istruzione SQL. </refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>int</type><methodname>sqlite_changes</methodname> <methodparam><type>resource</type><parameter>dbhandle</parameter></methodparam> </methodsynopsis> <para> Restituisce il numero di righe modificate dall'ultima istruzione SQL eseguita sul database referenziato da <parameter>dbhandle</parameter>. </para> <para> Vedere anche <function>sqlite_num_rows</function>. </para> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/sqlite/functions/sqlite-close.xml?r=1.1&p=1 Index: phpdoc-it/reference/sqlite/functions/sqlite-close.xml +++ phpdoc-it/reference/sqlite/functions/sqlite-close.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-close"> <refnamediv> <refname>sqlite_close</refname> <refpurpose>Chiude un database SQLITE.</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>void</type><methodname>sqlite_close</methodname> <methodparam><type>resource</type><parameter>dbhandle</parameter></methodparam> </methodsynopsis> <para> Chiude il database indicato dall'handle <parameter>database</parameter>. Se il database è persistente, questo sarà chiuso e rimosso dalla lista dei database persistenti. </para> <para> Vedere anche <function>sqlite_open</function> e <function>sqlite_popen</function>. </para> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/sqlite/functions/sqlite-column.xml?r=1.1&p=1 Index: phpdoc-it/reference/sqlite/functions/sqlite-column.xml +++ phpdoc-it/reference/sqlite/functions/sqlite-column.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-column"> <refnamediv> <refname>sqlite_column</refname> <refpurpose>Scarica una riga dal set di risultati corrente.</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>mixed</type><methodname>sqlite_column</methodname> <methodparam><type>resource</type><parameter>result</parameter></methodparam> <methodparam><type>mixed</type><parameter>index_or_name</parameter></methodparam> <methodparam choice="opt"><type>bool</type><parameter>decode_binary</parameter></methodparam> </methodsynopsis> <para> Scarica il valore dalla colonna <parameter>index_or_name</parameter> (se si tratta di una stringa) o della colonna numero <parameter>index_or_name</parameter> (se il parametro è un intero) dalla riga corrente del set di risultati indicato da <parameter>result</parameter>. La decodifica dei dati binari agisce in modo analogo a quanto descritto per <function>sqlite_fetch_array</function>. </para> <para> Utilizzare questa funzione quando si opera su set di risultati con molte colonne o con colonne che contengano grandi quantità di dati. </para> <para> Vedere anche <function>sqlite_fetch_string</function>. </para> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/sqlite/functions/sqlite-create-aggregate.xml?r=1.1&p=1 Index: phpdoc-it/reference/sqlite/functions/sqlite-create-aggregate.xml +++ phpdoc-it/reference/sqlite/functions/sqlite-create-aggregate.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-create-aggregate"> <refnamediv> <refname>sqlite_create_aggregate</refname> <refpurpose>Registra un aggregato UDF da utilizzare nelle istruzioni SQL.</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>bool</type><methodname>sqlite_create_aggregate</methodname> <methodparam><type>resource</type><parameter>dbhandle</parameter></methodparam> <methodparam><type>string</type><parameter>function_name</parameter></methodparam> <methodparam><type>mixed</type><parameter>step_func</parameter></methodparam> <methodparam><type>mixed</type><parameter>finalize_func</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>num_args</parameter></methodparam> </methodsynopsis> <para> <function>sqlite_create_aggregate</function> è simile a <function>sqlite_create_function</function> tranne che le funzioni di registrazione possono essere utilizzate per calcolare un risultato aggregato da tutte le righe della query. </para> <para> La differenza chiave tra questa funzione e <function>sqlite_create_function</function> è che entrambe le funzioni sono necessarie per gestire gli aggregati; la funzione <parameter>step_func</parameter> viene richiamata per ogni riga del set di risultati. La funzione PHP personalizzata dovrebbe accumulare i dati memorizzarli nel contesto di aggregazione. Una volta che tutte le righe sono state processate, si esegue la funzione <parameter>finalize_func</parameter> che dovrebbe prendere i dati dal contesto di aggregazione e restituire il risultato. </para> <para> <example> <title>Esempio di una funzione di aggregazione lunghezza_massima</title> <programlisting role="php"> <![CDATA[ <?php $data = array( 'one', 'two', 'three', 'four', 'five', 'six', 'seven', 'eight', 'nine', 'ten', ); $dbhandle = sqlite_open(':memory:'); sqlite_query($dbhandle, "CREATE TABLE strings(a)"); foreach ($data as $str) { $str = sqlite_escape_string($str); sqlite_query($dbhandle, "INSERT INTO strings VALUES ('$str')"); } function max_len_step(&$context, $string) { if (strlen($string) > $context) { $context = strlen($string); } } function max_len_finalize(&$context) { return $context; } sqlite_create_aggregate($dbhandle, 'max_len', 'max_len_step', 'max_len_finalize'); var_dump(sqlite_array_query($dbhandle, 'SELECT max_len(a) from strings')); ?> ]]> </programlisting> </example> </para> <para> In questo esempio creiamo una funzione di aggregazione che calcola la lunghezza della stringa più lunga presente in una colonna della tabella. Per ciascuna riga, si esegue la funzione <literal>max_len_step</literal> nella quale viene passato il parametro <parameter>context</parameter>. Questo parametro è come una qualsiasi variabile PHP ed è impostata per contenere un array od un oggetto. In questo esempio, verrà utilizzata semplicemente per contenere la lunghezza massima della stringa; se la <parameter>string</parameter> è di lunghezza superiore al valore massimo corrente, noi aggiorneremo il contesto affinchè registri il nuovo massimo. </para> <para> Quando sono state processate tutte le righe, SQLite esegue la funzione <literal>max_len_finalize</literal> per determinare il risultato aggregato. In questa funzione possiamo svolgere qualsiasi tipo di operazione basata sui dati presenti nel parametro <parameter>context</parameter>. Nel nostro esempio abbiamo calcolato il risultato man mano che si processava la righe, pertanto non ci resta che restituire il valore. </para> <note> <para> L'esempio precedente non avrebbe funzionato correttamente se la colonna avesse contenuto dati binari. Guardare sul manuale la pagina <function>sqlite_udf_decode_binary</function> per una spiegazione del perché, e l'esempio di come questo rispetti la codifica binaria. </para> </note> <tip> <para> NON si raccomanda si memorizzare nel contesto una copia dei valori di ciascuna riga, per poi processarli alla fina; questo costringe SQLite a utilizzare una grande quantità di memoria per processare la query - basta pensare a quanta memoria sarebbe necessaria se si memorizzasse un milione di righe, ciscuna contenente una stringa di 32 byte. </para> </tip> <tip> <para> Si può utilizzare <function>sqlite_create_function</function> e <function>sqlite_create_aggregate</function> per non utilizzare la funzioni SQL native di SQLite. </para> </tip> <para> Vedere anche <function>sqlite_create_function</function>, <function>sqlite_udf_encode_binary</function> e <function>sqlite_udf_decode_binary</function>. </para> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/sqlite/functions/sqlite-create-function.xml?r=1.1&p=1 Index: phpdoc-it/reference/sqlite/functions/sqlite-create-function.xml +++ phpdoc-it/reference/sqlite/functions/sqlite-create-function.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-create-function"> <refnamediv> <refname>sqlite_create_function</refname> <refpurpose> Registra una funzione utente "regolare" da utilizzare nelle istruzioni SQL. </refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>bool</type><methodname>sqlite_create_function</methodname> <methodparam><type>resource</type><parameter>dbhandle</parameter></methodparam> <methodparam><type>string</type><parameter>function_name</parameter></methodparam> <methodparam><type>mixed</type><parameter>callback</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>num_args</parameter></methodparam> </methodsynopsis> <para> La funzione <function>sqlite_create_function</function> permette di registrare una funzione PHP in SQLite come <acronym>UDF</acronym> (funzione definita dall'utente, User Defined Function), in modo che possa essere richiamata dalle istruzioni SQL. </para> <para> Il parametro <parameter>dbhandle</parameter> indica l' handle dl database che si desidera estendere, <parameter>function_name</parameter> indica il nome della funzione che si vuole utilizzare nelle istruzioni SQL, <parameter>callback</parameter> è un callbak PHP valido che punti ad una funzione PHP che deve essere richiamata per gestire la funzione SQL. Il parametro opzionale <parameter>num_args</parameter> viene utilizzato come suggerimento dal parser delle espressioni di SQLite. Si raccomanda di indicare un valore nel caso la funzione accetti soltanto un numero fisso di parametri. </para> <para> Le UDF possono essere utilizzate in qualsiasi istruzione SQL che permetta di richiamare funzioni, tipo SELECT e UPDATE e anche i triggers. </para> <para> <example> <title>Esempio di uso di <function>sqlite_create_function</function></title> <programlisting role="php"> <![CDATA[ <?php function md5_and_reverse($string) { return strrev(md5($string)); } if ($dbhandle = sqlite_open('mysqlitedb', 0666, $sqliteerror)) { sqlite_create_function($dbhandle, 'md5rev', 'md5_and_reverse', 1); $sql = 'SELECT md5rev(filename) FROM files'; $rows = sqlite_array_query($dbhandle, $sql); } else { echo 'Error opening sqlite db: ' . $sqliteerror; exit; } ?> ]]> </programlisting> </example> </para> <para> In questo esempio abbiamo una funzione che calcola il valore md5 di una stringa e lo inverte. Quando sono eseguite le istruzioni SQL, queste restituiscono il nome del file trasformato dalla nostra funzione. Il valore restituito in <parameter>$rows</parameter> contiene il risultato processato. </para> <para> L'aspetto interessante di questa tecnica è che non è necessario elaborare i dati di una query utilizzando un ciclo foreach() dopo avere eseguito una query per ottenere i dati </para> <para> Il PHP registra una speciale funzione chiamata <literal>php</literal> quando apre il database la prima volta. La funzione php può essere utilizzata per chiamare qualsiasi funzione PHP senza doverla registrare prima. </para> <para> <example> <title>Esempio dell'uso della funzione php</title> <programlisting role="php"> <![CDATA[ <?php $rows = sqlite_array_query($dbhandle, "SELECT php('md5', filename) from files"); ?> ]]> </programlisting> <para> Questo esempio chiamerà la funzione <function>md5</function> per ciasuna colonna <literal>filename</literal> del database e restituirà il risultato in <parameter>$rows</parameter> </para> </example> </para> <note> <para> Per motivi di performance, il PHP non convertirà in automatico i dati binari passati da/per la UDF. Occorre convertire manualmente i parametri e restituire i valori nel medesimo modo, se si desidera elaborare i dati binari. Guardare le pagine relative a <function>sqlite_udf_encode_binary</function> e <function>sqlite_udf_decode_binary</function> per maggiori dettagli. </para> </note> <tip> <para> Non è raccomandabile l'uso delle UDF per processare dati binari, a meno che non siano richieste all'applicazione elevate performance. </para> </tip> <tip> <para> Si può utilizzare <function>sqlite_create_function</function> e <function>sqlite_create_aggregate</function> per sovrascrivere le funzioni SQL native in SQLite. </para> </tip> <para> Vedere anche <function>sqlite_create_aggregate</function>. </para> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/sqlite/functions/sqlite-current.xml?r=1.1&p=1 Index: phpdoc-it/reference/sqlite/functions/sqlite-current.xml +++ phpdoc-it/reference/sqlite/functions/sqlite-current.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-current"> <refnamediv> <refname>sqlite_current</refname> <refpurpose>Scarica la riga corrente di un set di risultati in una matrice.</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>array</type><methodname>sqlite_current</methodname> <methodparam><type>resource</type><parameter>result</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>result_type</parameter></methodparam> <methodparam choice="opt"><type>bool</type><parameter>decode_binary</parameter></methodparam> </methodsynopsis> <para> <function>sqlite_current</function> è simile a <function>sqlite_fetch_array</function> tranne che non avanza alla riga successiva prima di restituire i dati; la funzione restituisce i dati soltanto dalla posizione corrente. </para> <para> Se la posizione corrente è oltre l'ultima riga, la funzione restituirà &false; </para> <note> <para> Questa funzione non può essere eseguita su risultati non bufferizzati. </para> </note> <para> Vedere anche <function>sqlite_seek</function>, <function>sqlite_next</function> e <function>sqlite_fetch_array</function>. </para> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/sqlite/functions/sqlite-error-string.xml?r=1.1&p=1 Index: phpdoc-it/reference/sqlite/functions/sqlite-error-string.xml +++ phpdoc-it/reference/sqlite/functions/sqlite-error-string.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-error-string"> <refnamediv> <refname>sqlite_error_string</refname> <refpurpose>Restituisce la descrizione testuale di un codice di errore.</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>string</type><methodname>sqlite_error_string</methodname> <methodparam><type>int</type><parameter>error_code</parameter></methodparam> </methodsynopsis> <para> Restituisce una descrizione leggibile del <parameter>error_code</parameter> restituito dalla funzione <function>sqlite_last_error</function>. </para> <para> Vedere anche <function>sqlite_last_error</function>. </para> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/sqlite/functions/sqlite-escape-string.xml?r=1.1&p=1 Index: phpdoc-it/reference/sqlite/functions/sqlite-escape-string.xml +++ phpdoc-it/reference/sqlite/functions/sqlite-escape-string.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-escape-string"> <refnamediv> <refname>sqlite_escape_string</refname> <refpurpose>Inserisce il carattere di escape in stringa da usarsi in una query.</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>string</type><methodname>sqlite_escape_string</methodname> <methodparam><type>string</type><parameter>item</parameter></methodparam> </methodsynopsis> <para> La funzione <function>sqlite_escape_string</function> inserisce i caratteri di escape nella stringa indicata da <parameter>item</parameter>, per poterla utilizzare nelle istruzioni SQL. Questo processo include il raddoppio dell'apice singolo (<literal>'</literal>) e la verifica della presenza di dati binari non sicuri nella stringa. </para> <para> Se il parametro <parameter>item</parameter> contiene un <literal>NUL</literal>, oppure comincia con un carattere il cui numero ordinale è <literal>0x01</literal>, Il PHP applicherà lo schema di codifica binaria in modo da potere memorizzare e recuperare il dato in binario. </para> <para> Sebbene la codifica binaria permetta un sicuro inserimento dei dati, questo rende inutilizzabile i semplici confronti di testo e la clausola <literal>LIKE</literal> sulle colonne che contengono dati binari. In pratica, non dovrebbe essere un problema, se nello schema definito non si prevede l'uso di tali funzioni su colonne binarie (infatti è meglio memorizzati dati binari in altri modi, tipo in file a parte). </para> <warning> <simpara> La funzione <function>addslashes</function> <emphasis>NON</emphasis> dovrebbe essere utilizzata per inserire i caratteri di escape nelle query SQLite; questa porta a strani risultati quando si recuperano i dati. </simpara> </warning> <note> <simpara> Non utilizzare questa funzione per codificare i dati restituì da da funzioni UDF create tramite <function>sqlite_create_function</function> o <function>sqlite_create_aggregate</function> - utilizzare invece <function>sqlite_udf_encode_binary</function>. </simpara> </note> <para> Vedere anche <function>sqlite_udf_encode_binary</function>. </para> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/sqlite/functions/sqlite-fetch-array.xml?r=1.1&p=1 Index: phpdoc-it/reference/sqlite/functions/sqlite-fetch-array.xml +++ phpdoc-it/reference/sqlite/functions/sqlite-fetch-array.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-fetch-array"> <refnamediv> <refname>sqlite_fetch_array</refname> <refpurpose>Scarica com matrice la riga successiva da un set di risultati.</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>array</type><methodname>sqlite_fetch_array</methodname> <methodparam><type>resource</type><parameter>result</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>result_type</parameter></methodparam> <methodparam choice="opt"><type>bool</type><parameter>decode_binary</parameter></methodparam> </methodsynopsis> <para> Scarica la riga successiva dal set di risultati indicato da <parameter>result</parameter>. Se non vi sono righe successive, restituisce &false;, altrimenti restituisce una matrice associativa rappresentante i dati della riga. </para> <para> Il parametro <parameter>result_type</parameter> può essere utilizzato per indicare come si desidera che i dati siano restituiti. Il valore di default è <literal>SQLITE_BOTH</literal>, il quale restituisce le colonne indicizzate per il loro numero ordinale di colonna e per il nome della colonna. <literal>SQLITE_ASSOC</literal> restituisce una matrice indicizzata solo per il nome delle colonne, e <literal>SQLITE_NUM</literal> restituisce una matrice indicizzata solo per il numero ordinale di colonna. </para> <para> I nomi delle colonne restituiti da <literal>SQLITE_ASSOC</literal> e <literal>SQLITE_BOTH</literal> saranno maiuscoli o minuscoli in base al valore del parametro di configurazione <link linkend="ini.sqlite.assoc-case">sqlite.assoc_case</link>. </para> <para> Quando <parameter>decode_binary</parameter> è impostato a &true; (per default), il PHP decodificherà i dati binari se questi furono codificati con la funzione <function>sqlite_escape_string</function>. Normalmente si dovrebbe lasciare inalterato il comportamento di default, a meno che no si debba intervenire su database creati da altre applicazioni SQLite. </para> <para> Vedere anche <function>sqlite_array_query</function> e <function>sqlite_fetch_string</function>. </para> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/sqlite/functions/sqlite-fetch-single.xml?r=1.1&p=1 Index: phpdoc-it/reference/sqlite/functions/sqlite-fetch-single.xml +++ phpdoc-it/reference/sqlite/functions/sqlite-fetch-single.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-fetch-single"> <refnamediv> <refname>sqlite_fetch_single</refname> <refpurpose>Scarica come stringa la prima colonna di un set di risultati.</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>string</type><methodname>sqlite_fetch_single</methodname> <methodparam><type>resource</type><parameter>result</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>result_type</parameter></methodparam> <methodparam choice="opt"><type>bool</type><parameter>decode_binary</parameter></methodparam> </methodsynopsis> <para> <function>sqlite_fetch_single</function> è simile a <function>sqlite_fetch_array</function> tranne che restituisce il valore della prima colonna di una riga. </para> <para> Questo è il mezzo migliore per recuperare i dati quando si è interessati soltanto ai valori di una singola colonna. </para> <para> <example> <title>Esempio di uso di <function>sqlite_fetch_single</function></title> <programlisting role="php"> <![CDATA[ <?php if ($dbhandle = sqlite_open('mysqlitedb', 0666, $sqliteerror)) { $sql = "SELECT id FROM sometable WHERE id = 42"; $res = sqlite_query($dbhandle, $sql); if (sqlite_num_rows($res) > 0) { echo sqlite_fetch_single($res); // 42 } sqlite_close($dbhandle); } ?> ]]> </programlisting> </example> </para> <para> Vedere anche <function>sqlite_fetch_array</function>. </para> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/sqlite/functions/sqlite-fetch-string.xml?r=1.1&p=1 Index: phpdoc-it/reference/sqlite/functions/sqlite-fetch-string.xml +++ phpdoc-it/reference/sqlite/functions/sqlite-fetch-string.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-fetch-string"> <refnamediv> <refname>sqlite_fetch_string</refname> <refpurpose>Alias di <function>sqlite_fetch_single</function></refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <para> Questa funzione è un alias di <function>sqlite_fetch_single</function>. </para> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/sqlite/functions/sqlite-field-name.xml?r=1.1&p=1 Index: phpdoc-it/reference/sqlite/functions/sqlite-field-name.xml +++ phpdoc-it/reference/sqlite/functions/sqlite-field-name.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-field-name"> <refnamediv> <refname>sqlite_field_name</refname> <refpurpose>Restituisce il nome di un particolare campo.</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>string</type><methodname>sqlite_field_name</methodname> <methodparam><type>resource</type><parameter>result</parameter></methodparam> <methodparam><type>int</type><parameter>field_index</parameter></methodparam> </methodsynopsis> <para> Dato il numero ordinale di colonna, <literal>field_index</literal>, restituisce il nome del campo dal set di risultati indicato in <parameter>result</parameter>. </para> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/sqlite/functions/sqlite-has-more.xml?r=1.1&p=1 Index: phpdoc-it/reference/sqlite/functions/sqlite-has-more.xml +++ phpdoc-it/reference/sqlite/functions/sqlite-has-more.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-has-more"> <refnamediv> <refname>sqlite_has_more</refname> <refpurpose>restituisce se sono disponibili o meno ulteriori righe.</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>bool</type><methodname>sqlite_has_more</methodname> <methodparam><type>resource</type><parameter>result</parameter></methodparam> </methodsynopsis> <para> <function>sqlite_has_more</function> restituisce &true; se sono disponibili ulteriori righe dal set di risultati <parameter>result</parameter>, oppure &false; in caso contrario. </para> <para> Vedere anche <function>sqlite_num_rows</function> e <function>sqlite_changes</function>. </para> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/sqlite/functions/sqlite-last-error.xml?r=1.1&p=1 Index: phpdoc-it/reference/sqlite/functions/sqlite-last-error.xml +++ phpdoc-it/reference/sqlite/functions/sqlite-last-error.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-last-error"> <refnamediv> <refname>sqlite_last_error</refname> <refpurpose>Restituisce il codice di errore dell'ultimo errore accorso sul database.</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>int</type><methodname>sqlite_last_error</methodname> <methodparam><type>resource</type><parameter>dbhandle</parameter></methodparam> </methodsynopsis> <para> Restituisce il codice di errore dall'ultima operazione eseguita sul database <parameter>dbhandle</parameter>. Una descrizione interpretabile dell'errore può essere ricavata tramite la funzione <function>sqlite_error_string</function>. </para> <para> Vedere anche <function>sqlite_error_string</function>. </para> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/sqlite/functions/sqlite-last-insert-rowid.xml?r=1.1&p=1 Index: phpdoc-it/reference/sqlite/functions/sqlite-last-insert-rowid.xml +++ phpdoc-it/reference/sqlite/functions/sqlite-last-insert-rowid.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-last-insert-rowid"> <refnamediv> <refname>sqlite_last_insert_rowid</refname> <refpurpose>Restituisce l'identificativo di riga dell'ultima riga inserita.</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>int</type><methodname>sqlite_last_insert_rowid</methodname> <methodparam><type>resource</type><parameter>dbhandle</parameter></methodparam> </methodsynopsis> <para> Restituisce l'identificativo di riga dell'ultima riga inserita nel database <parameter>dbhandle</parameter>, se questo è stato creato con un campo auto-increment. </para> <tip> <para> In SQLite si può creare un campo auto-increment dichiarando questo come <literal>INTEGER PRIMARY KEY</literal> nello schema della tabella. </para> </tip> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/sqlite/functions/sqlite-libencoding.xml?r=1.1&p=1 Index: phpdoc-it/reference/sqlite/functions/sqlite-libencoding.xml +++ phpdoc-it/reference/sqlite/functions/sqlite-libencoding.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-libencoding"> <refnamediv> <refname>sqlite_libencoding</refname> <refpurpose>Restituisce la codifica della libreria SQLite.</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>string</type><methodname>sqlite_libencoding</methodname> <void/> </methodsynopsis> <para> La libreria SQLite può essere compilata in modalità ISO-8859-1 o UTF-8 compatibile. Questa funzione permette di determinare quale schema di codifica è stato usato per questa versione della libreria. </para> <warning> <para> Per default il PHP distribuisce libsqlite nella codifica ISO-8859-1. Tuttavia questo non è proprio vero; piuttosto che gestire il formato ISO-8859-1 la libreria opera in modo coerente con le impostazioni locali per quanto riguarda i confronti e gli ordinamenti. Pertanto, più che ISO-8859-1, si dovrebbe pensare come se fosse a 8 bit. </para> </warning> <para> Quando è compilato con il supporto alla codifica UTF-8, SQLite gestisce le codifiche e le decodifiche dei caratteri multi-byte UTF-8, ma non svolge ancora un lavoro completo quando opera sui dati (ad esempio non viene svolta la normalizzazione), e alcune operazioni di confronto possono non essere ancora precise. </para> <warning> <para> Si raccomanda di non utilizzare il PHP nella configurazione di web-server con le librerie compilate per il supporto di UTF-8, poiché libsqlite abortirà il processo se rileva dei problemi con la codifica UTF-8. </para> </warning> <para> Vedere anche <function>sqlite_libversion</function>. </para> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/sqlite/functions/sqlite-libversion.xml?r=1.1&p=1 Index: phpdoc-it/reference/sqlite/functions/sqlite-libversion.xml +++ phpdoc-it/reference/sqlite/functions/sqlite-libversion.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-libversion"> <refnamediv> <refname>sqlite_libversion</refname> <refpurpose>Restituisce la versione della libreria SQLite.</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>string</type><methodname>sqlite_libversion</methodname> <void/> </methodsynopsis> <para> Restituisce, come stringa, la versione della libreria SQLite. </para> <para> Vedere anche <function>sqlite_libencoding</function>. </para> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/sqlite/functions/sqlite-next.xml?r=1.1&p=1 Index: phpdoc-it/reference/sqlite/functions/sqlite-next.xml +++ phpdoc-it/reference/sqlite/functions/sqlite-next.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-next"> <refnamediv> <refname>sqlite_next</refname> <refpurpose>Si sposta al successivo numero di riga.</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>bool</type><methodname>sqlite_next</methodname> <methodparam><type>resource</type><parameter>result</parameter></methodparam> </methodsynopsis> <para> La funzione <function>sqlite_next</function> avanza il set di risultati indicato da <parameter>result</parameter> alla riga successiva. Restituisce &false; se non vi sono ulteriori righe, &true; in caso contrario. </para> <note> <para> Questa funzione non può essere utilizzata per gestire risultati non bufferizzati. </para> </note> <para> Vedere anche <function>sqlite_seek</function>, <function>sqlite_current</function> e <function>sqlite_rewind</function>. </para> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/sqlite/functions/sqlite-num-fields.xml?r=1.1&p=1 Index: phpdoc-it/reference/sqlite/functions/sqlite-num-fields.xml +++ phpdoc-it/reference/sqlite/functions/sqlite-num-fields.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-num-fields"> <refnamediv> <refname>sqlite_num_fields</refname> <refpurpose>Resituitsce il numero di campi da un set di risultati.</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>int</type><methodname>sqlite_num_fields</methodname> <methodparam><type>resource</type><parameter>result</parameter></methodparam> </methodsynopsis> <para> Restituisce il numero di campi presenti nel set di risultati <parameter>result</parameter>. </para> <para> Vedere anche <function>sqlite_column</function> e <function>sqlite_num_rows</function>. </para> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/sqlite/functions/sqlite-num-rows.xml?r=1.1&p=1 Index: phpdoc-it/reference/sqlite/functions/sqlite-num-rows.xml +++ phpdoc-it/reference/sqlite/functions/sqlite-num-rows.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-num-rows"> <refnamediv> <refname>sqlite_num_rows</refname> <refpurpose>Restituisce il numero di righe da un set di risultati bufferizzato.</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>int</type><methodname>sqlite_num_rows</methodname> <methodparam><type>resource</type><parameter>result</parameter></methodparam> </methodsynopsis> <para> Restituisce il numero di righe dal set di risultati <parameter>result</parameter> bufferizzato. </para> <note> <para> Questa funzione non può essere utilizzata con set di risultati non bufferizzati </para> </note> <para> Vedere anche <function>sqlite_changes</function> e <function>sqlite_query</function>. </para> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/sqlite/functions/sqlite-open.xml?r=1.1&p=1 Index: phpdoc-it/reference/sqlite/functions/sqlite-open.xml +++ phpdoc-it/reference/sqlite/functions/sqlite-open.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-open"> <refnamediv> <refname>sqlite_open</refname> <refpurpose>Apre un database SQLite. Crea il database se non esiste.</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>resource</type><methodname>sqlite_open</methodname> <methodparam><type>string</type><parameter>filename</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>&error_message</parameter></methodparam> </methodsynopsis> <para> Restituisce una risorsa (database handle) se ha successo, oppure &false; se si verifica un errore. </para> <para> Il parametro <parameter>filename</parameter> indica il nome del database. Può essere un percorso relativo o assoluto al file che SQLite utilizzerà per memorizzare i dati. Se il file non esiste, SQLite tenterà di crearlo. <emphasis>BISOGNA</emphasis> avere i permessi di scrittura sul file se si desidera inserire dei dati o modficare lo schema del database. </para> <para> Il parametro <parameter>mode</parameter> specifica la modalità del file ed è inteso per essere utilizzato per l'apertura del file in modalità read-only. Attualmente questo parametro viene ignorato da SQLite. Per default la modalità di apertura è <literal>0666</literal> e questo è il valore raccomandato se si necessita di accedere al parametro <parameter>errmessage</parameter>. </para> <para> Il parametro <parameter>errmessage</parameter> è passato per riferimento ed è impostato per contenere un messaggio descrittivo di errore nel caso non si riesca ad aprire il database a causa di un errore. </para> <para> <example> <title>Esempio di uso di <function>sqlite_open</function></title> <programlisting role="php"> <![CDATA[ <?php if ($db = sqlite_open('mysqlitedb', 0666, $sqliteerror)) { sqlite_query($db, 'CREATE TABLE foo (bar varchar(10))'); sqlite_query($db, "INSERT INTO foo VALUES ('fnord')"); $result = sqlite_query($db, 'select bar from foo'); var_dump(sqlite_fetch_array($result)); } else { die($sqliteerror); } ?>]]> </programlisting> </example> </para> <tip> <simpara> Sui sistemi Unix, SQLite è sensibile agli script che utilizzano la chiamata di sistema fork(). Se si sta utilizzando un tale script, si raccomanda di chiudere la connessione prima dell'esecuzione del fork, e quindi ri-aprirlo nel processo figlio/padre. Per maggiori informazioni su questo particolare vedere <ulink url="&url.sqlite.interface.c;">L'interfaccia C alla libreria SQLite</ulink> nella sezione intitolata <literal>Multi-Threading e SQLite</literal>. </simpara> </tip> <tip> <simpara> Si raccomanda di non utilizzare database SQLite su partizioni montate via NFS. Poiché è noto che NFS non è affidabile con i lock, può capitare che si riesca neppure ad aprire il database, o, se ci si riesce, il comportamento dei lock può essere indefinito. </simpara> </tip> <note> <simpara> A partire dalla versione 2.8.2 della libreria SQLite, si può specificare <literal>:memory:</literal> come valore per il parametro <parameter>filename</parameter> in modo da creare database che risiedano soltanto in memoria. Principalmente questo è utile per le elaborazioni temporanee, poiché il database in memoria sarà distrutto non appena il processo termina. Può anche essere utilizzato in coppia con l'istruzione SQL <literal>ATTACH DATABASE</literal> per caricare altri database in modo da potere muovere i dati tra di loro. </simpara> </note> <note> <simpara> SQLite sensibile al &safemode; e a open_basedir. </simpara> </note> <para> Vedere anche <function>sqlite_popen</function>, <function>sqlite_close</function> e <function>sqlite_query</function>. </para> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/sqlite/functions/sqlite-popen.xml?r=1.1&p=1 Index: phpdoc-it/reference/sqlite/functions/sqlite-popen.xml +++ phpdoc-it/reference/sqlite/functions/sqlite-popen.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-popen"> <refnamediv> <refname>sqlite_popen</refname> <refpurpose> Apre una connessione persistente ad un database SQLite. Crea il database se non esiste. </refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>resource</type><methodname>sqlite_popen</methodname> <methodparam><type>string</type><parameter>filename</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>&error_message</parameter></methodparam> </methodsynopsis> <simpara> Questa funzione agisce in modo identico a <function>sqlite_open</function> tranne che utilizza il meccanismo delle risorse persistenti insito in PHP. Per maggiori informazioni sui parametri leggere la pagina del manuale relativa a <function>sqlite_open</function>. </simpara> <para> <function>sqlite_popen</function> per prima cosa verifica se esiste già un connessione persistente per il dato <parameter>filename</parameter>. Se ne trova una restituisce quella altrimenti ne apre una nuova. </para> <para> Il beneficio di questo approccio è che si evita il costo, in termini di performance, di dovere ri-leggere lo schema del database e degli indici ad ogni pagina servita dal server web (qualsiasi SAPI tranne CGI o CLI). </para> <note> <simpara> Se si utilizza la connessione persistente, ed il sottostante database viene aggiornato da un processo che gira in background (ad esempio via crontab), e questo processo ricrea il database riscrivendolo (ad esempio cancellandolo e scrivendone uno nuovo, oppure movendo la nuova versione sulla vecchia), si possono manifestare comportamenti indefiniti quando si torna ad utilizzare la connessione persistente verso il vecchio database. </simpara> <simpara> Per evitare questa situazione, occorre che il processo in background apra lo stesso database ed esegua gli aggiornamenti mediante transazioni. </simpara> </note> <para> Vedere anche <function>sqlite_open</function>, <function>sqlite_close</function> e <function>sqlite_query</function>. </para> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/sqlite/functions/sqlite-query.xml?r=1.1&p=1 Index: phpdoc-it/reference/sqlite/functions/sqlite-query.xml +++ phpdoc-it/reference/sqlite/functions/sqlite-query.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-query"> <refnamediv> <refname>sqlite_query</refname> <refpurpose> Esegue una query su un database e restituisce un puntatore al set di risultati. </refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>resource</type><methodname>sqlite_query</methodname> <methodparam><type>resource</type><parameter>dbhandle</parameter></methodparam> <methodparam><type>string</type><parameter>query</parameter></methodparam> </methodsynopsis> <methodsynopsis> <type>resource</type><methodname>sqlite_query</methodname> <methodparam><type>string</type><parameter>query</parameter></methodparam> <methodparam><type>resource</type><parameter>dbhandle</parameter></methodparam> </methodsynopsis> <para> Esegue le istruzioni SQL indicate in <parameter>query</parameter> sul collegamento al database indicato dal parametro <parameter>dbhandle</parameter>. </para> <para> Nei casi di query che restituiscano delle righe, questa funzione restituisce un handle che può essere utilizzato nelle funzioni <function>sqlite_fetch_array</function> e <function>sqlite_seek</function>. </para> <para> Negli altri tipi di query, questa funzione restituirà un risultato booleano; &true; se la query ha successo, &false; se non riesce. </para> <para> A prescindere dal tipo di query, questa funzione restituisce &false; se la query fallisce. </para> <para> <function>sqlite_query</function> restituisce un puntatore ad un set di risultati bufferizzato e navigabile. Ciò è ragionevole per piccole query dove si ha la necessità di accedere alle righe in ordine casuale. I risultati bufferizzati allocano la memoria necessaria per contenere tutte le righe restituite dalla query, che non saranno restituite fino a che non saranno richieste. Se si ha soltanto la necessità di accedere alle righe in modo sequenziale, si raccomanda l'uso della funzione <function>sqlite_unbuffered_query</function>. </para> <note> <simpara> Sono supportate due sintassi alternative, questo per compatibilità con altri moduli per database (esempio MySql). La forma preferita è la prima, in cui il parametro <parameter>db</parameter> è il primo della funzione. </simpara> </note> <warning> <simpara> SQLite <emphasis>esegue</emphasis> molteplici query separate da punto e virgola, pertanto si possono eseguire dei batch SQL che possono essere caricati da file esterni o inseriti nello script. </simpara> <simpara> Quando si eseguono query molteplici, il valore restituito può essere &false; se vi è un errore, oppure indefinito in caso contrario ( può essere &true; oppure può restituire un handle ad un set di risultati). </simpara> </warning> <para> Vedere anche <function>sqlite_unbuffered_query</function> e <function>sqlite_array_query</function>. </para> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/sqlite/functions/sqlite-rewind.xml?r=1.1&p=1 Index: phpdoc-it/reference/sqlite/functions/sqlite-rewind.xml +++ phpdoc-it/reference/sqlite/functions/sqlite-rewind.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-rewind"> <refnamediv> <refname>sqlite_rewind</refname> <refpurpose>Posiziona sulla prima riga.</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>bool</type><methodname>sqlite_rewind</methodname> <methodparam><type>resource</type><parameter>result</parameter></methodparam> </methodsynopsis> <para> <function>sqlite_rewind</function> si posiziona sulla prima riga del set di risultati. La funzione restituisce &false; se non vi sono righe nel set di risultati, &true; in caso contrario. </para> <note> <para> Questa funzione non può essere utilizzata con set di risultati non bufferizzati. </para> </note> <para> Vedere anche <function>sqlite_next</function>, <function>sqlite_current</function> e <function>sqlite_seek</function>. </para> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/sqlite/functions/sqlite-seek.xml?r=1.1&p=1 Index: phpdoc-it/reference/sqlite/functions/sqlite-seek.xml +++ phpdoc-it/reference/sqlite/functions/sqlite-seek.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-seek"> <refnamediv> <refname>sqlite_seek</refname> <refpurpose>Posizionamento su una data riga di un set di risultati bufferizzato.</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>bool</type><methodname>sqlite_seek</methodname> <methodparam><type>resource</type><parameter>result</parameter></methodparam> <methodparam><type>int</type><parameter>rownum</parameter></methodparam> </methodsynopsis> <para> <function>sqlite_seek</function> si posiziona sulla riga indicata dal parametro <parameter>rownum</parameter>. Il numero della riga parte da zero (0 indica la prima riga). La funzione restituisce &false; se la riga richiesta non esiste, oppure &true;. </para> <note> <para> Questa funzione non può essere utilizzata con set di risultati non bufferizzato. </para> </note> <para> Vedere anche <function>sqlite_next</function>, <function>sqlite_current</function> e <function>sqlite_rewind</function>. </para> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/sqlite/functions/sqlite-udf-decode-binary.xml?r=1.1&p=1 Index: phpdoc-it/reference/sqlite/functions/sqlite-udf-decode-binary.xml +++ phpdoc-it/reference/sqlite/functions/sqlite-udf-decode-binary.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-udf-decode-binary"> <refnamediv> <refname>sqlite_udf_decode_binary</refname> <refpurpose>Decodifica dati binari passati come parametri in UDF.</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>string</type><methodname>sqlite_udf_decode_binary</methodname> <methodparam><type>string</type><parameter>data</parameter></methodparam> </methodsynopsis> <para> La funzione <function>sqlite_udf_decode_binary</function> decodifica i dati binari in modo che possano essere utilizzati come parametri per <function>sqlite_udf_encode_binary</function> o <function>sqlite_escape_string</function>. </para> <para> Occorre eseguire questa funzione sui parametri passati agli UDF se questi devono gestire dati binari, poiché la codifica dei dati binari utilizzata dal PHP nasconde il contenuto. </para> <para> Il PHP non esegue questa codifica/decodifica in automatico, avrebbe impatti negativi sulle performance. </para> <para> <example> <title>Esempio di una funzione di aggregazione lunghezza_massima binary-safe</title> <programlisting role="php"> <![CDATA[ <?php $data = array( 'one', 'two', 'three', 'four', 'five', 'six', 'seven', 'eight', 'nine', 'ten', ); $db = sqlite_open(':memory:'); sqlite_query($db, "CREATE TABLE strings(a)"); foreach ($data as $str) { $str = sqlite_escape_string($str); sqlite_query($db, "INSERT INTO strings VALUES ('$str')"); } function max_len_step(&$context, $string) { $string = sqlite_udf_decode_binary($string); if (strlen($string) > $context) { $context = strlen($string); } } function max_len_finalize(&$context) { return $context; } sqlite_create_aggregate($db, 'max_len', 'max_len_step', 'max_len_finalize'); var_dump(sqlite_array_query($db, 'SELECT max_len(a) from strings')); ?> ]]> </programlisting> </example> </para> <para> Vedere anche <function>sqlite_udf_encode_binary</function>, <function>sqlite_create_function</function> e <function>sqlite_create_aggregate</function>. </para> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/sqlite/functions/sqlite-udf-encode-binary.xml?r=1.1&p=1 Index: phpdoc-it/reference/sqlite/functions/sqlite-udf-encode-binary.xml +++ phpdoc-it/reference/sqlite/functions/sqlite-udf-encode-binary.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-udf-encode-binary"> <refnamediv> <refname>sqlite_udf_encode_binary</refname> <refpurpose>Codifica i dati binari prima di restituirli da un UDF.</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>string</type><methodname>sqlite_udf_encode_binary</methodname> <methodparam><type>string</type><parameter>data</parameter></methodparam> </methodsynopsis> <para> <function>sqlite_udf_encode_binary</function> applica la decofica dei dati binari al parametro <parameter>data</parameter> in modo che possa essere restituito dalle query (dato che la sottostante libreria libsqlite API non è binary safe). </para> <para> Se esiste una possibilità che i dati possano essere binai (ad esempio contengono caratteri tipo NUL, oppure iniziano con il carattere <literal>0x01</literal>), occorre eseguire questa funzione per codificare il valore da restituire all'UDF. </para> <para> Il PHP non esegue questa codifica/decodifica in automatico, avrebbe impatti negativi sulle performance. </para> <note> <para> Non utilizzare <function>sqlite_escape_string</function> per quitare stringhe restituite tramite UDF poiché porta ad avere una quotazione doppia. Utilizzare <function>sqlite_udf_encode_binary</function>! </para> </note> <para> Vedere anche <function>sqlite_udf_decode_binary</function>, <function>sqlite_escape_string</function>, <function>sqlite_create_function</function> e <function>sqlite_create_aggregate</function>. </para> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/sqlite/functions/sqlite-unbuffered-query.xml?r=1.1&p=1 Index: phpdoc-it/reference/sqlite/functions/sqlite-unbuffered-query.xml +++ phpdoc-it/reference/sqlite/functions/sqlite-unbuffered-query.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-unbuffered-query"> <refnamediv> <refname>sqlite_unbuffered_query</refname> <refpurpose>Esegue una query senza scaricare e bufferizzare i dati</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>resource</type><methodname>sqlite_unbuffered_query</methodname> <methodparam><type>resource</type><parameter>dbhandle</parameter></methodparam> <methodparam><type>string</type><parameter>query</parameter></methodparam> </methodsynopsis> <methodsynopsis> <type>resource</type><methodname>sqlite_unbuffered_query</methodname> <methodparam><type>string</type><parameter>query</parameter></methodparam> <methodparam><type>resource</type><parameter>dbhandle</parameter></methodparam> </methodsynopsis> <para> <function>sqlite_unbuffered_query</function> è simile a <function>sqlite_query</function> tranne che i risultati sono restituiti in modo sequenziale una riga dopo l'altra, senza possibilità di tornare indietro. </para> <para> Questa funzione è l'ideale per generare oggetti tipo tavole HTML in cui occorre processare una riga alla volta e non occorre muoversi a caso tra le righe. </para> <note> <para> Funzioni tipo <function>sqlite_seek</function>, <function>sqlite_rewind</function>, <function>sqlite_next</function>, <function>sqlite_current</function> e <function>sqlite_num_rows</function> sono applicabili agli handles restituiti da <function>sqlite_unbuffered_query</function>. </para> </note> <para> Vedere anche <function>sqlite_query</function>. </para> </refsect1> </refentry>