Forum und email

mysql_pconnect

(PHP 4, PHP 5, PECL mysql:1.0)

mysql_pconnect — Open een persistente verbinding naar een MySQL server

Beschrijving

resource mysql_pconnect ([ string $ server [, string $username [, string $password [, int $ client_flags ]]]] )

Geeft een positieve MySQL persistente link indentifier bij succes, of FALSE bij een fout.

mysql_pconnect() maakt een verbinding met een MySQL server. De volgende defaults worden aangenomen voor missende optionele parameters: server = 'localhost:3306', username = naam van de gebruiker die het server process ownt en password = leeg password. De client_flags parameter kan een combinatie van the constanten MYSQL_CLIENT_SSL, MYSQL_CLIENT_COMPRESS, MYSQL_CLIENT_IGNORE_SPACE en MYSQL_CLIENT_INTERACTIVE zijn.

De server parameter kan ook een port nummer meekrijgen, bijvoorbeeld "hostname:port", of een pad naar een socket, bijvoorbeeld ":/path/to/socket" voor de localhost.

Note: Ondersteuning voor ":port" werd toegevoegd in 3.0B4.
Ondersteuning voor ":/path/to/socket" werd toegevoegd in 3.0.10.

mysql_pconnect() doet bijna hetzelfde als mysql_connect(), met twee grote verschillen.

Ten eerste, wanneer je verbinding maakt, zal de functie eerst proberen een (persistente) link te openen die al open staat met dezelfde host, username en password. Als er een gevonden wordt zal een identifier ervoor worden teruggegeven, in plaats van een nieuwe verbinding te openen.

Ten tweede, de verbinding met de SQL server zal niet worden gesloten wanneer de executie van het script klaar is. In plaats daarvan zal de link open blijven voor toekomstig gebruik (mysql_close() zal geen links sluiten die werden gemaakt door mysql_pconnect()).

De client_flags werd beschikbaar in PHP 4.3.0.

Dit type link wordt daarom 'persistent' genoemd.

Note: Let er op dat dit soort links alleen werken als je een module versie van PHP gebruikt. Zie de Persistente Database connecties sectie voor meer informatie.

Warning

Het gebruiken van persistente verbindingen kan een beetje instelling van PHP en MySQL configuraties vereisen om er zeker van te zijn dat je het maximum aantal toegestane verbindingen door MySQL niet overschrijdt.