PHP mysql_pconnect() funktion

definition og brug

mysql_pconnect() funktionen åbner en vedvarende forbindelse til MySQL-serveren.

mysql_pconnect() og mysql_connect() er meget lignende, men der er to vigtige forskelle:

  1. når der oprettes forbindelse, vil denne funktion først forsøge at finde en eksisterende (påholdende) forbindelse med samme brugernavn og adgangskode på samme vært, hvis fundet, vil den returnere denne forbindelsesidentifikator uden at åbne en ny forbindelse.
  2. næste, når skriptet udføres, vil forbindelsen til SQL-serveren ikke blive lukket, denne forbindelse vil forblive åben til senere brug (mysql_close() lukker ikke forbindelsen oprettet af mysql_pconnect()).

syntaks

mysql_pconnect(server,user,pwd,clientflag)
parametre beskrivelse
server

valgfri. Angiver den server, der skal forbindes til.

kan inkludere portnummer, f.eks. "hostname:port" eller en sti til en lokal sokkel, f.eks. for localhost: ":/path/to/socket".

Hvis PHP-instruktionen mysql.default_host ikke er defineret (standard), er standardværdien 'localhost:3306'.

user Valgfri. Brugernavn. Standardværdi er brugernavnet til serverprocessens ejer.
pwd Valgfri. Password. Standardværdi er en tom adgangskode.
clientflag

Valgfri.clientflags Parametrene kan være en kombination af følgende konstanter:

  • MYSQL_CLIENT_SSL - Bruger SSL-kryptering
  • MYSQL_CLIENT_COMPRESS - Bruger komprimeringsprotokol
  • MYSQL_CLIENT_IGNORE_SPACE - Tillader mellemrum efter funktionens navn
  • MYSQL_CLIENT_INTERACTIVE - Tillader at afslutte forbindelsen uden at forlænge interaktions-tidsudløbet for inaktiv tid

Returværdi

Returnerer en MySQL persistent forbindelsesidentifikator, hvis succesfuld, ellers returnerer FALSE.

Vedvisninger og bemærkninger

Bemærkning:Valgfri parameter clientflag Tilgængelig fra PHP 4.3.0 versionen.

Vedvisning:For at oprette en ikke-persistent forbindelse, brug mysql_connect() funktioner.

Eksempel

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