array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.mysql-pconnect.php', 1 => 'mysql_pconnect', 2 => 'Abre uma conexão persistente a um servidor MySQL', ), 'up' => array ( 0 => 'ref.mysql.php', 1 => 'Funções da MySQL', ), 'prev' => array ( 0 => 'function.mysql-num-rows.php', 1 => 'mysql_num_rows', ), 'next' => array ( 0 => 'function.mysql-ping.php', 1 => 'mysql_ping', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/mysql/functions/mysql-pconnect.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

mysql_pconnect

(PHP 4, PHP 5)

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

Aviso

Esta extensão foi descontinuada 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

Nota: 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.

Aviso

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