Connessione a MySQL e selezione del DB

26 August 2006

Vediamo ora come realizzare un semplice script PHP in grado di connettersi ad un server MySQL. La connessione avviene grazie ala funzione mysql_connect(). I dati necessari alla connessione sono:

indirizzo del server: bisogna specificare su quale computer è in esecuzione il server MySQL. Nella maggior parte dei casi MySQL gira sulla stessa macchina in cui è in funzione il server web (e quindi il PHP) pertanto l’indirizzo da specificare è “localhost”. Se invece il server si trova su un diverso computer, raggiungibile attraverso una connessione TCP/IP, allora bisogna specificare il nome di dominio (es. sql.mioserver.it) o l’indirizzo IP (es. 162.54.23.12) della macchina che lo ospita.
nome utente e password: si tratta delle credenziali che permettono al server MySQL di identificare l’utente che effettua la richiesta di connessione. Se abbiamo appena installato MySQL allora possiamo usare il nome utente “root” e per password quella specificata durante l’installazione.

La funzione mysql_connect() restituisce come risultato un numero che costituisce l'identificativo di connessione MySQL (“MySQL link identifier” oppure " MySQL-Link resource") in caso di successo oppure FALSE in caso contrario. E' quindi possibile verificare l’esito della connessione semplicemente controllando il risultato restituito da mysql_connect().

Se qualcosa va storto possiamo inoltre ottenere maggiori informazioni sull’accaduto utilizzando un’altra funzione, mysql_error(), che ci mostrerà un messaggio esplicativo sul problema verificatosi.

Effettuata la connessione a MySQL si è soliti specificare il nome del database su cui si vogliono effettuare le query. Infatti uno script PHP generalmente effettua diverse query ma tutte su tebelle appartenenti ad uno stesso database. Per dichiarare il nome del database si usa la funzione mysql_select_db() che restituisce TRUE o FALSE a seconda dell’esito dell’operazione. Anche questa volta conviene subito controllare tale risultato ed eventualmente mostrare un messaggio di errore con la funzione mysql_error().

Anche se tutte le connessioni ai server MySQL vengono automaticamente chiuse alla fine dell’esecuzione dello script, è buona norma chiudere la connessione esplicitamente, appena lo script ha terminato le operazioni con il database. Per farlo basta richiamare la funzione mysql_close() a cui passiamo come parametro l’identificativo di connessione ottenuto da mysql_connect().

Vediamo quindi un semplice esempio di connessione, selezione del DB e chiusura del link:

<?php
$link = mysql_connect('localhost', 'nome_utente', 'password');
if (!$link) {
   die ('Non riesco a connettermi: ' . mysql_error());
}

$db_selected = mysql_select_db('prova', $link);
if (!$db_selected) {
   die ("Errore nella selezione del database: " . mysql_error());
}

echo 'connesso con successo';

mysql_close($link);
?>

Ecco nel dettaglio il funzionamento del precedente script:

la riga 2 effettua la connessione al server attraverso la funzione mysql_connect() a cui viene passato l’indirizzo del server (‘localhost’), il nome dell’utente di MySQL (‘nome_utente’) e la relativa password (‘password’);
la riga 3 controlla il valore di $link restituito da mysql_connect(). Se vale FALSE la riga 4 mostra un messaggio di errore grazie alla funzione mysql_error() e termina lo script;
la riga 7 seleziona il database da utilizzare, richiamando la funzione mysql_select_db() a cui passiamo il nome del database ‘prova’ ed il $link che identifica la connessione appena effettuata.
la riga 8 controlla il valore di $db_selected restituito da mysql_select_db(). Se vale FALSE la riga 9 mostra un messaggio di errore grazie alla funzione mysql_error() e termina lo script;
la riga 14 infine chiude la connessione al server MySQL attraverso la funzione mysql_close().

La connessione va eseguita una sola volta per script, generalmente all’inizio del codice, poiché è necessario che questa preceda l’esecuzione delle query. E' possibile effettuare più connessioni all’interno di uno stesso script ma questo ha senso solo se ci si deve interfacciare con diversi server MySQL, circostanza piuttosto rara.

Quella vista è la procedura di connessione comunemente impiegata negli script PHP/MySQL. Si possono verificare però condizioni e circostanze che richiedono un uso differente della funzione mysql_connect(), mostrate di seguito attraverso degli esempi:

per collegarsi al server MySQL presente sull’host miodominio.it (diverso da localhost) usando una porta differente da quella standard (3306), ad esempio la 3307: $link = mysql_connect('miodominio.it:3307', 'nome_utente', 'password');
per collegarsi al server MySQL presente il localhost usando una porta differente da quella standard (3306), ad esempio la 3307: $link = mysql_connect('127.0.0.1:3307', 'nome_utente', 'password'); Si noti che non è stato usato come host ‘localhost:3307’ perché PHP avrebbe creato una connessione attraverso socket (named pipe su Windows) invece di usare il TCP/IP e quindi avrebbe ignorato il numero di porta.
per collegarsi a localhost specificando il percorso del socket: $link = mysql_connect('/tmp/mysql', 'nome_utente', 'password'); oppure: $link = mysql_connect('localhost:/tmp/mysql.sock', 'nome_utente', 'password');

Accanto all’indicazione del server, del nome utente e della password, la funzione mysql_connect() accetta due ulteriori parametri:

new_link: se in uno script viene chiamata la funzione mysql_connect() due o più volte con gli stessi parametri, questa restituirà sempre lo stesso identificativo di connessione. Questo perché mysql_connect() evita di aprire nuovi (inutili) link ad uno stesso server MySQL. Se si vuole disabilitare questo comportamento basta porre il parametro new_link a TRUE.

client_flags: una combinazione di flag (MYSQL_CLIENT_IGNORE_SPACE, MYSQL_CLIENT_IGNORE_SPACE, MYSQL_CLIENT_INTERACTIVE, MYSQL_CLIENT_SSL).

Per i dettagli si rimanda alla documentazione ufficiale.

Connessioni persistenti

La procedura di connessione vista comporta la creazione di un nuovo link tra PHP e MySQL ad ogni esecuzione dello script. Questo collegamento viene interrotto con la funzione mysql_close() o automaticamente al termine dello script. Alla semplicità di questo approccio si contrappone un’evidente inefficienza: la procedura di connessione, ripetuta ad ogni esecuzione dello script, potrebbe risultare onerosa in termini di prestazioni, soprattutto se PHP e MySQL sono su macchine differenti.

Per ovviare a questo problema è possibile utilizzare le connessioni persistenti. In pratica, attraverso la funzione mysql_pconnect() che segue la stessa sintassi della mysql_connect(), si cerca di riciclare vecchie connessioni precedentemente aperte e ancora attive. Il funzionamento è il seguente:

per prima cosa la funzione mysql_pconnect() cerca un link persistente ancora attivo, aperto da una precedente chiamata a mysql_pconnect() effettuata impiegato gli stessi dati per host, username e password;
se tale link viene trovato allora mysql_pconnect() non apre una nuova connessione ma restituisce l’identificativo di connessione del vecchio collegamento, ovvero riutilizza la vecchia connessione;
se non è disponibile un link persistente ancora attivo allora se ne crea uno nuovo;
infine, al termine dello script, il link non viene chiuso, neanche se viene invocata la funzione mysql_close().

Come accennato, le connessioni persistenti hanno come unico obbiettivo la riduzione dell’overhead legato alla fase di creazione dei link tra PHP e MySQL. Purtroppo però l’uso delle connessioni persistenti richiede una certa abilità nel configurare il server. Se infatti MySQL è configurato per non aprire più di un certo numero di connessioni contemporaneamente, la richiesta di una ulteriore connessione da parte di PHP non verrà soddisfatta con conseguenze ovvie sul suo funzionamento dello script.

Per questo, e per altri inconvenienti che si potrebbero verificare, si rimanda alla documentazione di PHP (in particolare a questa pagina) e MySQL.