# fbsql_db_status

(PHP 4 >= 4.0.7, PHP 5, PHP 7)

fbsql_db_status — Get the status for a given database

### 说明

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

Gets the current status of the specified database.

### 参数

`database_name`

  The database name.

`link_identifier`

  由 fbsql_connect() 或 fbsql_pconnect() 返回的 FrontBase 链接标识符.

  如可选并未指定，函数会尝试查找一个到 FrontBase 服务器的开放链接，且如没有找到这样的链接，会尝试通过不带参数调用 fbsql_connect() 来创建一个。

### 返回值

Returns an integer value with the current status. This can be one of the following constants:

- `FALSE` - The exec handler for the host was invalid. This error will occur when the `link_identifier` connects directly to a database by using a port number. FBExec can be available on the server but no connection has been made for it.
- `FBSQL_UNKNOWN` - The Status is unknown.
- `FBSQL_STOPPED` - The database is not running. Use fbsql_start_db() to start the database.
- `FBSQL_STARTING` - The database is starting.
- `FBSQL_RUNNING` - The database is running and can be used to perform SQL operations.
- `FBSQL_STOPPING` - The database is stopping.
- `FBSQL_NOEXEC` - FBExec is not running on the server and it is not possible to get the status of the database.

### 参见

- fbsql_start_db() - Start a database on local or remote server
- fbsql_stop_db() - Stop a database on local or remote server