#40053 [NEW]: Missing installation instructions

From: todd at magnifisites dot com Operating system: Windows PHP version: Irrelevant PHP Bug Type: Documentation problem Bug description: Missing installation instructions Description: ------------ The MySQL Improved Extension manual page does not include instructions for installing on Windows systems. For example, the original MySQL Functions page http://php.net/ref.mysql has a section specific to PHP 5+ that states ... ===================================== MySQL is no longer enabled by default, so the php_mysql.dll DLL must be enabled inside of php.ini. ===================================== The documentation has done a great job in describing how to enable extensions for Windows installations in general as well as how to enable extensions for certain Function extensions (gd, curl, etc.). However, the current packaged PHP5 php.ini* files (both the php.ini-dist and php.ini-recommended) do not include the php_mysqli.dll extension configuration directive nor is there any reference to this particular directive found on the MySQL Improved Extension manual page vi Expected result: ---------------- Add the extension line to the php.ini-dist and the php.ini-recommended files currently being shipped with the PHP5 distribution: extension=php_mysqli.dll Also, add an installation on Windows Systems instruction to the MySQL Improved Extension manual page (the text below is taken almost verbatim from the MySQL Functions page http://php.net/ref.mysql ): Installation on Windows Systems PHP 5+ MySQL Improved Extension manual page is not enabled by default, so the php_mysqli.dll DLL must be enabled inside of php.ini. Also, PHP needs access to the MySQL client library. A file named libmysql.dll 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 PATH. See the FAQ titled "How do I add my PHP directory to the PATH on Windows" for information on how to do this. Although copying libmysql.dll to the Windows system directory also works (because the system directory is by default in the system's PATH), it's not recommended. As with enabling any PHP extension (such as php_mysql.dll), the PHP directive extension_dir should be set to the directory where the PHP extensions are located. See also the Manual Windows Installation Instructions. An example extension_dir value for PHP 5 is c:\php\ext Note: If when starting the web server an error similar to the following occurs: "Unable to load dynamic library './php_mysql.dll'", this is because php_mysql.dll and/or libmysql.dll cannot be found by the system. -- Edit bug report at http://bugs.php.net/?id=40053&edit=1 -- Try a CVS snapshot (PHP 4.4): http://bugs.php.net/fix.php?id=40053&r=trysnapshot44 Try a CVS snapshot (PHP 5.2): http://bugs.php.net/fix.php?id=40053&r=trysnapshot52 Try a CVS snapshot (PHP 6.0): http://bugs.php.net/fix.php?id=40053&r=trysnapshot60 Fixed in CVS: http://bugs.php.net/fix.php?id=40053&r=fixedcvs Fixed in release: http://bugs.php.net/fix.php?id=40053&r=alreadyfixed Need backtrace: http://bugs.php.net/fix.php?id=40053&r=needtrace Need Reproduce Script: http://bugs.php.net/fix.php?id=40053&r=needscript Try newer version: http://bugs.php.net/fix.php?id=40053&r=oldversion Not developer issue: http://bugs.php.net/fix.php?id=40053&r=support Expected behavior: http://bugs.php.net/fix.php?id=40053&r=notwrong Not enough info: http://bugs.php.net/fix.php?id=40053&r=notenoughinfo Submitted twice: http://bugs.php.net/fix.php?id=40053&r=submittedtwice register_globals: http://bugs.php.net/fix.php?id=40053&r=globals PHP 3 support discontinued: http://bugs.php.net/fix.php?id=40053&r=php3 Daylight Savings: http://bugs.php.net/fix.php?id=40053&r=dst IIS Stability: http://bugs.php.net/fix.php?id=40053&r=isapi Install GNU Sed: http://bugs.php.net/fix.php?id=40053&r=gnused Floating point limitations: http://bugs.php.net/fix.php?id=40053&r=float No Zend Extensions: http://bugs.php.net/fix.php?id=40053&r=nozend MySQL Configuration Error: http://bugs.php.net/fix.php?id=40053&r=mysqlcfg