bjori Tue Feb 6 11:30:06 2007 UTC
Modified files:
/phpdoc/en/reference/mysqli configure.xml
Log:
Bug#40053 (Missing installation instructions)
copy&paste from ref.mysql
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/configure.xml?r1=1.5&r2=1.6&diff_format=u
Index: phpdoc/en/reference/mysqli/configure.xml
diff -u phpdoc/en/reference/mysqli/configure.xml:1.5
phpdoc/en/reference/mysqli/configure.xml:1.6
--- phpdoc/en/reference/mysqli/configure.xml:1.5 Fri Nov 18 09:11:24 2005
+++ phpdoc/en/reference/mysqli/configure.xml Tue Feb 6 11:30:06 2007
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
<section id="mysqli.installation">
&reftitle.install;
<para id="mysqli.configure">
@@ -9,10 +9,46 @@
the location of the <literal>mysql_config</literal> program that comes
with MySQL versions greater than 4.1.
</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>
+
+ <section id="mysqli.installation.windows">
+ <title>Installation on Windows Systems</title>
+ <para>
+ MySQLi is not enabled by default, so the
+ <filename>php_mysqli.dll</filename> DLL must be enabled inside of
+ &php.ini;. Also, PHP needs access to the MySQL client library. A file
+ named <filename>libmysql.dll</filename> is included in the Windows PHP
+ distribution and in order for PHP to talk to MySQL this file needs to be
+ available to the Windows systems <envar>PATH</envar>. See the FAQ
+ titled "<link linkend="faq.installation.addtopath">How do I add my PHP
+ directory to the PATH on Windows</link>" for information on how to do
+ this. Although copying <filename>libmysql.dll</filename> to the Windows
+ system directory also works (because the system directory is by default in
+ the system's <envar>PATH</envar>), it's not recommended.
+ </para>
+ <para>
+ As with enabling any PHP extension (such as
+ <filename>php_mysql.dll</filename>), the PHP directive
+ <link linkend="ini.extension-dir">extension_dir</link> should be set to
+ the directory where the PHP extensions are located. See also the
+ <link linkend="install.windows.manual">Manual Windows Installation
+ Instructions</link>. An example extension_dir value for PHP 5 is
+ <literal>c:\php\ext</literal>
+ </para>
+ <note>
+ <para>
+ If when starting the web server an error similar to the following occurs:
+ <literal>"Unable to load dynamic library './php_mysqli.dll'"</literal>,
+ this is because <filename>php_mysqli.dll</filename> and/or
+ <filename>libmysql.dll</filename> cannot be found by the system.
+ </para>
+ </note>
+ </section>
+
</section>
<!-- Keep this comment at the end of the file
