 |
|
|
Home :: International :: Manuals :: Howto :: FAQ :: Man Pages :: Email Login |
XLV. InterBase関数
導入
InterBaseはBorland/Inpriseが開発した有名なデータベースです。 InterBaseに関する詳細な情報は、 http://www.interbase.com/から得ることができます。 ところで、InterBaseはオープンソース運動に加わりました！
インストール手順
PHPでInterBaseサポートを有効にするには、 --with-interbase[=DIR]を指定して設 定を行います。ただし、DIRはInterBaseのベースインストールディレクトリ で、デフォルトは/usr/interbaseです。
Win32ユーザへの注意: このモジュールをWindows環境で有効にするには、 gds32.dllをPHP/Win32バイナリパッケージのDLLフォ ルダから使用するWindowsマシンのSYSTEM32フォルダ(例: C:\WINNT\SYSTEM32 またはC:\WINDOWS\SYSTEM32)にコピーする必要があります。 InterBaseデータベースサーバをPHPを実行しているのと同じマシンにイン ストールしている場合、このDLLはすでにあるはずです。この場合、 DLLフォルダからgds32.dllをコピーする必要はあり ません。
実行用の設定
これらの関数の動作は、php.iniの設定により変化します。
表 1. InterBase設定オプション
| 名前 | デフォルト | 変更の可否 |
|---|---|---|
| ibase.allow_persistent | "1" | PHP_INI_SYSTEM |
| ibase.max_persistent | "-1" | PHP_INI_SYSTEM |
| ibase.max_links | "-1" | PHP_INI_SYSTEM |
| ibase.default_user | NULL | PHP_INI_ALL |
| ibase.default_password | NULL | PHP_INI_ALL |
| ibase.timestampformat | "%m/%d/%Y%H:%M:%S" | PHP_INI_ALL |
| ibase.dateformat | "%m/%d/%Y" | PHP_INI_ALL |
| ibase.timeformat | "%H:%M:%S" | PHP_INI_ALL |
定義済みの定数
これらの定数は、この拡張モジュールで定義されており、 この拡張モジュールがPHP内部にコンパイルされているか実行時に動的にロー ドされるかのどちらかの場合のみ使用可能です。
The following constants can be passed to ibase_trans() to specify transaction behaviour.
表 2. Firebird/InterBase transaction flags
| Constant | Description |
|---|---|
| IBASE_DEFAULT | The default transaction settings are to be used. This default is determined by the client library, which defines it as IBASE_WRITE|IBASE_CONCURRENCY|IBASE_WAIT in most cases. |
| IBASE_READ | Starts a read-only transaction. |
| IBASE_WRITE | Starts a read-write transaction. |
| IBASE_CONSISTENCY | Starts a transaction with the isolation level set to 'consistency', which means the transaction cannot read from tables that are being modified by other concurrent transactions. |
| IBASE_CONCURRENCY | Starts a transaction with the isolation level set to 'concurrency' (or 'snapshot'), which means the transaction has access to all tables, but cannot see changes that were committed by other transactions after the transaction was started. |
| IBASE_COMMITTED | Starts a transaction with the isolation level set to 'read committed'. This flag should be combined with either IBASE_REC_VERSION or IBASE_REC_NO_VERSION. This isolation level allows access to changes that were committed after the transaction was started. If IBASE_REC_NO_VERSION was specified, only the latest version of a row can be read. If IBASE_REC_VERSION was specified, a row can even be read when a modification to it is pending in a concurrent transaction. |
| IBASE_WAIT | Indicated that a transaction should wait and retry when a conflict occurs. |
| IBASE_NOWAIT | Indicated that a transaction should fail immediately when a conflict occurs. |
The following constants can be passed to ibase_fetch_row(), ibase_fetch_assoc() or ibase_fetch_object() to specify fetch behaviour.
表 3. Firebird/InterBase fetch flags
| Constant | Description |
|---|---|
| IBASE_FETCH_BLOBS | Also available as IBASE_TEXTfor backward compatibility. Causes BLOB contents to be fetched inline, instead of being fetched as BLOB identifiers. |
| IBASE_FETCH_ARRAYS | Causes arrays to be fetched inline. Otherwise, array identifiers are returned. Array identifiers can only be used as arguments to INSERT operations, as no functions to handle array identifiers are currently available. |
| IBASE_UNIXTIME | Causes date and time fields not to be returned as strings, but as UNIX timestamps (the number of seconds since the epoch, which is 1-Jan-1970 0:00 UTC). Might be problematic if used with dates before 1970 on some systems. |
The following constants are used to pass requests and options to the service API functions (ibase_server_info(), ibase_db_info (), ibase_backup(), ibase_restore () and ibase_maintain_db()). Please refer to the Firebird/InterBase manuals for the meaning of these options.
- IBASE_BKP_IGNORE_CHECKSUMS
- IBASE_BKP_IGNORE_LIMBO
- IBASE_BKP_METADATA_ONLY
- IBASE_BKP_NO_GARBAGE_COLLECT
- IBASE_BKP_OLD_DESCRIPTIONS
- IBASE_BKP_NON_TRANSPORTABLE
- IBASE_BKP_CONVERT
Options to ibase_backup()()
- IBASE_RES_DEACTIVATE_IDX
- IBASE_RES_NO_SHADOW
- IBASE_RES_NO_VALIDITY
- IBASE_RES_ONE_AT_A_TIME
- IBASE_RES_REPLACE
- IBASE_RES_CREATE
- IBASE_RES_USE_ALL_SPACE
Options to ibase_restore()
- IBASE_PRP_PAGE_BUFFERS
- IBASE_PRP_SWEEP_INTERVAL
- IBASE_PRP_SHUTDOWN_DB
- IBASE_PRP_DENY_NEW_TRANSACTIONS
- IBASE_PRP_DENY_NEW_ATTACHMENTS
- IBASE_PRP_RESERVE_SPACE
- IBASE_PRP_RES_USE_FULL
- IBASE_PRP_RES
- IBASE_PRP_WRITE_MODE
- IBASE_PRP_WM_ASYNC
- IBASE_PRP_WM_SYNC
- IBASE_PRP_ACCESS_MODE
- IBASE_PRP_AM_READONLY
- IBASE_PRP_AM_READWRITE
- IBASE_PRP_SET_SQL_DIALECT
- IBASE_PRP_ACTIVATE
- IBASE_PRP_DB_ONLINE
- IBASE_RPR_CHECK_DB
- IBASE_RPR_IGNORE_CHECKSUM
- IBASE_RPR_KILL_SHADOWS
- IBASE_RPR_MEND_DB
- IBASE_RPR_VALIDATE_DB
- IBASE_RPR_FULL
- IBASE_RPR_SWEEP_DB
Options to ibase_maintain_db()
- IBASE_STS_DATA_PAGES
- IBASE_STS_DB_LOG
- IBASE_STS_HDR_PAGES
- IBASE_STS_IDX_PAGES
- IBASE_STS_SYS_RELATIONS
Options to ibase_db_info()
- IBASE_SVC_SERVER_VERSION
- IBASE_SVC_IMPLEMENTATION
- IBASE_SVC_GET_ENV
- IBASE_SVC_GET_ENV_LOCK
- IBASE_SVC_GET_ENV_MSG
- IBASE_SVC_USER_DBPATH
- IBASE_SVC_SVR_DB_INFO
- IBASE_SVC_GET_USERS
Options to ibase_server_info()
- 目次
- ibase_add_user -- Add a user to a security database (only for IB6 or later)
- ibase_affected_rows -- Return the number of rows that were affected by the previous query
- ibase_backup -- Initiates a backup task in the service manager and returns immediately
- ibase_blob_add -- 生成されたblobにデータを追加する
- ibase_blob_cancel -- blobの生成を取り消す
- ibase_blob_close -- blobを閉じる
- ibase_blob_create -- データを追加するためにblobを生成する
- ibase_blob_echo -- ブラウザにblobの内容を出力する
- ibase_blob_get -- オープンしたblobからデータのバイト数を取得する
- ibase_blob_import -- blobを生成し、ファイルをコピーし、閉じる
- ibase_blob_info -- blobの長さと他の便利な情報を返す
- ibase_blob_open -- データの一部を取得するためにblobをオープンする
- ibase_close -- InterBaseデータベースへの接続を閉じる
- ibase_commit_ret -- Commit a transaction without closing it
- ibase_commit -- トランザクションをコミットする
- ibase_connect -- InterBaseデータベースへの接続をオープンする
- ibase_db_info -- Request statistics about a database
- ibase_delete_user -- Delete a user from a security database (only for IB6 or later)
- ibase_drop_db -- Drops a database
- ibase_errcode -- Return an error code
- ibase_errmsg -- エラーメッセージを返す
- ibase_execute -- 準備されたクエリを実行する
- ibase_fetch_assoc -- Fetch a result row from a query as an associative array
- ibase_fetch_object -- InterBaseデータベースからオブジェクトを得る
- ibase_fetch_row -- InterBaseデータベースから1行分の結果を取得する
- ibase_field_info -- フィールドに関する情報を得る
- ibase_free_event_handler -- Cancels a registered event handler
- ibase_free_query -- 準備されたクエリにより確保されたメモリを解放する
- ibase_free_result -- 結果セットを解放する
- ibase_gen_id -- Increments the named generator and returns its new value
- ibase_maintain_db -- Execute a maintenance command on the database server
- ibase_modify_user -- Modify a user to a security database (only for IB6 or later)
- ibase_name_result -- Assigns a name to a result set
- ibase_num_fields -- 結果セットにおけるフィールド数を得る
- ibase_num_params -- Return the number of parameters in a prepared query
- ibase_param_info -- Return information about a parameter in a prepared query
- ibase_pconnect -- InterBaseデータベースへの持続的接続をオープンする
- ibase_prepare -- 後でパラメータのバインド及び実行するためにクエリを準備する
- ibase_query -- InterBaseデータベースでクエリを実行する
- ibase_restore -- Initiates a restore task in the service manager and returns immediately
- ibase_rollback_ret -- Roll back a transaction without closing it
- ibase_rollback -- トランザクションをロールバックする
- ibase_server_info -- Request information about a database server
- ibase_service_attach -- Connect to the service manager
- ibase_service_detach -- Disconnect from the service manager
- ibase_set_event_handler -- Register a callback function to be called when events are posted
- ibase_timefmt -- クエリーから返されるtimestamp、data、time型カラムのフォーマットを設定する
- ibase_trans -- トランザクションを開始する
- ibase_wait_event -- Wait for an event to be posted by the database