Funzione mysql_pconnect() di PHP

Definizione e uso

La funzione mysql_pconnect() apre una connessione persistente con il server MySQL.

mysql_pconnect() e mysql_connect() sono molto simili, ma ci sono due principali differenze:

  1. Quando si connette, questa funzione tenta prima di trovare una connessione (persistente) già aperta sullo stesso host con lo stesso nome utente e password. Se trovata, restituisce l'identificatore di questa connessione senza aprire una nuova connessione.
  2. In secondo luogo, quando lo script è eseguito, la connessione con il server SQL non viene chiusa. Questa connessione rimarrà aperta per essere utilizzata in futuro (mysql_close() non chiude la connessione creata da mysql_pconnect()).

Sintassi

mysql_pconnect(server,user,pwd,clientflag)
Parametro Descrizione
server

Opzionale. Specifica il server da connettere.

Può includere il numero di porta, ad esempio "hostname:port" o il percorso per il socket locale, ad esempio per localhost ":/path/to/socket".

Se l'instruzione mysql.default_host PHP non è definita (condizione predefinita), il valore predefinito è 'localhost:3306'.

user Opzionale. Nome utente. Il valore predefinito è il nome utente del proprietario del processo del server.
pwd Opzionale. Password. Il valore predefinito è una password vuota.
clientflag

Opzionale.clientflags Il parametro può essere una combinazione delle seguenti costanti:

  • MYSQL_CLIENT_SSL - Utilizza la crittografia SSL
  • MYSQL_CLIENT_COMPRESS - Utilizza il protocollo di compressione
  • MYSQL_CLIENT_IGNORE_SPACE - Permette spazi dopo il nome della funzione
  • MYSQL_CLIENT_INTERACTIVE - Permette di chiudere la connessione prima del timeout inattivo dell'interazione

Valore di ritorno

Se riuscito, restituisce un identificatore di connessione MySQL persistente, in caso di errore restituisce FALSE.

Suggerimenti e note

Nota:Parametro opzionale clientflag Disponibile a partire dalla versione PHP 4.3.0.

Suggerimento:Per creare una connessione non persistente, utilizzare mysql_connect() Funzione.

Esempio

<?php
$con = mysql_pconnect("localhost","mysql_user","mysql_pwd");
if (!$con)
  {
  die('Impossibile connettersi: ' . mysql_error());
  }
?>