diff --git a/reference/mysql/configure.xml b/reference/mysql/configure.xml index 13ae2e0671..f0be0f16c7 100644 --- a/reference/mysql/configure.xml +++ b/reference/mysql/configure.xml @@ -1,47 +1,13 @@ - +
&reftitle.install; - - By using the - configuration option you enable PHP to access MySQL - databases. - - - In PHP 4, the option is - enabled by default. To disable this default behavior, you may use the - 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: - . - This will force PHP to use the client libraries - installed by MySQL, thus avoiding any conflicts. - - - In PHP 5, MySQL is no longer enabled by default, nor is the MySQL library - bundled with PHP. Read this - FAQ for details on why. - - - - Windows users will need to enable php_mysql.dll - inside of &php.ini; and either copy libmysql.dll - into the Windows system directory, or make it available to the PATH. - - - This will fix "Unable to load dynamic library './php_mysql.dll'" errors. - - - - - For compiling, simply use - where - [DIR] points to your MySQL installation directory. + + For compiling, simply use the + + configuration option where the optional [DIR] points to + the MySQL installation directory. This MySQL extension doesn't support full functionality of MySQL versions greater than @@ -51,21 +17,100 @@ 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. - - - Crashes and startup problems of PHP may be encountered - when loading this extension in conjunction with the recode extension. - See the recode extension for more - information. - - - - - If you need charsets other than latin (default), you - have to install external (not bundled) libmysql with compiled charset - support. - - + +
+ Installation on Linux Systems +
+ PHP 4 + + The option is + enabled by default. This default behavior may be disabled with the + configure option. + If MySQL is enabled without specifying the path to the + MySQL install DIR, PHP will use the bundled MySQL client libraries. + + + 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: + . + This will force PHP to use the client libraries installed by MySQL, thus + avoiding any conflicts. + +
+
+ PHP 5+ + + MySQL is not enabled by default, nor is the MySQL library + bundled with PHP. Read this + FAQ for details on why. Use the + configure option + to include MySQL support. + +
+
+ +
+ Installation on Windows Systems +
+ PHP 4 + + The PHP MySQL extension is compiled into PHP. + +
+
+ PHP 5+ + + MySQL is no longer enabled by default, so the + php_mysql.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 systems 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 + + + + 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. + + +
+
+ +
+ MySQL Installation Notes + + + Crashes and startup problems of PHP may be encountered + when loading this extension in conjunction with the recode extension. + See the recode extension for more + information. + + + + + If you need charsets other than latin (default), you + have to install external (not bundled) libmysql with compiled charset + support. + + +