Php/docs/function.fbsql-db-status

• PHP Manual
• FrontBase 関数
• 指定したデータベースの状態を取得する

fbsql_db_status

(PHP 4 >= 4.0.7, PHP 5 < 5.3.0)

fbsql_db_status — 指定したデータベースの状態を取得する

説明

fbsql_db_status ( string $database_name [, resource $link_identifier ] ) : int

指定したデータベースの現在の状態を取得します。

パラメータ

database_name

データベース名。

link_identifier

fbsql_connect() あるいは fbsql_pconnect() が返す FrontBase リンク ID。

指定しなかった場合は、この関数は FrontBase サーバーでオープンしているリンクを探します。見つからないときは fbsql_connect() に引数を指定せずにコールしたときと同様にして作成します。

返り値

現在の状態を表す整数値を返します。これは、以下の定数のいずれかです。

• false - host の exec ハンドラが無効です。このエラーは、 link_identifier がポート番号を用いてデータベースへ直接接続する場合に発生します。 FBExec はサーバーで利用可能ですが、接続が行われていません。
• FBSQL_UNKNOWN - 状態は不明です。
• FBSQL_STOPPED - FBSQL_STOPPED - データベースは実行されていません。 データベースを開始するには、fbsql_start_db() を使用してください。
• FBSQL_STARTING - データベースは起動中です。
• FBSQL_RUNNING - データベースは実行中で、SQL 処理を実行可能です。
• FBSQL_STOPPING - データベースは停止中です。
• FBSQL_NOEXEC - FBExec がサーバーで実行されておらず、 データベースの状態を取得することはできません。

参考

• fbsql_start_db() - ローカルまたはリモートサーバーのデータベースを開始する
• fbsql_stop_db() - ローカルまたはリモートサーバーのデータベースを停止する