mysql_pconnect
(PHP 4, PHP 5, PECL mysql:1.0)
mysql_pconnect — Perzisztens kapcsolatot nyit meg a MySQL szerverhez
LeÃrás
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!
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.