configure.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 40667918dcff1d5c9f7ecdc88b5caca24ba0686c Maintainer: HonestQiao Status: ready -->
<!-- CREDITS: Gregory, mowangjuanzi -->
<section xml:id="mysql.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 &reftitle.install;
 
 <warning>
  &mysql.alternative.note;
 </warning>

 <para xml:id="mysql.configure">
  编译时，只要使用
  <option role="configure">--with-mysql[=DIR]</option>
  配置选项即可，其中可选的
  <literal>[DIR]</literal> 指向 MySQL 的安装目录。
 </para>
 <para>
  虽然本 MySQL 扩展库兼容 MySQL 4.1.0
  及其以后版本，但是它不支持这些版本提供的额外功能。要使用这些功能，请使用
  <link linkend="book.mysqli">MySQLi</link> 扩展库。
 </para>
 <para>
  如果要同时安装 mysql 扩展库和 mysqli 扩展库，必须使用同一个客户端库以避免任何冲突。
 </para>

 <section xml:id="mysql.installation.linux">
  <title>在 Linux 系统下安装</title>
  <para>
   Note: <literal>[DIR]</literal> is the path to the MySQL client library 
   files (<emphasis>headers and libraries</emphasis>), which can be downloaded from 
   <link xlink:href="&url.mysql;">MySQL</link>.
  </para>
  <table xml:id="mysql.installation.compile.support">
   <title>ext/mysql compile time support matrix</title>
   <tgroup cols="5">
    <thead>
     <row>
      <entry>PHP &Version;</entry>
      <entry>&Default;</entry>
      <entry>&ConfigureOptions;: <link linkend="mysqlnd.overview">mysqlnd</link></entry>
      <entry>&ConfigureOptions;: <literal>libmysql</literal></entry>
      <entry>&Changelog;</entry>
     </row>
    </thead>
    <tbody>
     <row>
      <entry>4.x.x</entry>
      <entry>libmysql</entry>
      <entry>&NotAvailable;</entry>
      <entry><option role="configure">--without-mysql</option> to disable</entry>
      <entry>MySQL enabled by default, MySQL client libraries are bundled</entry>
     </row>
     <row>
      <entry>5.0.x, 5.1.x, 5.2.x</entry>
      <entry>libmysql</entry>
      <entry>&NotAvailable;</entry>
      <entry><option role="configure">--with-mysql=[DIR]</option></entry>
      <entry>
       MySQL is no longer enabled by default, and the MySQL client libraries
       are no longer bundled
      </entry>
     </row>
     <row>
      <entry>5.3.x</entry>
      <entry>libmysql</entry>
      <entry><option role="configure">--with-mysql=mysqlnd</option></entry>
      <entry><option role="configure">--with-mysql=[DIR]</option></entry>
      <entry>mysqlnd is now available</entry>
     </row>
     <row>
      <entry>5.4.x</entry>
      <entry>mysqlnd</entry>
      <entry><option role="configure">--with-mysql</option></entry>
      <entry><option role="configure">--with-mysql=[DIR]</option></entry>
      <entry>mysqlnd is now the default</entry>
     </row>
    </tbody>
   </tgroup>
  </table>
 </section>

 <section xml:id="mysql.installation.windows">
  <title>在 Windows 系统下安装</title>
  <section>
   <title>PHP 5+</title>
   <para>
    MySQL 默认未启用，因此必须在 &php.ini; 中激活
    <filename>php_mysql.dll</filename> 动态连接库。此外，PHP
    还需要访问 MySQL 客户端连接库。PHP 的 Windows
    发行版包括了一个
    <filename>libmysql.dll</filename>，为了让 PHP 能和
    MySQL 对话，此文件必须放在 Windows 的系统路径
    <envar>PATH</envar> 中。怎样做见 FAQ
    中的“<link linkend="faq.installation.addtopath">怎样把 PHP
    目录加入到 Windows <varname>PATH</varname>中</link>”。尽管将
    <filename>libmysql.dll</filename> 拷贝到 Windows
    系统目录中也可以（因为系统目录默认在系统路径
    <envar>PATH</envar> 中），但不推荐这样做。
   </para>
   <para>
    要激活任何 PHP 扩展库（例如
    <filename>php_mysql.dll</filename>），PHP 指令
    <link linkend="ini.extension-dir">extension_dir</link>
    要被设为 PHP 扩展库所在的目录。参见<link
    linkend="install.windows.manual">手工 Windows
    安装指南</link>。PHP 5 下 extension_dir 取值的一个例子是
    <literal>c:\php\ext</literal>。
   </para>
   <note>
    <para>
     如果启动 web 服务器时出现类似如下的错误：<literal>"Unable
     to load dynamic library './php_mysql.dll'"</literal>，这是因为系统找不到
     <filename>php_mysql.dll</filename> 和／或
     <filename>libmysql.dll</filename>。
    </para>
   </note>
  </section>
  <section>
   <title>PHP 5.3.0+</title>
   <para>
    The <link linkend="mysqlnd.overview">MySQL Native Driver</link> is enabled by
    default. Include <filename>php_mysql.dll</filename>, but <filename>libmysql.dll</filename>
    is no longer required or used.
   </para>
  </section>
 </section>

 <section xml:id="mysql.installation.notes">
  <title>MySQL 安装注意事项</title>
   <warning>
    <para>
     当同时加在本扩展库和 recode 扩展库时 PHP 可能会崩溃。更多信息见
     <link linkend="ref.recode">recode</link> 扩展库。
    </para>
   </warning>
   <note>
    <para>
     如果需要不同于
     <emphasis>latin</emphasis>（默认值）的字符集，必须安装外部的（非绑定的）已编译入所需字符集支持的
     libmysql。
    </para>
   </note>
 </section>
</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
-->