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

mssql_pconnect() se comporta como mssql_connect() pero con dos diferencias:

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);
?>