php-doc-en/reference/mysql/configure.xml

90 lines
3 KiB
XML

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.11 $ -->
<section id="mysql.installation">
&reftitle.install;
<para id="mysql.configure">
By using the <option role="configure">--with-mysql[=DIR]</option>
configuration option you enable PHP to access MySQL
databases.
</para>
<para>
In PHP 4, the option <option role="configure">--with-mysql</option> is
enabled by default. To disable this default behavior, you may use the
<option role="configure">--without-mysql</option> configure option.
Also in PHP 4, if you enable MySQL without specifying the path to the
MySQL install DIR, PHP will use the bundled MySQL client
libraries. In Windows, there is no DLL, it's simply built into PHP 4.
Users who run other applications that use MySQL (for example,
auth-mysql) should not use the bundled library, but rather specify the
path to MySQL's install directory, like so:
<option role="configure">--with-mysql=/path/to/mysql</option>.
This will force PHP to use the client libraries
installed by MySQL, thus avoiding any conflicts.
</para>
<para>
In PHP 5, MySQL is no longer enabled by default, nor is the MySQL library
bundled with PHP. Read this <link linkend="faq.databases.mysql.php5">
FAQ</link> for details on why.
</para>
<note>
<para>
Windows users will need to enable <filename>php_mysql.dll</filename>
inside of &php.ini; and either copy <filename>libmysql.dll</filename>
into the Windows system directory, or make it available to the <envar>PATH</envar>.
</para>
<para>
This will fix "Unable to load dynamic library './php_mysql.dll'" errors.
</para>
</note>
<para>
For compiling, simply use
<option role="configure"> --with-mysql=[DIR]</option> where
<literal>[DIR]</literal> points to your MySQL installation directory.
</para>
<para>
This MySQL extension doesn't support full functionality of MySQL versions greater than
4.1.0. For that, use <link linkend="ref.mysqli">MySQLi</link>.
</para>
<para>
If you would like to install the mysql extension along with the mysqli extension
you have to use the same client library to avoid any conflicts.
</para>
<warning>
<para>
Crashes and startup problems of PHP may be encountered
when loading this extension in conjunction with the recode extension.
See the <link linkend="ref.recode">recode</link> extension for more
information.
</para>
</warning>
<note>
<para>
If you need charsets other than <emphasis>latin</emphasis> (default), you
have to install external (not bundled) libmysql with compiled charset
support.
</para>
</note>
</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
-->