CLXI. Sybase

Introduction

Pré-requis

Installation

Pour activer le support des bases de données Sybase-DB, vous devez compiler PHP avec l'option --with-sybase[=DIR]. DIR est le dossier d'installation de Sybase et, par défaut, il vaut /home/sybase. Pour activer le support de Sybase-CT, vous devez compiler PHP avec l'option --with-sybase-ct[=DIR]. DIR est le dossier d'installation de Sybase et, par défaut, il vaut /home/sybase.

Configuration à l'exécution

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

Sybase

Tableau 1. Options de configuration

Nom	Par défaut	Modifiable	Historique
sybase.allow_persistent	"1"	PHP_INI_ALL	PHP_INI_ALL dans PHP <= 4.0.2. PHP_INI_SYSTEM dans PHP <= 4.0.3.
sybase.max_persistent	"-1"	PHP_INI_ALL	PHP_INI_ALL dans PHP <= 4.0.2. PHP_INI_SYSTEM dans PHP <= 4.0.3.
sybase.max_links	"-1"	PHP_INI_ALL	PHP_INI_ALL dans PHP <= 4.0.2. PHP_INI_SYSTEM dans PHP <= 4.0.3.
sybase.interface_file	"/usr/sybase/interfaces"	PHP_INI_SYSTEM
sybase.min_error_severity	"10"	PHP_INI_ALL
sybase.min_message_severity	"10"	PHP_INI_ALL
sybase.compatability_mode	"0"	PHP_INI_ALL
magic_quotes_sybase	"0"	PHP_INI_ALL

Voici un éclaircissement sur l'utilisation des directives de configuration.

sybase.allow_persistent booléen: Activation ou non des connexions persistantes.
sybase.max_persistent entier: Le nombre maximum de connexions Sybase persistantes par processus. -1 signifie illimité.
sybase.max_links entier: Le nombre maximum de connexions Sybase par processus. -1 signifie illimité.
sybase.min_error_severity entier: Le niveau minimal d'erreur à afficher.
sybase.min_message_severity entier: Le niveau minimal de message d'erreur à afficher.
sybase.compatability_mode booléen: Mode de compatibilité avec les anciennes versions de PHP 3.0. Si activé (on), cela va faire que PHP assigne automatiquement des types aux résultats, en fonctions de leur type Sybase, au lieu de les traiter comme des chaînes de caractères. Ce mode de compatibilité ne va pas rester des années, alors essayez de modifier votre code, et de désactiver cette fonctionnalité.
magic_quotes_sybase booléen: Si magic_quotes_sybase est aussi activé, un guillemets simple est échappé avec un guillemet simple au lieu d'un anti-slash, si magic_quotes_gpc ou magic_quotes_runtime est activé.
Note : Si la directive magic_quotes_sybase est activée, elle remplacera complètement magic_quotes_gpc. Ce qui fait que même si magic_quotes_gpc retourne TRUE, les guillemets doubles, les anti-slashes ou les caractères NULL ne seront pas protégés.

Sybase-CT

Tableau 2. Options de configuration

Nom	Par défaut	Modifiable	Historique
sybct.allow_persistent	"1"	PHP_INI_SYSTEM	PHP_INI_ALL dans PHP <= 4.0.2. Disponible depuis PHP 4.0.2.
sybct.max_persistent	"-1"	PHP_INI_SYSTEM	PHP_INI_ALL dans PHP <= 4.0.2. Disponible depuis PHP 4.0.2.
sybct.max_links	"-1"	PHP_INI_SYSTEM	PHP_INI_ALL dans PHP <= 4.0.2. Disponible depuis PHP 4.0.2.
sybct.min_server_severity	"10"	PHP_INI_ALL	Disponible depuis PHP 4.0.2.
sybct.min_client_severity	"10"	PHP_INI_ALL	Disponible depuis PHP 4.0.2.
sybct.hostname	NULL	PHP_INI_ALL	Disponible depuis PHP 4.0.2.
sybct.deadlock_retry_count	"0"	PHP_INI_ALL	Disponible depuis PHP 4.3.0.

Voici un éclaircissement sur l'utilisation des directives de configuration.

sybct.allow_persistent booléen: Autorise ou pas les connexions persistantes Sybase-CT. Par défaut vaut On.
sybct.max_persistent entier: Le nombre maximum de connexions Sybase-CT persistantes par processus. -1 signifie illimité. C'est aussi la valeur par défaut.
sybct.max_links entier: Le nombre maximum de connexions Sybase-CT par processus, y compris les connexions persistantes. -1 signifie illimité.
sybct.min_server_severity entier: Les messages du serveur ayant une criticité supérieure ou égale à la valeur de cette option seront rapportés comme alertes. Cette valeur peut aussi être modifiée depuis les scripts en appelant la fonction sybase_min_server_severity(). Par défaut, cette option vaut 10.
sybct.min_client_severity entier: Les messages de la bibliothèque cliente ayant une criticité supérieure ou égale à la valeur de cette option seront rapportés comme alertes. Cette valeur peut aussi être modifiée depuis les scripts en appelant la fonction sybase_min_client_severity(). Par défaut, cette option vaut 10.
sybct.login_timeout entier: Le nombre maximal de secondes à attendre pour effectuer avec succès une connexion avant d'échouer. Notez que si max_execution_time est dépassé avant que ce nombre de secondes, votre script se terminera avant de pouvoir exécuter une action sur l'échec de connexion. Par défaut, ce nombre vaut une minute.
sybct.timeout entier: Le nombre maximal de secondes à ettendre pour effectuer avec succès une requête avant d'échouer. Notez que si max_execution_time est dépassé avant que ce nombre de secondes, votre script se terminera avant de pouvoir exécuter une action sur l'échec de connexion. Par défaut, aucune limite n'est fixé.
sybct.hostname chaîne de caractères: Le nom de l'hôte à partir duquel vous prétendez être connecté, afin qu'il soit affiché par sp_who. Par défaut, il n'y a pas de valeur.
sybct.deadlock_retry_count int: Permet de définir le nombre de tentatives de résolution des blocages. La valeur par défaut est -1, ou forever, c'est à dire indéfiniment.

Pour plus de détails sur les constantes PHP_INI_*, reportez-vous à Annexe G.

Types de ressources

Constantes pré-définies

Cette extension ne définit aucune constante.

Table des matières
sybase_affected_rows -- Retourne le nombre de lignes affectées par la dernière requête Sybase
sybase_close -- Ferme une connexion Sybase
sybase_connect -- Ouvre une connexion à un serveur Sybase
sybase_data_seek -- Déplace le pointeur interne de lignes Sybase
sybase_deadlock_retry_count -- Configure le nombre de tentatives lors de blocages (deadlock)
sybase_fetch_array -- Retourne une ligne Sybase sous la forme d'un tableau
sybase_fetch_assoc -- Lit une ligne de résultat Sybase sous forme de tableau associatif
sybase_fetch_field -- Lit les informations d'un champ Sybase
sybase_fetch_object -- Retourne une ligne Sybase sous la forme d'un objet
sybase_fetch_row -- Retourne une ligne Sybase sous la forme d'un tableau numérique
sybase_field_seek -- Modifie l'index d'un champ Sybase
sybase_free_result -- Libère un résultat Sybase de la mémoire
sybase_get_last_message -- Retourne le dernier message du serveur
sybase_min_client_severity -- Fixe la sévérité minimale du client Sybase
sybase_min_error_severity -- Fixe la sévérité minimale du client pour les erreurs
sybase_min_message_severity -- Fixe la sévérité minimale du client pour les messages
sybase_min_server_severity -- Fixe la sévérité minimale du client pour le serveur Sybase
sybase_num_fields -- Retourne le nombre de champs dans un résultat Sybase
sybase_num_rows -- Retourne le nombre de lignes dans un résultat Sybase
sybase_pconnect -- Ouvre une connexion persistante à un serveur Sybase
sybase_query -- Envoie une requête à une base Sybase
sybase_result -- Lit une valeur dans un résultat
sybase_select_db -- Sélectionne une base de données Sybase
sybase_set_message_handler -- Configure le gestionnaire de messages Sybase
sybase_unbuffered_query -- Envoie une requête à Sybase et ne bloque pas