From 1599554504e95bdce9b8d0ac9c1cff213b70788c Mon Sep 17 00:00:00 2001 From: Philip Olson Date: Mon, 11 Apr 2005 20:20:45 +0000 Subject: [PATCH] Rewrote and restructered these docs so hopefully Windows users will be able to install MySQL with PHP 5. All of them. No more questions. Used titled sections which seemed like the best way to seperate the content. TODO: Document issues with the bundled libmysql.dll vs. the one that comes with MySQL itself. git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@184163 c90b9560-bf6c-de11-be94-00142212c4b1 --- reference/mysql/configure.xml | 155 ++++++++++++++++++++++------------ 1 file changed, 100 insertions(+), 55 deletions(-) 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. + + +