# dbase_create

(PHP 5 < 5.3.0, dbase 5, dbase 7)

dbase_create — Creates a database

### 说明

dbase_create ( string `$filename` , array `$fields` [, int `$type` = DBASE_TYPE_DBASE ] ) : resource

dbase_create() creates a dBase database with the given definition. If the file already exists, it is not truncated. dbase_pack() can be called to force truncation.

> Note: 当启用 安全模式时， PHP 会检查被操作的文件或目录是否与被执行的脚本有相同的 UID（所有者）。

> Note:

> 此函数受 open_basedir 影响。

### 参数

`filename`

  The name of the database. It can be a relative or absolute path to the file where dBase will store your data.

`fields`

  An array of arrays, each array describing the format of one field of the database. Each field consists of a name, a character indicating the field type, and optionally, a length, a precision and a nullable flag. The supported field types are listed in the introduction section.

  > Note:

  > The fieldnames are limited in length and must not exceed 10 chars.

`type`

  The type of database to be created. Either `DBASE_TYPE_DBASE` or `DBASE_TYPE_FOXPRO`.

### 返回值

Returns a database link identifier if the database is successfully created, or `FALSE` if an error occurred.

### 更新日志

版本 | 说明
--- | ---
dbase 7.0.0 | The `type` parameter has been added.
dbase 7.0.0 | The return value is now a resource instead of an int.

### 范例

Example #1 Creating a dBase database file

    <?php

    // database "definition"
    $def = array(
      array("date",     "D"),
      array("name",     "C",  50),
      array("age",      "N",   3, 0),
      array("email",    "C", 128),
      array("ismember", "L")
    );

    // creation
    if (!dbase_create('/tmp/test.dbf', $def)) {
      echo "Error, can't create the database\n";
    }

    ?>

### 参见

- dbase_open() - Opens a database
- dbase_close() - Closes a database