PHP -> Funkcie -> MySQL funkcie PHP -> mysql_pconnect
Syntax
resource mysql_pconnect ( [string $server [, string $username [, string $password [, int $client_flags] ] ] ] )
Popis
Príkaz jazyka PHP
Vytvoří persistentní (trvalé) spojení s MySQL serverem a vrací identifikátor spojení. Při neúspěšném pokusu o spojení vrací FALSE.
mysql_pconnect() otevře spojení s MySQL server. Je-li funkce volána bez nepovinných paramtrů, jsou u nich předpokládány následující výchozí hodnoty: server = 'localhost:3306', jmeno = jméno vlastníka procesu a heslo = prázdné heslo. Parametr nastaveni_klienta může být kombinací konstant MYSQL_CLIENT_COMPRESS, MYSQL_CLIENT_IGNORE_SPACE nebo MYSQL_CLIENT_INTERACTIVE.
Parametr server může obsahovat číslo portu ve stylu "hostname:port" nebo cestu k soketu ve stylu ":/cesta/k/soketu" pro localhost.
Poznámka: Podpora pro ":port" byla přidána v PHP 3.0B4.
Podpora pro ":/cesta/k/soketu" byla přidána v PHP 3.0.10.
Funkce mysql_pconnect() je velmi podobná funkci mysql_connect s dvěma hlavními rozdíly.
Za prvé, funkce se nejprve pokusí nalézt již existující (persistentní) spojení otevřené na stejném portu pod stejným jménem a heslem. Je-li takové spojení nalezeno, použije se namísto vytváření nového.
Za druhé, spojení s SQL serverem nebude uzavřeno při ukončení běhu skriptu. Zůstane otevřeno pro použití v dalších skriptech, které teprve budou spouštěny (mysql_close neuzavře persistentní spojení vytvořené pomocí mysql_pconnect()).
Nepovinný parametr nastaveni_klientabyl přidán v PHP 4.3.0.
Proto je tento typ spojení nazýván jako 'persistentní' - trvalý.
Poznámka: Persistentní spojení funguje pouze v případě, kdy je PHP spuštěno jako modul (nikoli CGI).
Varování: Používání persistetního spojení může vyžadovat malou úpravu v konfiguraci Apache a MySQL k zajištění nepřekročení maximálního limitu povolených připojení k MySQL.