mssql_pconnect
(PHP 4, PHP 5, PECL odbtp >= 1.1.1)
mssql_pconnect — Abre una conexión MS SQL persistente
Advertencia
Esta función está OBSOLETA en PHP 7.0.0.
Las alternativas a esta función son:
Descripción
mssql_pconnect
([ string $servername
[, string $username
[, string $password
[, bool $new_link
= false
]]]] ) : resource
En primer lugar, durante la conexión, la función intentaría encontrar
una conexión persistente que ya esté abierta con el mismo host,
usuario y contraseña. Si se encuentra uno, se devolverá su
identificador a esa conexión en vez de abrir una nueva.
En segundo lugar, la conexión al servidor SQL no se cerrará cuando
finalice la ejecución del script. En lugar de ello, permanecerá
abierta para uso futuro (mssql_close() no cerrará
las conexiones establecidas por mssql_pconnect()).
Por ello, este tipo de conexiones se llaman 'persistentes'.
Parámetros
-
servername
-
El servidor MS SQL. Puede incluir también un número de puerto, p.e.
hostname:port.
-
username
-
El usuario.
-
password
-
La contraseña.
-
new_link
-
Si se hace una segunda llamada a la función mssql_pconnect() con
los mismos argumentos, no se establecerá una nueva conexión, sino que en su lugar, se
devolverá el identificador de la conexión ya abierta. Este
parámetro modifica este comportamiento y hace que
mssql_pconnect() siempre abra una nueva conexión, incluso si
mssql_pconnect() se llamó antes con los mismos
parámetros.
Valores devueltos
Devuelve un identificador a una conexión persistente a MS SQL en caso de éxito, o
FALSE
en caso de error.
Ejemplos
Ejemplo #1 mssql_pconnect() usando el parámetro new_link
<?php
// Conectar a MSSQL y seleccionar la base de datos
$link1 = mssql_pconnect('MANGO\SQLEXPRESS', 'sa', 'phpfi');
mssql_select_db('php', $link1);
// Crear una nueva conexión
$link2 = mssql_pconnect('MANGO\SQLEXPRESS', 'sa', 'phpfi', true);
mssql_select_db('random', $link2);
?>