File: reference.xml

package info (click to toggle)
php-doc 20061001-1
  • links: PTS
  • area: non-free
  • in suites: etch, etch-m68k
  • size: 45,764 kB
  • ctags: 1,611
  • sloc: xml: 502,485; php: 7,645; cpp: 500; makefile: 297; perl: 161; sh: 141; awk: 28
file content (144 lines) | stat: -rw-r--r-- 4,254 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.8 $ -->
<!-- Purpose: database.vendors -->
<!-- Membership: bundled, external -->

 <reference id="ref.dbase">
  <title>dBase Functions</title>
  <titleabbrev>dBase</titleabbrev>

  <partintro>
   <section id="dbase.intro">
    &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 informations</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>
       </tbody>
      </tgroup>
     </table>
    </para>
    <warning>
     <para>
      There is no support for indexes or memo fields. There is no
      support for locking, too. Two concurrent webserver 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; <ulink 
      url="&url.mysql;">MySQL</ulink> or <ulink url="&url.pgsql;">Postgres</ulink>
      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>
   </section>
   
   &reference.dbase.configure;
   
   <section id="dbase.runtime">
    &reftitle.runtime;
    &no.config;
   </section>

   <section id="dbase.resources">
    &reftitle.resources;
    &no.resource;
   </section>
   
   <section id="dbase.examples">
    &reftitle.examples;
    <para>
     Many examples in this reference require a dBase database. We will use 
     <filename>/tmp/test.dbf</filename> that will be created in the example of
     <function>dbase_create</function>.
    </para>
   </section>
   
   <section id="dbase.constants">
    &reftitle.constants;
    &no.constants;
   </section>
   
  </partintro>

&reference.dbase.functions;

 </reference>
<!-- 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:"../../../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
-->