CXXIII. Sybase

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

NomPar défautModifiable
sybase.allow_persistent"On"PHP_INI_SYSTEM
sybase.max_persistent"-1"PHP_INI_SYSTEM
sybase.max_links"-1"PHP_INI_SYSTEM
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"Off"PHP_INI_SYSTEM
magic_quotes_sybase"Off"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

NomPar défautModifiable
sybct.allow_persistent"On"PHP_INI_SYSTEM
sybct.max_persistent"-1"PHP_INI_SYSTEM
sybct.max_links"-1"PHP_INI_SYSTEM
sybct.min_server_severity"10"PHP_INI_ALL
sybct.min_client_severity"10"PHP_INI_ALL
sybct.hostnameNULLPHP_INI_ALL
sybct.deadlock_retry_count"-1"PHP_INI_ALL

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

sybct.allow_persistent booléen

Whether to allow persistent Sybase-CT connections. The default is 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 à ini_set().

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 message Sybase
sybase_unbuffered_query -- Envoie une requête à Sybase et ne bloque pas