mysql_pconnect

(PHP 4, PHP 5)

mysql_pconnect — Abre uma conexão persistente a um servidor MySQL

Warning

Esta extensão tornou-se defasada a partir do PHP 5.5.0 e foi removida no PHP 7.0.0. Em vez disso, as extensões MySQLi ou PDO_MySQL devem ser usadas. Veja também o guia MySQL: escolhendo uma API. Alternativas a esta função incluem:

Descrição

mysql_pconnect(
    string $server = ini_get("mysql.default_host"),
    string $username = ini_get("mysql.default_user"),
    string $password = ini_get("mysql.default_password"),
    int $client_flags = 0
): resource

Estabelece uma conexão persistente com o servidor MySQL.

mysql_pconnect() funciona muito parecido com mysql_connect() com duas diferenças principais.

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 for encontrada, um identificador para ela será retornado ao invés de ser aberta 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 disso, 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 é chamado de 'persistente'.

Parâmetros

server

O servidor MySQL. Também pode incluir um numero de porta, por exemplo, "servidor:porta" ou um caminho para um soquete local, por exemplo, ":/caminho/para/soquete" para o servidor local.

Se a diretiva do PHP mysql.default_host não estiver definida (padrão), o valor padrão será 'localhost:3306'

username

O nome de usuário. O Valor padrão é o nome do usuário proprietário do processo no 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 uso de 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.

Notas

Note:

Note que este tipo de conexão funciona somente se a versão de módulo do PHP estiver sendo usada. Consulte a seção sobre Conexões Persistentes com Banco de Dados para mais informações.

Warning

Usar conexões persistentes pode requerer alguns ajustes nas configurações do Apache e do MySQL para assegurar que o número máximo de conexões permitidas pelo MySQL não seja excedido.

Veja Também