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
|
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<section xml:id="ref.pdo-mysql.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.install;
<para>
The common Unix distributions include binary versions of PHP that can
be installed. Although these binary versions are typically built with
support for the MySQL extensions, the extension libraries
themselves may need to be installed using an additional package. Check
the package manager that comes with your chosen distribution for
availability.
</para>
<para>
For example, on Ubuntu the <literal>php5-mysql</literal> package installs
the ext/mysql, ext/mysqli, and PDO_MYSQL PHP extensions. On CentOS,
the <literal>php-mysql</literal> package also installs these three
PHP extensions.
</para>
<para>
Alternatively, you can compile this extension yourself. Building PHP from
source allows you to specify the MySQL extensions you want to use, as well
as your choice of client library for each extension.
</para>
<para>
When compiling, use <option role="configure">--with-pdo-mysql[=DIR]</option> to install
the PDO MySQL extension, where the optional <literal>[=DIR]</literal>
is the MySQL base library. <link linkend="book.mysqlnd">Mysqlnd</link>
is the default library. For details about choosing a library, see
<link linkend="mysqlinfo.library.choosing">Choosing a MySQL library</link>.
</para>
<para>
Optionally, the <option role="configure">--with-mysql-sock[=DIR]</option> sets to location
to the MySQL unix socket pointer for all MySQL extensions, including PDO_MYSQL. If
unspecified, the default locations are searched.
</para>
<para>
Optionally, the <option role="configure">--with-zlib-dir[=DIR]</option> is used to set
the path to the libz install prefix.
</para>
<para>
<screen>
<![CDATA[
$ ./configure --with-pdo-mysql --with-mysql-sock=/var/mysql/mysql.sock
]]>
</screen>
</para>
<para>
<acronym>SSL</acronym> support is enabled using the appropriate
<constant>Pdo\Mysql::ATTR_SSL_<replaceable>*</replaceable></constant>,
which is equivalent to calling the
<link xlink:href="&url.mysql.docs.ssl.set;">MySQL C API function mysql_ssl_set()</link>.
Also, SSL cannot be enabled with <methodname>PDO::setAttribute</methodname>
because the connection already exists.
See also the MySQL documentation about
<link xlink:href="&url.mysql.docs.ssl.using;">connecting to MySQL with SSL</link>.
</para>
</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:"~/.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
-->
|
