dbase_create

Creates a database

Description

resource dbase_create ( string $filename , array $fields , int $type = DBASE_TYPE_DBASE )

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: When safe mode is enabled, PHP checks whether the files or directories being operated upon have the same UID (owner) as the script that is being executed.

Note:

This function is affected by open_basedir.

Parameters

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.

Note:

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

Return Values

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

Changelog

Version Description
dbase 7.0.0 The return value is now a resource instead of an int.

Examples

Example #1 Creating a dBase database file

<?php

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

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

?>

See Also

  • dbase_open
  • dbase_close