mssql_num_rows
mssql_query
Mssql-Funktionen
PHP Manual

# mssql_pconnect

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

mssql_pconnect — Baut eine persistente MS SQL Verbindung auf

### Beschreibung

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

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

mssql_num_rows
mssql_query
Mssql-Funktionen
PHP Manual