mssql_connect

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

mssql_connect — Baut eine Verbindung zum MS SQL Server auf

Warnung

Diese Funktion wurde in PHP 7.0.0 REMOVED (entfernt).

Alternativ können folgende Features verwendet werden:

Beschreibung

mssql_connect ([ string $servername [, string $username [, string $password [, bool $new_link = FALSE ]]]] ) : resource

mssql_connect() baut eine Verbindung zu einem MS SQL Server auf.

Die Verbindung zum Server wird geschlossen, sobald die Ausführung des Skripts abgeschlossen ist, wenn sie nicht schon vorher durch einen expliziten Aufruf von mssql_close() geschlossen wurde.

Parameter-Liste

servername

Der MS SQL-Server. Er kann auch eine Portnummer enthalten, z.B. hostname:port (Linux) oder hostname,port (Windows).

username

Der Benutzername

password

Das Passwort

new_link

Falls mssql_connect() 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_connect() immer eine neue Verbindung aufbaut, auch wenn mssql_connect() zuvor schon mit denselben Parameter aufgerufen wurde.

Rückgabewerte

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

Changelog

Version Beschreibung
5.1.0 Den Parameter new_link hinzugefügt

Beispiele

Beispiel #1 mssql_connect()-Beispiel

<?php
// Server in diesem Format: <computer>\<instance name> oder
// <server>,<port>, falls nicht der Standardport verwendet wird
$server = 'KALLESPC\SQLEXPRESS';

// Mit MSSQL verbinden
$verbindung = mssql_connect($server, 'sa', 'phpfi');

if (!$verbindung) {
    die('Beim Aufbau der Verbindung mit MSSQL ging etwas schief');
}
?>

Siehe auch