Função mysql_pconnect() do PHP
Definição e uso
A função mysql_pconnect() abre uma conexão persistente com o servidor MySQL.
mysql_pconnect() e mysql_connect() são muito semelhantes, mas têm duas principais diferenças:
- Quando estabelecendo a conexão, esta função tentará primeiro encontrar uma conexão (persistente) já aberta na mesma máquina com o mesmo nome de usuário e senha. Se encontrar, retornará o identificador dessa conexão sem abrir uma nova conexão.
- Em seguida, quando o script for executado, a conexão com o servidor SQL não será fechada. Esta conexão permanecerá aberta para uso futuro (mysql_close() não fecha a conexão estabelecida por mysql_pconnect()).
Sintaxe
mysql_pconnect(server,user,pwd,clientflag)
| Parâmetros | Descrição |
|---|---|
| server |
Opcional. Define o servidor a ser conectado. Pode incluir o número da porta, por exemplo "hostname:port", ou o caminho para o soquete local, por exemplo para localhost ":/path/to/socket". Se a instrução mysql.default_host não estiver definida no PHP (situação padrão), o valor padrão é 'localhost:3306'. |
| user | Nome de usuário. O valor padrão é o nome do proprietário do processo do servidor. |
| pwd | Senha. O valor padrão é uma senha vazia. |
| clientflag |
Opcional.clientflags Os parâmetros podem ser uma combinação das seguintes constantes:
|
Retorno
Se bem-sucedido, retorna um identificador de conexão persistente MySQL, se der erro, retorna FALSE.
Dicas e Notas
Notas:Parâmetro Opcional clientflag Disponível desde a versão PHP 4.3.0.
Dica:Para criar uma conexão não persistente, use mysql_connect() Função.
Exemplo
<?php
$con = mysql_pconnect("localhost","mysql_user","mysql_pwd");
if (!$con)
{
die('Não foi possível conectar: ' . mysql_error());
}
?>
