mssql_pconnect

(PHP 4, PHP 5, PECL odbtp >= 1.1.1)

mssql_pconnect — Baut eine persistente MS SQL Verbindung auf

Warnung

This function was REMOVED in PHP 7.0.0.

Alternatives to this function include:

Beschreibung

resource mssql_pconnect ([ string $servername [, string $username [, string $password [, bool $new_link = false ]]]] )

mssql_pconnect() verhält sich, von zwei wesentlichen Unterschieden abgesehen, fast genauso wie mssql_connect().

Erstens: Die Funktion wird beim Verbindungsaufbau zunächst versuchen, eine (persistente) Verbindung zu finden, die unter dem selben Host, Benutzername und Passwort geöffnet wurde. Wenn eine solche gefunden wird, gibt sie deren Kennung zurück, statt eine neue Verbindung aufzubauen.

Zweitens: die Verbindung zum SQL Server wird bei Beendigung des Skripts nicht geschlossen. Stattdessen bleibt die Verbindung für eine spätere Verwendung bestehen (mssql_close() schließt keine Verbindungen, die mittels mssql_pconnect() aufgebaut wurden).

Eine solche Verbindung wird deshalb als 'persistent' bezeichnet.

Parameter-Liste

servername: Der MS SQL-Server. Er kann auch eine Portnummer enthalten, z.B. hostname:port.
username: Der Benutzername
password: Das Passwort
new_link: Falls mssql_pconnect() zum zweiten Mal mit denselben Argumenten aufgerufen wird, wird keine neue Verbindung aufgebaut, sondern stattdessen die Verbindungskennung der bereits bestehenden Verbindung zurückgegeben. Mit diesem Parameter wird dieses Verhalten geändert, sodass mssql_pconnect() immer eine neue Verbindung aufbaut, auch wenn mssql_pconnect() zuvor schon mit denselben Parameter aufgerufen wurde.

Rückgabewerte

Gibt bei Erfolg eine positive persistente MS SQL Verbindungskennung oder, bei Auftreten eines Fehlers, FALSE zurück.

Beispiele

Beispiel #1 mssql_pconnect() mit Verwendung des Parameters new_link


<?php
// Mit MSSQL verbinden und Datenbank auswählen
$verbindung1 = mssql_pconnect('MANGO\SQLEXPRESS', 'sa', 'phpfi');
mssql_select_db('php', $verbindung1);

// Eine neue Verbindung erzeugen
$verbindung2 = mssql_pconnect('MANGO\SQLEXPRESS', 'sa', 'phpfi', true);
mssql_select_db('random', $verbindung2);
?>