Index: phpdoc/it/functions/mssql.xml diff -u phpdoc/it/functions/mssql.xml:1.9 phpdoc/it/functions/mssql.xml:1.10 --- phpdoc/it/functions/mssql.xml:1.9 Sat Nov 10 16:50:03 2001 +++ phpdoc/it/functions/mssql.xml Wed Nov 28 19:10:01 2001 @@ -1,8 +1,27 @@ - - + + Funzioni per Microsoft SQL Server MS SQL Server + + + L'estensione per MSSQL è disponibile solamente sui sistemi Win32. + Sulle altre piattaforme si può utilizzare il modulo Sybase per + connettersi con database MSSQL. + + + Queste funzioni permettono di accedere a database MS SQL Server. + Per potere funzionare è richiesto che sia installato il MS SQL Client Tools + sullo stesso sistema su cui è il installato il PHP. Il Client Tools può essere installato + o dal cd di MS SQL Server, o copiando il file ntwdblib.dll dalla directory \winnt\system32 del + server alla directory \winnt\system32 della macchina su cui è installato + il PHP. La copia del file ntwdblib.dll permette solo l'accesso al database. + La configurazione del client richiede comunque l'installazione di tutto il pacchetto MS SQL Client Tools. + + + Il modulo MSSQL si abilita aggiungendo extension=php_mssql.dll al file di configurazione php.ini. + + @@ -20,12 +39,11 @@ - Restituisce: vero se l'operazione riesce, falso se si verifica un errore. + Restituisce: &true; se l'operazione riesce, falso se si verifica un errore. La funzione mssql_close chiude la connessione - ad un database MS SQL - Server che è associata all' argomento id_connessione. + ad un database MS SQL Server che è associata all' argomento id_connessione. Se l' id_connessione non viene indicato, si fa riferimento all'ultima connessione aperta. @@ -141,8 +159,7 @@ La funzione mssql_fetch_array è un' estensione - della funzione - mssql_fetch_row. Oltre a memorizzare i dati in un array + della funzione mssql_fetch_row. Oltre a memorizzare i dati in un array con indice numerico, la funzione memorizza i dati in un array associativo in cui la chiave è costituita dal nome del campo. @@ -236,10 +253,9 @@ La funzione mssql_fetch_object è simile a mssql_fetch_array, tranne che per una - differenza, la prima restituisce un oggetto, la seconda un array. - Indirettamente questo significa che si può accedere ai dati solo - attraverso il nome dei campi e non tramite il loro offset ( i numeri non - sono dei validi nomi di proprietà ). + differenza, la prima restituisce un oggetto, la seconda un array. Indirettamente questo significa + che si può accedere ai dati solo attraverso il nome dei campi e non tramite il loro offset (i numeri non + sono dei validi nomi di proprietà). A livello di velocità il comportamento è simile a @@ -347,8 +363,7 @@ Si posiziona sul campo richiesto. Eseguendo successivamente la funzione mssql_fetch_field senza indicare alcun campo, - quest'ultima restituirà il campo richiesto tramite - mssql_fetch_field. + quest'ultima restituirà il campo richiesto tramite mssql_fetch_field. Vedere anche mssql_fetch_field. @@ -388,15 +403,12 @@ - La funzione mssql_free_result permette - di non utilizzare molta memoria durante l'esecuzione di uno script. - Infatti, se si è sicuri di non avere più bisogno dei dati del risultato, - si può eseguire mssql_free_result, e la memoria associata - a id_risultato sarà liberata. Se la funzione - non viene utilizzata, le aree di memoria resteranno disponibili per tutta - la durata dello script. Al termine verranno liberate in modo automatico. - Tuttavia utilizzando la funzione mssql_free_result, - l'area di memoria del risultato associato a id_risultato, sarà liberata. + E' necessario l'utilizzo della funzione mssql_free_result + solo quando si è preoccupati dell'occupazione di memoria durante l'esecuzione + dello script. Normalmente tutti i dati verranno rimossi automaticamente dalla + memoria al termine dell'esecuzione dello script.E' tuttavia possibile eseguire + mssql_free_result, per liberare la memoria occupata dai dati + indicati dal parametro id_risultato @@ -405,7 +417,8 @@ mssql_get_last_message - Restituisce l'ultimo messaggio dal server ( oltre min_message_severity?) + Restituisce l'ultimo messaggio dal server (oltre + min_message_severity?) @@ -457,6 +470,52 @@ + + + mssql_next_result + Muove il puntatore interno al risultato successivo + + + Descrizione + + + bool + mssql_next_result + + int id_risultato + + + + Nel caso in cui si eseguano più di una istruzione SQL al server, oppure si eseguano + delle procedure memorizzate (stored procedure) con possibilità di molteplici risultati, il server restituirà un set di diversi risultati. + Questa funzione verifica se esistono ulteriori risultati dal server. Se effettivamente + esiste un'altro risultato, questa funzione libera la memoria dal risultato corrente + e si predispone per la ricezione del risultato successivo. + La funzione restituisce &true; se è disponibile un'altro risultato, + &false; in caso contrario. + + + <function>mssql_next_result</function> Esempio di utilizzo + + +]]> + + + + + mssql_num_fields @@ -531,7 +590,7 @@ La funzione restituisce: o un identificativo di connessione persistente, - o falso se si verifica un errore. + o &false; se si verifica un errore. La funzione mssql_pconnect agisce come @@ -539,9 +598,8 @@ Prima differenza, quando si cerca di stabilire la connessione, la funzione - per prima cosa cerca di trovare una connessione ( persistente ) già - aperta verso lo stesso server con i medesimi utenti e password. - Se ne viene trovata una, la funzione restituisce l'identificativo di + per prima cosa cerca di trovare una connessione (persistente) già aperta verso lo stesso server, + con i medesimi utenti e password. Se ne viene trovata una, la funzione restituisce l'identificativo di quella connessione, invece di stabilirne una nuova. @@ -566,7 +624,7 @@ int mssql_query - string teso_query + string testo_query int id_connessione @@ -582,8 +640,7 @@ Se l'argomento id_connessione non viene fornito, si utilizza l'ultima connessione aperta in ordine di tempo. Se non vi sono connessioni aperte, la funzione tenta di stabilire una connessione, come se fosse - utilizzata la funzione mssql_connect, e utilizza - quella. + utilizzata la funzione mssql_connect, e utilizza quella. Vedere anche: mssql_db_query, @@ -608,10 +665,6 @@ mixed campo - - La funzione restituisce il contenuto della cella ( identificata dalla riga - e dal campo indicato) dal risultato associato a id_risultato. - La funzione mssql_result restituisce il contenuto di una cella da un risultato di una query a MS SQL. @@ -624,9 +677,10 @@ Quando si lavora con risultati abbastanza grossi, si dovrebbe considerare l'utilizzo di funzioni che restituiscono l'intera riga ( indicate di seguito ), dato che queste restituiscono il contenuto di molte celle in una chiamata sola. - Pertanto sono MOLTO più veloci di mssql_result. - Da notare inoltre, che specificando la posizione per l'argomento campo, la funzione - è molto più veloce rispetto al caso in cui si indica il nome del campo o della tabella. + Pertanto sono MOLTO più veloci di + mssql_result. Da notare inoltre, che specificando + la posizione per l'argomento campo, la funzione è molto più veloce + rispetto al caso in cui si indica il nome del campo o della tabella. Le alternative più veloci raccomandate sono: @@ -661,8 +715,7 @@ Se l'argomento id_connessione non viene fornito, si utilizza l'ultima connessione aperta in ordine di tempo. Se non vi sono connessioni aperte, la funzione tenta di stabilire una connessione, come se fosse - utilizzata la funzione mssql_connect, e utilizza - quella. + utilizzata la funzione mssql_connect, e utilizza quella. Ciascuna esecuzione di mssql_query sarà