(PHP 4, PHP 5)
mysql_pconnect — Abre uma conexão persistente com um servidor MySQL
$server
[, string $username
[, string $password
[, int $client_flags
]]]] )Estabelece uma conexão persistente com o servidor MySQL.
mysql_pconnect() funciona muito parecido com mysql_connect() com duas maiores diferenças.
Primeiro, ao conectar,a função irá primeiro tentar encontrar uma conexão(persistente) que já esteja aberta com o mesmo servidor, nome de usuário e senha. Se uma for encontrada, um identificador para ela será retornado ao invés de abrir uma nova conexão.
Segundo, a conexão ao servidor SQL não será fechada quando a execução do script terminar. Ao invés, a conexão permanecerá aberta para uso futuro (mysql_close() não irá fechar conexões estabelecidas por mysql_pconnect()).
Este tipo de conexão portanto é chamada 'persistente'.
serverO servidor MySQL. Também pode incluir um numero de porta. exemplo "hostname:port" ou um caminho para um socket local exemplo ":/path/to/socket" para o servidor local.
Se a diretiva do PHP mysql.default_host não estiver definida (padrão), então o valor padrão é 'localhost:3306'
usernameO nome de usuário. O Valor padrão é o nome do usuário que é o proprietário do processo do servidor.
passwordA senha. O valor padrão é uma senha vazia.
client_flags
O parâmetro client_flags pode ser uma combinação
das seguintes constantes:
128 (habilita manuseador LOAD DATA LOCAL),
MYSQL_CLIENT_SSL,
MYSQL_CLIENT_COMPRESS,
MYSQL_CLIENT_IGNORE_SPACE ou
MYSQL_CLIENT_INTERACTIVE.
Retorna um identificador de conexão persistente MySQL em caso de
sucesso, ou FALSE em caso de falha.
| Versão | Descrição |
|---|---|
| 4.3.0 |
Adicionado o parâmetro client_flags.
|
| 3.0.10 |
Adicionado o suporte a ":/path/to/socket" com
server.
|
| 3.0.0 |
Adicionado o suporte a ":port" com server.
|
Nota:
Note que este tipo de conexão funciona somente se você estiver usando uma versão do PHP como módulo. Veja a sessão Conexões Persistentes com Banco de Dados para maiores informações.
Usar conexões persistentes podem requerer alguns ajustes na suas configurações do Apache e do MySQL para ter certeza que você não exceda o limite de conexões permitidas pelo MySQL.
Nota:
Você pode suprimir a mensagem de erro em caso de falha adicionando @ ao nome da função.