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
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
|
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.4 $ -->
<section id="pdo.installation">
&reftitle.install;
<procedure id='pdo.install.unix51up'>
<title>PHP 5.1 and up on Unix systems</title>
<step>
<para>
If you're running a PHP 5.1 release, PDO and <link
linkend="ref.pdo-sqlite">PDO_SQLITE</link> is included in the distribution;
it will be automatically enabled when you run configure. It is
recommended that you build PDO as a shared extension, as this will allow
you to take advantage of updates that are made available via PECL. The
recommended configure line for building PHP with PDO support should
enable zlib support (for the pecl installer) as well. You may also need
to enable the PDO driver for your database of choice; consult the
documentation for <link linkend="pdo.drivers">database-specific
PDO drivers</link> to find out more about that, but note that if you
build PDO as a shared extension, you must build the PDO drivers as
shared extensions.
SQLite extension depends on PDO so if PDO is built as a shared extension,
SQLite needs to be built the same way.
<screen>
<![CDATA[
./configure --with-zlib --enable-pdo=shared --with-pdo-sqlite=shared --with-sqlite=shared
]]>
</screen>
</para>
</step>
<step>
<para>
After installing PDO as a shared module, you must edit your php.ini file
so that the PDO extension will be loaded automatically when PHP runs.
You will also need to enable any database specific drivers there too;
make sure that they are listed after the pdo.so line, as PDO must be
initialized before the database-specific extensions can be loaded.
If you built PDO and the database-specific extensions statically, you
can skip this step.
<screen>
<![CDATA[
extension=pdo.so
]]>
</screen>
</para>
</step>
<step>
<para>
Having PDO as a shared module will allow you to run <command>pecl
upgrade pdo</command> as new versions of PDO are published, without
forcing you to rebuild the whole of PHP. Note that if you do this, you
also need to upgrade your database specific PDO drivers at the same
time.
</para>
</step>
</procedure>
<procedure id='pdo.install.pecl'>
<title>PHP 5.0 and up on Unix systems</title>
<step>
<para>
PDO is available as a PECL extension from
<ulink url='&url.pecl.package;pdo'>&url.pecl.package;pdo</ulink>.
Installation can be performed via the <command>pecl</command> tool; this
is enabled by default when you configure PHP. You should ensure that
PHP was configured --with-zlib in order for
<command>pecl</command> to be able to handle the compressed package
files.
</para>
</step>
<step>
<para>
Run the following command to download, build, and install the
latest stable version of PDO:
<screen>
<![CDATA[
pecl install pdo
]]>
</screen>
</para>
</step>
<step>
<para>
The <command>pecl</command> command automatically installs the
PDO module into your PHP extensions directory. To enable the
PDO extension on Linux or Unix operating systems, you must add
the following line to &php.ini;:
<screen>
<![CDATA[
extension=pdo.so
]]>
</screen>
</para>
<para>
For more information about building PECL packages, consult the
<link linkend="install.pecl">PECL installation</link> section of the manual.
</para>
</step>
</procedure>
<procedure id='pdo.install.win32php51'>
<title>Windows users running PHP 5.1 and up</title>
<step>
<para>
PDO and all the major drivers ship with PHP as shared extensions, and
simply need to be activated by editing the &php.ini; file:
<screen>
<![CDATA[
extension=php_pdo.dll
]]>
</screen>
</para>
</step>
<step>
<para>
Next, choose the other database-specific DLL files and either use
<function>dl</function> to load them at runtime, or enable them in
&php.ini; below <filename>php_pdo.dll</filename>. For example:
<screen>
<![CDATA[
extension=php_pdo.dll
extension=php_pdo_firebird.dll
extension=php_pdo_informix.dll
extension=php_pdo_mssql.dll
extension=php_pdo_mysql.dll
extension=php_pdo_oci.dll
extension=php_pdo_oci8.dll
extension=php_pdo_odbc.dll
extension=php_pdo_pgsql.dll
extension=php_pdo_sqlite.dll
]]>
</screen>
</para>
<para>
These DLLs should exist in the system's
<link linkend="ini.extension-dir">extension_dir</link>.
Note that <link linkend="ref.pdo-informix">PDO_INFORMIX</link>
is only available as a PECL extension.
</para>
</step>
</procedure>
</section>
<!-- 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
-->
|
