XXVIII. FrontBase

Introduction

Ces fonctions vous permettent d'accéder aux serveurs SQL FrontBase. Plus de détails sur le serveur FrontBase est disponible 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 librairies clientes fbsql, pour accéder à ces fonctions. Vous pouvez accéder au site de FrontBase à l'adresse http://www.frontbase.com/.

Installation

In order to have these functions available, you must compile PHP with fbsql support by using the --with-fbsql[=DIR] option. If you use this option without specifying the path to fbsql, PHP will search for the fbsql client libraries in the default installation location for the platform. Users who installed FrontBase in a non standard directory should always specify the path to fbsql: --with-fbsql=/path/to/fbsql. This will force PHP to use the client libraries installed by FrontBase, avoiding any conflicts.

Configuration à l'exécution

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

Tableau 1. FrontBase configuration options

NameDefaultChangeable
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
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.

FBSQL_ASSOC (integer)

FBSQL_NUM (integer)

FBSQL_BOTH (integer)

FBSQL_LOCK_DEFERRED (integer)

FBSQL_LOCK_OPTIMISTIC (integer)

FBSQL_LOCK_PESSIMISTIC (integer)

FBSQL_ISO_READ_UNCOMMITTED (integer)

FBSQL_ISO_READ_COMMITTED (integer)

FBSQL_ISO_REPEATABLE_READ (integer)

FBSQL_ISO_SERIALIZABLE (integer)

FBSQL_ISO_VERSIONED (integer)

FBSQL_UNKNOWN (integer)

FBSQL_STOPPED (integer)

FBSQL_STARTING (integer)

FBSQL_RUNNING (integer)

FBSQL_STOPPING (integer)

FBSQL_NOEXEC (integer)

FBSQL_LOB_DIRECT (integer)

FBSQL_LOB_HANDLE (integer)

Table des matières
fbsql_affected_rows --  Lit le nombre de ligne affectées par la dernière requête
fbsql_autocommit -- Active ou désactive la validation automatique
fbsql_change_user --  Change le nom d'utilisateur de la session active
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é à une colonne de résultat
fbsql_field_len --  Retourne la taille d'un champs
fbsql_field_name --  Lit le nom d'un champs
fbsql_field_seek --  Déplace le pointeur de résultat
fbsql_field_table --  Lit le nom de la table d'origine d'un champs
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_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 champs
fbsql_username -- Lit ou définit le nom de login à utiliser avec une connexion
fbsql_warnings -- Active ou désactive les alertes FrontBase