php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
Doc Bug #40053 Missing installation instructions
Submitted: 2007-01-07 23:46 UTC Modified: 2007-02-06 11:30 UTC
From: todd at magnifisites dot com Assigned:
Status: Closed Package: Documentation problem
PHP Version: Irrelevant OS: Windows
Private report: No CVE-ID: None
 [2007-01-07 23:46 UTC] todd at magnifisites dot com
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. 


Patches

Pull Requests

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2007-02-06 11:30 UTC] bjori@php.net
This bug has been fixed in the documentation's XML sources. Since the
online and downloadable versions of the documentation need some time
to get updated, we would like to ask you to be a bit patient.

Thank you for the report, and for helping us make our documentation better.


 
PHP Copyright © 2001-2026 The PHP Group
All rights reserved.
Last updated: Wed Apr 01 13:00:02 2026 UTC