sigmasternchen/php-doc-en
1
0
Fork 0
mirror of https://github.com/sigmasternchen/php-doc-en synced 2025-03-16 00:48:54 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Document new automatic file locking

Browse source 
We also restructure the notes and warnings accordingly, and move more
important info up. We also mention SQLite as alternative.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@340805 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Christoph Michael Becker 2016-10-30 17:45:43 +00:00
parent bf6242d421
commit dc32f2450a
1 changed files with 27 additions and 17 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

44
reference/dbase/book.xml
View file

@ -8,10 +8,36 @@
<!-- {{{ preface -->
<preface xml:id="intro.dbase">
&reftitle.intro;
<note>
<para>
&pecl.moved-ver;5.3.0.
</para>
</note>
<para>
These functions allow you to access records stored in dBase-format
(dbf) databases.
</para>
<warning>
<para>
We recommend against using dBase files as your production
database. Use <link xlink:href="&url.sqlite;">SQLite</link> or 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>
<caution>
<para>
As of dbase 7.0.0 the databases are automatically locked via
<function>flock</function>. There has been no support for locking earlier,
so two concurrent web server processes modifying the same dBase file would
have very likely ruined your database. This can happen even with dbase
7.0.0+ on systems which implement the locks at the process level with
multithreaded SAPIs such as ISAPI.
</para>
</caution>
<para>
dBase files are simple sequential files of fixed length records.
Records are appended to the end of the file and deleted records are
@ -89,25 +115,9 @@
</para>
<note>
<para>
&pecl.moved-ver;5.3.0.
There is no support for indexes or memo fields.
</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>
<!-- }}} -->