Creare un'applicazione PHP

Per creare un'applicazione PHP che acceda a un Autonomous Database, è innanzitutto necessario configurare il sistema di sviluppo per supportare l'accesso al database che può sfruttare la disponibilità continua e le funzioni ad alte prestazioni di Autonomous Database.

Dopo aver configurato il sistema di sviluppo, è possibile codificare le connessioni al database e le istruzioni SQL nell'applicazione per sfruttare le funzioni di disponibilità continua e ad alte prestazioni.

Argomenti correlati

Le basi per costruire un'applicazione

Configura sistema di sviluppo PHP

Per configurare il tuo sistema di sviluppo in modo che l'applicazione PHP possa sfruttare la disponibilità continua e le funzioni ad alte prestazioni di un Autonomous Database, esegui questi passaggi.

Scarica e installa PHP.
Scaricare e installare Oracle Instant Client.
Scaricare e installare PHP OCI8.
Scaricare le credenziali client per il database e renderle disponibili per Oracle Instant Client.

Operazioni preliminari

Il sistema di sviluppo deve soddisfare determinati criteri per configurarlo correttamente.

Deve avere accesso a Internet.
Deve disporre dell'accesso di rete all'Autonomous Database.

Vedere Configurazione di un sistema di sviluppo per l'accesso al database per informazioni su come garantire che il sistema di sviluppo soddisfi questo requisito.

Scarica e installa PHP

Scarica e installa PHP per il sistema operativo e l'architettura del tuo sistema:

Oracle Linux:

Esegui questi comandi per scaricare e installare PHP e per scaricare e installare PEAR per ottenere il comando di gestione dei pacchetti pecl di PHP:

sudo dnf install -y oracle-release-el8 oracle-php-release-el8
sudo dnf install -y php php-devel php-xml dtrace-utils
wget http://pear.php.net/go-pear.phar
sudo php go-pear.phar

Altre architetture e OSes:

Andare alla pagina Installazione e configurazione PHP e seguire le istruzioni per il sistema operativo e l'architettura del sistema.

Scaricare e installare Oracle Instant Client

Scaricare e installare il pacchetto di base di Oracle Instant Client per il sistema operativo e l'architettura del sistema:

Oracle Linux:

Eseguire i comandi seguenti per scaricare e installare il pacchetto di base di Oracle Instant Client:
```
sudo dnf -y install oracle-release-el8
sudo dnf -y install oracle-instantclient21.13-basic oracle-instantclient21.13-devel
```
(Se si desidera visualizzare un elenco di tutti i pacchetti Instant Client, andare a http://yum.oracle.com/repo/OracleLinux/OL7/oracle/instantclient/x86_64/index.html.)
Altre architetture e OSes:
1. Andare alla pagina Download di Oracle Instant Client e selezionare il download per il sistema operativo e l'architettura del sistema.
2. Nella pagina di download, accettare il contratto di licenza di Oracle Technology Network, scaricare le versioni più recenti del pacchetto di base e del pacchetto SDK, quindi installarle seguendo le istruzioni nella parte inferiore della pagina di download.

Scaricare e installare PHP OCI8

Scaricare e installare l'estensione OCI8 per PHP per il sistema operativo e l'architettura del sistema:

Oracle Linux:

Eseguire i comandi riportati di seguito per scaricare e installare la versione più recente dell'estensione OCI8.
```
sudo PHP_DTRACE=yes pecl install oci8
sudo sh -c "echo extension=oci8.so > /etc/php.d/20-oci8.ini"
sudo sh -c "echo oci8.events = On > /etc/php.d/20-oci8.ini"
```
Se le applicazioni richiedono variabili di ambiente Oracle, aggiungerle al file di configurazione /etc/sysconfig/httpd, ad esempio:
```
NLS_LANG=AMERICAN_AMERICA.AL32UTF8
NLS_DATE_FORMAT='YYYY-MM-DD HH24:MI:SS'
ORA_SDTZ=UTC
```
Se si aggiungono tali variabili, riavviare il server Apache HTTP per leggere le nuove variabili:
```
sudo systemctl restart httpd
```
Altre architetture e OSes:
1. Esegui questo comando
```
pecl install oci8
```
2. Aggiungere le righe seguenti al file php.ini dell'installazione PHP:
```
extension=oci8.so
oci8.events = On
```

Scaricare e installare le credenziali client per il database

Scaricare il file zip contenente le credenziali client per il database in una directory sicura del computer.

Questo file zip può essere scaricato dalla pagina Dettagli del database nella console di Oracle Cloud. Se si dispone di un account utente Oracle Cloud che consente di accedere a questa pagina, scaricare le credenziali come indicato di seguito. Se non si dispone di un account di questo tipo, è necessario ottenere il file zip dall'amministratore del database, insieme alla password utilizzata per proteggere il file zip.
1. Nel browser Web, collegarsi a Oracle Cloud e andare alla pagina Dettagli per Autonomous Database.
2. Fare clic su Connessione DB.
3. Nella pagina Connessione al database fare clic su Scarica.
4. Nella finestra di dialogo Scarica wallet, immettere una password per il wallet nel campo Password e confermare la password nel campo Conferma password.
  
  La password deve avere una lunghezza di almeno 8 caratteri e deve includere almeno 1 lettera e 1 carattere numerico o 1 carattere speciale.
5. Fare clic su Download per salvare il file ZIP delle credenziali del client in una directory sicura.
Dopo aver scaricato il file zip, attenersi alla procedura riportata di seguito.
1. Estrarre il file zip delle credenziali client.
2. Modificare il file sqlnet.ora fornito nelle credenziali client, sostituendo "?/network/admin" con il percorso completo della directory in cui sono state decompresse le credenziali client; ad esempio, modificare:
```
(DIRECTORY="?/network/admin")
```
  a:
```
(DIRECTORY="/users/jdoe/adbcredentials")
```
3. Creare la variabile di ambiente TNS_ADMIN, impostandone il valore sul percorso completo della directory in cui sono state decompresse le credenziali client.

Connessioni al database di codice e istruzioni SQL

Dopo aver configurato il sistema di sviluppo per supportare la connettività delle applicazioni PHP in un Autonomous Database, seguire le linee guida riportate di seguito per ottenere prestazioni elevate e disponibilità continua delle connessioni dell'applicazione al database.

Usa connection pool.
Abilitare FAN (Fast Application Notification).
Utilizzare il servizio di database predefinito che corrisponde meglio alle operazioni che si eseguiranno. Per informazioni sui servizi di database predefiniti, vedere Nomi predefiniti dei servizi di database per Autonomous Database.

Per PHP, si abilita FAN quando si aggiunge la riga oci8.events = On al file php.ini come parte del download e dell'installazione dell'estensione Oracle OCI8 in PHP.

L'interfaccia OCI8 non espone chiamate di connection pooling specifiche. In alternativa, utilizza internamente il connection pooling. Per ottenere i vantaggi del connection pooling, utilizzare la funzione oci_pconnect() per creare o riutilizzare una connessione persistente che rimane tra le richieste HTTP.

Ad esempio:

$connection = oci_pconnect("appuser", getenv("MY_PASSWORD_ENV_VAR"), "tp_tls");

In questo esempio viene creata una connessione persistente al servizio di database tp_tls.

Risorse aggiuntive

Per informazioni sull'estensione OCI8 Oracle a PHP, vedere la pagina Oracle OCI8.

Per informazioni sull'uso di PHP con Oracle Database, vedere The Underground PHP and Oracle Manual.

Titolo e informazioni sul copyright

Oracle e/o relative consociate.