LVIII. Microsoft SQL Server

Introduction

Ces fonctions vous permettent d'accéder aux serveurs de données MS SQL.

Note : L'extension MSSQL n'est disponible que sous Windows 32 bits. Vous pouvez utiliser l'extension Sybase extension pour vous connecter à un serveur MSSQL, depuis d'autres plate-formes.

Pré-requis

Vous avez besoin d'un client MS SQL Client Tools sur votre système, accessible à PHP. Les Client Tools peuvent être installé depuis le CD MS SQL Server CD ou en copiant ntwdblib.dll depuis le dossier \winnt\system32 du serveur MS SQL vers \winnt\system32 sur le serveur PHP. Copier ntwdblib.dll ne fera que fournir le moyen d'accès. La configuration du client requiert l'installation des autres outils.

Pré-requis pour les plate-formes Unix/Linux.

Pour utiliser l'extension MSSQL sur Unix/Linux, vous devez commencer par compiler et installer la librairie FreeTDS. Le code source et les instructions d'installation sont disponibles sur les ite de FreeTDS : http://www.freetds.org/

Installation

The MSSQL extension is enabled by adding extension=php_mssql.dll to php.ini.

To get these functions to work, you have to compile PHP with --with-mssql[=DIR], where DIR is the FreeTDS install prefix. And FreeTDS should be compiled using --enable-msdblib.

Configuration à l'exécution

Le comportement de ces fonctions est affecté par la configuration dans le fichier php.ini.

Tableau 1. MS SQL Server configuration options

NameDefaultChangeable
mssql.allow_persistent"1"PHP_INI_SYSTEM
mssql.max_persistent"-1"PHP_INI_SYSTEM
mssql.max_links"-1"PHP_INI_SYSTEM
mssql.min_error_severity"10"PHP_INI_ALL
mssql.min_message_severity"10"PHP_INI_ALL
mssql.compatability_mode"0"PHP_INI_ALL
mssql.connect_timeout"5"PHP_INI_ALL
mssql.timeout"60"PHP_INI_ALL
mssql.textsize"-1"PHP_INI_ALL
mssql.textlimit"-1"PHP_INI_ALL
mssql.batchsize"0"PHP_INI_ALL
mssql.datetimeconvert"1"PHP_INI_ALL
mssql.secure_connection"0"PHP_INI_SYSTEM
mssql.max_procs"25"PHP_INI_ALL
For further details and definition of the PHP_INI_* constants see ini_set().

Types de ressources

Constantes prédefinies

Ces constantes sont définies par cette extension, et ne sont disponibles que si cette extension a été compilée avec PHP, ou bien chargée au moment de l'exécution.

MSSQL_ASSOC (integer)

MSSQL_NUM (integer)

MSSQL_BOTH (integer)

SQLTEXT (integer)

SQLVARCHAR (integer)

SQLCHAR (integer)

SQLINT1 (integer)

SQLINT2 (integer)

SQLINT4 (integer)

SQLBIT (integer)

SQLFLT8 (integer)

Table des matières
mssql_bind --  Ajoute un paramètre à une procédure stockée MSSQL (locale ou distante)
mssql_close -- Ferme une connexion MS SQL Server
mssql_connect -- Ouvre une connexion à un serveur MS SQL server
mssql_data_seek -- Déplace le pointeur interne de ligne
mssql_execute --  Exécute une procédure stockée sur un serveur MS SQL
mssql_fetch_array -- Lit une ligne de résultat MSSQL dans un tableau
mssql_fetch_assoc --  Retourne un tableau associatif pour la ligne courant de résultat MS SQL Server
mssql_fetch_batch --  Retourne le prochain lot de lignes MS SQL Server
mssql_fetch_field -- Lit les informations sur le champ
mssql_fetch_object --  Retourne une ligne de résultat MS SQL Server sous la forme d'un objet
mssql_fetch_row --  Lit une ligne de résultat MSSQL dans un tableau numérique
mssql_field_length -- Lit la longueur d'un champ MS SQL Server
mssql_field_name -- Lit le nom d'un champ MS SQL Server
mssql_field_seek -- Fixe l'offset du pointeur de champ MS SQL Server
mssql_field_type -- Lit le nom d'un champ MS SQL Server
mssql_free_result -- Libère la mémoire des ressources MS SQL Server
mssql_free_statement -- Libère une commande MS SQL Server de la mémoire
mssql_get_last_message --  Retourne le dernier message d'erreur du serveur
mssql_guid_string --  Convertit le GUID binaire de 16 octets en une chaîne de caractères
mssql_init --  Initialise une procédure stockée MS SQL Server locale ou distante
mssql_min_error_severity --  Fixe le niveau de sévérité des erreurs MS SQL Server
mssql_min_message_severity --  Fixe le niveau de sévérité des messages d'erreurs MS SQL Server
mssql_next_result --  Déplace le pointeur interne MS SQL Server au le résultat suivant
mssql_num_fields -- Retourne le nombre de champs dans un résultat MS SQL Server
mssql_num_rows --  Retourne le nombre de lignes dans un résultat MSSQL
mssql_pconnect --  Ouvre une connexion persistante à un serveur MS SQL.
mssql_query -- Envoie une requête SQL au serveur MSSQL
mssql_result -- Lit les données d'un résultat
mssql_rows_affected --  Retourne le nombre de ligne affectées par une requête MS SQL Server
mssql_select_db -- Sélectionne la base de données MS SQL