mysql_pconnect
(PHP 4, PHP 5, PECL mysql:1.0)
mysql_pconnect — Abre uma conexão persistente com um servidor MySQL
Descrição
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'.
Parâmetros
- server
-
O 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'
- username
-
O nome de usuário. O Valor padrão é o nome do usuário que é o proprietário do processo do servidor.
- password
-
A 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.
Valor Retornado
Retorna um identificador de conexão persistente MySQL em caso de sucesso, ou FALSE em caso de falha.
Histórico
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 . |
Notas
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 certesa 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.