XXXIV. FrontBase

Introduction

Ces fonctions vous permettent d'accéder aux serveurs SQL FrontBase. Plus de détails sur le serveur FrontBase sont disponibles sur le site de http://www.frontbase.com/.

La documentation complète de FrontBase est disponible à http://www.frontbase.com/cgi-bin/WebObjects/FrontBase.woa/wa/productsPage?currentPage=Documentation.

Frontbase est supporté depuis PHP 4.0.6.

Pré-requis

Vous devez installer un serveur de bases de données FrontBase ou, tout au moins, les bibliothèques clientes fbsql, pour accéder à ces fonctions. Vous pouvez accéder au site de FrontBase à l'adresse http://www.frontbase.com/.

Installation

Pour pouvoir utiliser ces fonctions, vous devez compiler PHP avec le support fbsql en utilisant l'option de configuration --with-fbsql. Si vous utilisez cette option sans spécifier le chemin jusqu'au dossier d'installation fbsql, PHP recherchera les bibliothèques du client fbsql dans les dossiers habituels, sur votre système. Les utilisateurs qui ont installé FrontBase dans un dossier non standard doivent spécifier le chemin comme ceci : --with-fbsql=/path/to/fbsql. Cela va indiquer à PHP le bon emplacement des bibliothèques de FrontBase, et éviter les conflits.

Configuration à l'exécution

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

Tableau 1. Options de configuration

NomPar défautModifiable
fbsql.allow_persistent"1"PHP_INI_SYSTEM
fbsql.generate_warnings"0"PHP_INI_SYSTEM
fbsql.autocommit"1"PHP_INI_SYSTEM
fbsql.max_persistent"-1"PHP_INI_SYSTEM
fbsql.max_links"128"PHP_INI_SYSTEM
fbsql.max_connections"128"PHP_INI_SYSTEM
fbsql.max_results"128"PHP_INI_SYSTEM
fbsql.batchSize"1000"PHP_INI_SYSTEM
fbsql.default_hostNULLPHP_INI_SYSTEM
fbsql.default_user"_SYSTEM"PHP_INI_SYSTEM
fbsql.default_password""PHP_INI_SYSTEM
fbsql.default_database""PHP_INI_SYSTEM
fbsql.default_database_password""PHP_INI_SYSTEM
Pour plus de détails sur les constantes PHP_INI_*, reportez-vous à ini_set().

Constantes pré-définies

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.

FBSQL_ASSOC (entier)

FBSQL_NUM (entier)

FBSQL_BOTH (entier)

FBSQL_LOCK_DEFERRED (entier)

FBSQL_LOCK_OPTIMISTIC (entier)

FBSQL_LOCK_PESSIMISTIC (entier)

FBSQL_ISO_READ_UNCOMMITTED (entier)

FBSQL_ISO_READ_COMMITTED (entier)

FBSQL_ISO_REPEATABLE_READ (entier)

FBSQL_ISO_SERIALIZABLE (entier)

FBSQL_ISO_VERSIONED (entier)

FBSQL_UNKNOWN (entier)

FBSQL_STOPPED (entier)

FBSQL_STARTING (entier)

FBSQL_RUNNING (entier)

FBSQL_STOPPING (entier)

FBSQL_NOEXEC (entier)

FBSQL_LOB_DIRECT (entier)

FBSQL_LOB_HANDLE (entier)

Table des matières
fbsql_affected_rows --  Lit le nombre de lignes affectées par la dernière requête
fbsql_autocommit -- Active ou désactive la validation automatique
fbsql_blob_size --  Retourne la taille d'un BLOB
fbsql_change_user --  Change le nom d'utilisateur de la session active
fbsql_clob_size --  Retourne la taille d'un CLOB
fbsql_close -- Ferme la connexion FrontBase
fbsql_commit -- Valide une transaction
fbsql_connect -- Ouvre une connexion à un serveur FrontBase
fbsql_create_blob -- Crée un BLOB
fbsql_create_clob -- Crée un CLOB
fbsql_create_db -- Crée une base de données
fbsql_data_seek -- Déplace le pointeur interne de résultat FBSQL
fbsql_database_password --  Modifie/lit le mot de passe dans une base FBSQL
fbsql_database -- Lit ou définit le nom de la base de données utilisée avec une connexion
fbsql_db_query -- Envoie une requête à la base FrontBase
fbsql_db_status -- Lit le statut courant d'une base de données
fbsql_drop_db -- Supprime une base de données FrontBase
fbsql_errno -- Retourne le code d'erreur FrontBase
fbsql_error -- Retourne le message d'erreur FrontBase
fbsql_fetch_array -- Lit toute une ligne de résultat dans un tableau
fbsql_fetch_assoc --  Lit toute une ligne de résultat dans un tableau associatif
fbsql_fetch_field --  Lit des informations sur une colonne dans un résultat, et retourne un objet
fbsql_fetch_lengths --  Lit la taille de chaque colonne d'un résultat
fbsql_fetch_object -- Lit une ligne de résultat sous forme d'objet
fbsql_fetch_row -- Lit une ligne de résultat sous forme de tableau numérique
fbsql_field_flags --  Lit les options associées à une colonne de résultat
fbsql_field_len --  Retourne la taille d'un champ
fbsql_field_name -- Lit le nom d'un champ
fbsql_field_seek --  Déplace le pointeur de résultat
fbsql_field_table --  Lit le nom de la table d'origine d'un champ
fbsql_field_type --  Lit le type d'une colonne
fbsql_free_result -- Libère le résultat de la mémoire
fbsql_get_autostart_info -- Pas de documentation
fbsql_hostname -- Lit ou définit le nom de l'hôte à utiliser avec une connexion
fbsql_insert_id --  Lit le dernier identifiant généré par une requête INSERT
fbsql_list_dbs --  Liste les bases de données FBSQL
fbsql_list_fields -- Liste les champs d'un résultat FrontBase
fbsql_list_tables -- Liste les tables dans une base de données FrontBase
fbsql_next_result -- Déplace le pointeur interne vers le résultat suivant
fbsql_num_fields -- Lit le nombre de champs dans un résultat
fbsql_num_rows -- Lit le nombre de lignes dans un résultat
fbsql_password -- Lit ou définit le mot de passe à utiliser avec une connexion
fbsql_pconnect --  Ouvre une connexion persistante à un serveur FrontBase
fbsql_query -- Exécute une requête sur un serveur FrontBase
fbsql_read_blob -- Lit un BLOB dans une base de données
fbsql_read_clob -- Lit un CLOB dans une base de données
fbsql_result -- Lit des données dans un résultat
fbsql_rollback -- Annule une transaction FBSQL
fbsql_select_db -- Sélectionne une base de données FrontBase
fbsql_set_lob_mode --  Modifie le mode de lecture des LOB
fbsql_set_password --  Change le mot de passe de l'utilisateur spécifié
fbsql_set_transaction --  Configure le verrouillage et l'isolation de transactions
fbsql_start_db -- Démarre une base de données FBSQL
fbsql_stop_db -- Stoppe une base de données FBSQL
fbsql_tablename -- Lit le nom de la table d'un champ
fbsql_username -- Lit ou définit le nom de login à utiliser avec une connexion
fbsql_warnings -- Active ou désactive les alertes FrontBase