php-doc-en/reference/dbase/book.xml
Torben Wilson af4410a7e1 Normalized the sgml-default-dtd-file local-variable line for those
still using this, after discussion on the phpdoc list.
From now on, manual.ced will need to be found at ~/.phpdoc/manual.ced.



git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@288721 c90b9560-bf6c-de11-be94-00142212c4b1
2009-09-25 07:04:39 +00:00

130 lines
3.8 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- Purpose: database.vendors -->
<!-- Membership: bundled, external -->
<book xml:id="book.dbase" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>dBase</title>
<!-- {{{ preface -->
<preface xml:id="intro.dbase">
&reftitle.intro;
<para>
These functions allow you to access records stored in dBase-format
(dbf) databases.
</para>
<para>
dBase files are simple sequential files of fixed length records.
Records are appended to the end of the file and delete records are
kept until you call <function>dbase_pack</function>.
</para>
<para>
The types of dBase fields available are:
<table>
<title>Available types of fields</title>
<tgroup cols="3">
<thead>
<row>
<entry>Field</entry>
<entry>dBase Type</entry>
<entry>Format</entry>
<entry>Additional information</entry>
</row>
</thead>
<tbody>
<row>
<entry><literal>M</literal></entry>
<entry>Memo</entry>
<entry>n/a</entry>
<entry>This type is not supported by PHP, such field will be ignored</entry>
</row>
<row>
<entry><literal>D</literal></entry>
<entry>Date</entry>
<entry><literal>YYYYMMDD</literal></entry>
<entry>The field length is limited to 8</entry>
</row>
<row>
<entry><literal>N</literal></entry>
<entry>Number</entry>
<entry>A number</entry>
<entry>
You must declare a length and a precision (the number of digits
after the decimal point)
</entry>
</row>
<row>
<entry><literal>C</literal></entry>
<entry>String</entry>
<entry>A string</entry>
<entry>You must declare a length. When retrieving data, the string
will be right-padded with spaces to fit the declared length.</entry>
</row>
<row>
<entry><literal>L</literal></entry>
<entry>Boolean</entry>
<entry><literal>T</literal> or <literal>Y</literal> for &true;,
<literal>F</literal> or <literal>N</literal> for &false;</entry>
<entry>Stored and returned as an integer (1 or 0)</entry>
</row>
<row>
<entry><literal>F</literal></entry>
<entry>Float</entry>
<entry>A float number</entry>
<entry>Support for this type of field was added in PHP 5.2.0</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
<note>
<para>
&pecl.moved-ver;5.3.0.
</para>
</note>
<warning>
<para>
There is no support for indexes or memo fields. There is no
support for locking, too. Two concurrent web server processes
modifying the same dBase file will very likely ruin your database.
</para>
<para>
We recommend that you do not use dBase files as your production
database. Choose any real SQL server instead; <link
xlink:href="&url.mysql;">MySQL</link> or <link xlink:href="&url.pgsql;">Postgres</link>
are common choices with PHP. dBase support is here to allow you to
import and export data to and from your web database, because the
file format is commonly understood by Windows spreadsheets and
organizers.
</para>
</warning>
</preface>
<!-- }}} -->
&reference.dbase.setup;
&reference.dbase.constants;
&reference.dbase.reference;
</book>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->