mysql_pconnect

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

mysql_pconnect — Perzisztens kapcsolatot nyit meg a MySQL szerverhez

Leírás

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

Egy perzisztes kapcsolatot hoz létre egy MySQL szerverhez.

A mysql_pconnect() függvény a mysql_connect() függvényhez hasonlóan működik, csupán két nagyobb különbség van:

Először is, a kapcsolat felvételekor a függvény először megpróbál egy (perzisztens) kapcsolatot találni, amely már nyitva van arra a hostra ugyanazzal a név/jelszó párossal. Ha talál ilyet, akkor ennek a kapocsnak az azonosítóját adja vissza és nem nyit újat.

Másodszor pedig a kapcsolat az SQL szerverhez nem kerül bezárásra, amikor a php program véget ér, hanem megmarad későbbi felhasználásra. (A mysql_close() függvény nem fogja neked lezárni a mysql_pconnect() függvénnyel megnyitott kapcsolatokat).

Az ilyen típusú kapcsolatot ezért hívják 'perzisztensnek'.

Paraméterek

server

A MySQL szerver. Egy protszámot is tartalmazhat, pl.: "hosztnév:port" vagy egy helyi socket útvonalát pl.: ":/path/to/socket".

A mysql.default_host PHP direktíva nincs definiálva (ez az alapértelmezés), akkor az alapértelmezett érték: 'localhost:3306'

username

A felhasználónév. Az alapértelmezett értéke azon felhasználónév amely a szerver folyamat tulajdonosa.

password

A jelszó. Az alapértelmezett érték üres jelszó.

client_flags

A client_flags paraméter az alábbi konstansok kombinációja lehet: MYSQL_CLIENT_SSL, MYSQL_CLIENT_COMPRESS, MYSQL_CLIENT_IGNORE_SPACE és MYSQL_CLIENT_INTERACTIVE.

Visszatérési értékek

Egy perzisztens MySQL kapcsolatazonosító, hiba esetén FALSE.

Változások naplója

Változat	Leírás
4.3.0	A `client_flags` paraméter hozzáadása.
3.0.10	A ":/path/to/socket" támogatása `server` paraméterként.
3.0.0	A ":port" támogatása `server` paraméterben.

Megjegyzések

Note: Ügyelj rá, hogy ezek a fajta kapcsolatok csak a PHP betölthető modulos változatában működnek. Lásd a Perzisztens Adatbázis Kapcsolatok fejezetet további információkért!

Warning

A perzisztens kapcsolatok használata megkövetel egy ki Apache és MySQL konfiguráció tuningot, hogy biztos lehess benne, hogy nem léped túl a megengedett MySQL kapcsolatok számát.

Note: A hiba esetén létrejövő hibaüzeneteket elnyomhatod a @ függvénynév elé való beszúrásával.

Lásd még