XXIX. FrontBase Functions

Introduzione

Queste funzioni permettono di accedere ai servers del database FrontBase. Maggiori informazioni su FrontBase: http://www.frontbase.com/.

Documentazione su FrontBase : http://www.frontbase.com/cgi-bin/WebObjects/FrontBase.woa/wa/productsPage?currentPage=Documentation.

Il supporto Frontbase è stato aggiunto dal PHP 4.0.6.

Requisiti

Per potere utilizzare queste funzioni occorre installare o il server FrontBase o, al limite, le librerie fbsql client. Si può ottenere FrontBase da http://www.frontbase.com/.

Installazione

Affinché queste funzioni siano disponibili è necessario compilare php con il supporto fbsql usando l' opzione --with-fbsql[=DIR].Se si usa questa opzione senza specificare il percorso a fbsql, php cercherà le librerie client di fbsql nella cartella di default specificata nell'istallazione di FrontBase, a seconda del sistema operativo. Se si installa FrontBase in una cartella non standard è necessario specificare sempre il percorso a fbsql: --with-fbsql=/path/to/fbsql. In questo modo si forzerà php ad usare le librerie client installate da FrontBase, evitando ogni conflitto.

Configurazione di Runtime

Il comportamento di queste funzioni è influenzato dalle impostazioni di php.ini.

Tabella 1. Opzioni di configurazione per FrontBase

NomeDefaultModificabile
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
Per maggiori dettagli e per le definizioni delle costanti PHP_INI_* vedere ini_set().

Costanti predefinite

Queste costanti sono definite da questa estensione e sono disponibili solo se l'estensione è stata compilata nel PHP o se è stata caricata dinamicamente a runtime.

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)

Sommario
fbsql_affected_rows --  Restituisce il numero di righe (tuple) interessate nella precedente operazione di FrontBase
fbsql_autocommit -- Abilita o disabilita autocommit
fbsql_blob_size --  Get the size of a BLOB
fbsql_change_user -- Cambia l'identità dell'utente connesso con una connessione attiva
fbsql_clob_size --  Get the size of a CLOB
fbsql_close -- Chiude la connessione a FrontBase
fbsql_commit -- Compie una transazione
fbsql_connect -- Apre una connessione al Server FrontBase
fbsql_create_blob -- Crea un BLOB
fbsql_create_clob -- Crea un CLOB
fbsql_create_db -- Crea un database
fbsql_data_seek -- Sposta il puntatore del risultato interno
fbsql_database_password --  Imposta o ricerca la password di un database FrontBase.
fbsql_database -- Imposta oppure ottiene il nome del database usato per la connessione
fbsql_db_query -- Manda una query FrontBase
fbsql_db_status -- Restituisce lo stato di un dato database.
fbsql_drop_db -- Cancella un database FrontBase
fbsql_errno --  Ritorna il valore numerico del messaggio di errore emesso dalla precedente operazione FrontBase.
fbsql_error --  Ritorna il testo del messaggio di errore emesso dalla precedente operazione FrontBase.
fbsql_fetch_array --  Restituisce una riga (tupla) di risultato in forma di Array associativo, Array enumerato o entrambi
fbsql_fetch_assoc --  Restituisce una riga (tupla) di risultato in forma di Array associativo.
fbsql_fetch_field --  Ottiene informazioni su una colonna da un set di risultati come oggetto
fbsql_fetch_lengths --  Ottiene la lunghezza di ciascun output in un set di risultati
fbsql_fetch_object -- Resituisce un riga da un set di risultati come oggetto
fbsql_fetch_row -- Ottiene una riga come matrice numerata
fbsql_field_flags --  Ottiene i flag associati al campo specificato
fbsql_field_len --  Restituisce la lunghezza di un campo
fbsql_field_name --  Restituisce il nome del campo specificato
fbsql_field_seek --  Imposta il puntatore del set di risultati ad un specifico indice di campo
fbsql_field_table --  Ottiene il nome della tabella in cui si trova il campo
fbsql_field_type --  Ottiene il tipo del campo specificato
fbsql_free_result -- Libera la memoria da un set di risultati
fbsql_get_autostart_info -- Nessuna descrizione fornita, per ora
fbsql_hostname -- Ottiene o imposta il nome del server per la connessione
fbsql_insert_id --  restituisce l'id generato dalla precedente operazione di INSERT
fbsql_list_dbs --  Elenca i database presenti su un server FrontBase
fbsql_list_fields -- Elenca i campi di un set di risultati
fbsql_list_tables -- Elenxa le tabelle presenti in un database FrontBase
fbsql_next_result --  Muove il puntatore interno al risultato successivo
fbsql_num_fields -- Ottiene il numero dei campi presenti in un set di risultati
fbsql_num_rows -- Restituisce il numero di righe presenti in un set di risultati
fbsql_password -- Ottiene o imposta la password per la connessione
fbsql_pconnect --  Apre una connessione persistente ad un server FrontBase
fbsql_query -- Invia una query a FrontBase
fbsql_read_blob -- Legge un BLOB dal database
fbsql_read_clob -- Legge un CLOB dal database
fbsql_result -- Restituisce i dati di una query
fbsql_rollback -- Esegue il rollback della transazione
fbsql_select_db -- Seleziona un database FrontBase
fbsql_set_lob_mode --  Imposta la modalità LOB in un set di risultati FrontBase
fbsql_set_password --  Change the password for a given user
fbsql_set_transaction --  Imposta i lock e l'isolamento delle transazioni
fbsql_start_db -- Attiva un database locale o remoto
fbsql_stop_db -- Ferma un database locale o remoto
fbsql_tablename -- Restituisce il nome della tabella dei campi
fbsql_username -- Ottiene o imposta l'utente per la connessione
fbsql_warnings -- Abilita o disabilita i warnings FrontBase