Introduzione

Queste funzioni permettono di accedere ai database Oracle8 e Oracle7. Usano la Call-Interface di Oracle8 (OCI8).

Questa estensione è più flessibile della estensione standard di Oracle. Supporta il binding di variabili PHP locali e globali ai segnaposto Oracle, ha pieno supporto di LOB, FILE e ROWID e permette di utilizzare variabili di definizione personalizzabili.

Requisiti

Occorre avere installate le librerie client di Oracle8 per utilizzare questa estensione.

Prima di usare questa estensione, occorre sincerarsi di aver impostato le variabili d'ambiente per l'utente Oracle, come pure per l'utente del server web. Le variabili che potrebbero necessitare l'impostazione sono le seguenti:

• ORACLE_HOME

• ORACLE_SID

• LD_PRELOAD

• LD_LIBRARY_PATH

• NLS_LANG

• ORA_NLS33

Dopo aver impostato le variabili d'ambiente per l'utente del server web, occorre sicerarsi di aver aggiunto anche l'utente stesso (nobody, www) al gruppo oracle.

Installazione

Si deve compilare PHP con l'opzione --with-oci8[=DIR], dove DIR è di default il contenuto della variabile di ambiente ORACLE_HOME.

Configurazione Runtime

Questa estensione non definisce alcuna direttiva di configurazione in php.ini

Tipi di risorse

Costanti Predefinite

Queste costanti sono definite da questa estensione e sono disponibili solo se l'estensione è stata compilata nel PHP o se è stata caricata dinamicamente a runtime.

Esempi

Esempio 1. Trucchi OCI <?php // by sergo@bacup.ru // Usare l'opzione OCI_DEFAULT nel comando execute per ritardare l'esicuzione OCIExecute($stmt, OCI_DEFAULT); // per ricevere i dati utilizzare (dopo il fetch): $result = OCIResult($stmt, $n); if (is_object ($result)) $result = $result->load(); // come comandi INSERT o UPDATE usare: $sql = "insert into table (field1, field2) values (field1 = 'value', field2 = empty_clob()) returning field2 into :field2"; OCIParse($conn, $sql); $clob = OCINewDescriptor($conn, OCI_D_LOB); OCIBindByName ($stmt, ":field2", &$clob, -1, OCI_B_CLOB); OCIExecute($stmt, OCI_DEFAULT); $clob->save ("some text"); OCICommit($conn); ?>

You can easily access stored procedures in the same way as you would from the commands line.

Esempio 2. Using Stored Procedures <?php // by webmaster@remoterealty.com $sth = OCIParse ( $dbh, "begin sp_newaddress( :address_id, '$firstname', '$lastname', '$company', '$address1', '$address2', '$city', '$state', '$postalcode', '$country', :error_code );end;" ); // Questo codice richiama la stord procedure sp_newaddress, dove :address_id è // una variabile in/out e :error_code è una variabile out. // Quindi si effettua il binding: OCIBindByName ( $sth, ":address_id", $addr_id, 10 ); OCIBindByName ( $sth, ":error_code", $errorcode, 10 ); OCIExecute ( $sth ); ?>