Abre uma conexão persistente a um servidor MySQL

# 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:

- mysqli_connect() com `p:` host prefix
- PDO::__construct() com `PDO::ATTR_PERSISTENT` como uma opção de driver

### Descrição

function 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

- mysql_connect() - Abre uma conexão a um servidor MySQL
- Conexões Persistentes com Banco de Dados

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open