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
|
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<title>Using Berkeley DB with PHP</title>
<link rel="stylesheet" href="gettingStarted.css" type="text/css" />
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2" />
<link rel="start" href="index.html" title="Berkeley DB Programmer's Reference Guide" />
<link rel="up" href="ext.html" title="Chapter 21. Berkeley DB Extensions" />
<link rel="prev" href="ext_perl.html" title="Using Berkeley DB with Perl" />
<link rel="next" href="dumpload.html" title="Chapter 22. Dumping and Reloading Databases" />
</head>
<body>
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr>
<th colspan="3" align="center">Using Berkeley DB with PHP</th>
</tr>
<tr>
<td width="20%" align="left"><a accesskey="p" href="ext_perl.html">Prev</a> </td>
<th width="60%" align="center">Chapter 21.
Berkeley DB Extensions
</th>
<td width="20%" align="right"> <a accesskey="n" href="dumpload.html">Next</a></td>
</tr>
</table>
<hr />
</div>
<div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a id="ext_php"></a>Using Berkeley DB with PHP</h2>
</div>
</div>
</div>
<p>A PHP 4 extension for this release of Berkeley DB is included in the
distribution package. It can either either link directly against the
installed Berkeley DB library (which is necessary for running in a
non-Apache/mod_php4 environment), or against mod_db4, which provides
additional safety when running under Apache/mod_php4.</p>
<p>The PHP extension provides the following classes, which mirror the
standard Berkeley DB C++ API.</p>
<pre class="programlisting">class Db4Env {
function Db4Env($flags = 0) {}
function close($flags = 0) {}
function dbremove($txn, $filename, $database = null, $flags = 0) {}
function dbrename($txn, $file, $database, $new_database, $flags = 0) {}
function open($home, $flags = DB_CREATE | DB_INIT_LOCK | DB_INIT_LOG | DB_INIT_MPOOL | DB_INIT_TXN, $mode = 0666) {}
function remove($home, $flags = 0) {}
function set_data_dir($directory) {}
function txn_begin($parent_txn = null, $flags = 0) {}
function txn_checkpoint($kbytes, $minutes, $flags = 0) {}
}
class Db4 {
function Db4($dbenv = null) {} // create a new Db4 object using the optional DbEnv
function open($txn = null, $file = null, $database = null, $flags = DB_CREATE, $mode = 0) {}
function close() {}
function del($key, $txn = null) {}
function get($key, $txn = null, $flags = 0) {}
function pget($key, &$pkey, $txn = null, $flags = 0) {}
function get_type() {} // returns the stringified database type name
function stat($txn = null, $flags = 0) {} // returns statistics as an as
function join($cursor_list, $flags = 0) {}
function sync() {}
function truncate($txn = null, $flags = 0) {}
function cursor($txn = null, flags = 0) {}
}
class Db4Txn {
function abort() {}
function commit() {}
function discard() {}
function id() {}
function set_timeout($timeout, $flags = 0) {}
}
class Db4Cursor {
function close() {}
function count() {}
function del() {}
function dup($flags = 0) {}
function get($key, $flags = 0) {}
function pget($key, &$primary_key, $flags = 0) {}
function put($key, $data, $flags = 0) {}
}</pre>
<p>The PHP extension attempts to be "smart" for you by:</p>
<div class="orderedlist">
<ol type="1">
<li>Auto-committing operations on transactional databases if no explicit
Db4Txn object is specified.</li>
<li>Performing reference and dependency checking to insure that all
resources are closed in the correct order.</li>
<li>Supplying default values for flags.</li>
</ol>
</div>
<p>To install this PHP module linked against the mod_db4 framework, perform
the following steps:</p>
<pre class="programlisting">% phpize
% ./configure --with-db4=[Berkeley DB library installation directory] \
--with-mod_db4=$APACHE_INCLUDEDIR
% make
% make install</pre>
<p>Then, in your php.ini file add the following:</p>
<pre class="programlisting">extension=db4.so</pre>
<p>This extension will now only run in a SAPI linked into Apache httpd
(mod_php4, most likely), and will take advantage of all of its
auto-recovery and handle-caching facilities.</p>
<p>To install this php module linked against the Berkeley DB library and not the
mod_db4 framework, perform the following steps:</p>
<pre class="programlisting">% phpize
% ./configure --with-db4=[Berkeley DB library installation directory]
% make
% make install</pre>
<p>Then in your php.ini file add:</p>
<pre class="programlisting">extension=db4.so</pre>
</div>
<div class="navfooter">
<hr />
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left"><a accesskey="p" href="ext_perl.html">Prev</a> </td>
<td width="20%" align="center">
<a accesskey="u" href="ext.html">Up</a>
</td>
<td width="40%" align="right"> <a accesskey="n" href="dumpload.html">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top">Using Berkeley DB with Perl </td>
<td width="20%" align="center">
<a accesskey="h" href="index.html">Home</a>
</td>
<td width="40%" align="right" valign="top"> Chapter 22.
Dumping and Reloading Databases
</td>
</tr>
</table>
</div>
</body>
</html>
|
