XLV. 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
| Nom | Par défaut | Modifiable | Historique |
|---|---|---|---|
| fbsql.allow_persistent | "1" | PHP_INI_SYSTEM | Disponible depuis PHP 4.2.0. |
| fbsql.generate_warnings | "0" | PHP_INI_SYSTEM | Disponible depuis PHP 4.0.6. |
| fbsql.autocommit | "1" | PHP_INI_SYSTEM | Disponible depuis PHP 4.0.6. |
| fbsql.max_persistent | "-1" | PHP_INI_SYSTEM | Disponible depuis PHP 4.0.6. |
| fbsql.max_links | "128" | PHP_INI_SYSTEM | Disponible depuis PHP 4.0.6. |
| fbsql.max_connections | "128" | PHP_INI_SYSTEM | Disponible depuis PHP 4.0.6. |
| fbsql.max_results | "128" | PHP_INI_SYSTEM | Disponible depuis PHP 4.0.6. |
| fbsql.batchSize | "1000" | PHP_INI_SYSTEM | |
| fbsql.default_host | NULL | PHP_INI_SYSTEM | Disponible depuis PHP 4.0.6. |
| fbsql.default_user | "_SYSTEM" | PHP_INI_SYSTEM | Disponible depuis PHP 4.0.6. |
| fbsql.default_password | "" | PHP_INI_SYSTEM | Disponible depuis PHP 4.0.6. |
| fbsql.default_database | "" | PHP_INI_SYSTEM | Disponible depuis PHP 4.0.6. |
| fbsql.default_database_password | "" | PHP_INI_SYSTEM | Disponible depuis PHP 4.0.6. |
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
