Bug#40053 (Missing installation instructions)

copy&paste from ref.mysql


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@229138 c90b9560-bf6c-de11-be94-00142212c4b1

reference/mysqli/configure.xml

@@ -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