- 20.11.1 MySQL
- 20.11.1.1 Installing/Configuring
- 20.11.1.2 Predefined Constants
- 20.11.1.3 Examples
- 20.11.1.4 MySQL Functions
[+/-]
Copyright 1997-2008 the PHP Documentation Group.
Copyright 1997-2008 the PHP Documentation Group.
In order to have these functions available, you must compile PHP with MySQL support.
[+/-]
Copyright 1997-2008 the PHP Documentation Group.
For compiling, simply use the
--with-mysql[=DIR] configuration option where
the optional [DIR] points to the MySQL
installation directory.
Although this MySQL extension is compatible with MySQL 4.1.0 and greater, it doesn't support the extra functionality that these versions provide. For that, use the MySQLi extension.
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.
Copyright 1997-2008 the PHP Documentation Group.
Copyright 1997-2008 the PHP Documentation Group.
The option --with-mysql is enabled by
default. This default behavior may be disabled with the
--without-mysql 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:
--with-mysql=/path/to/mysql. This will
force PHP to use the client libraries installed by MySQL,
thus avoiding any conflicts.
Copyright 1997-2008 the PHP Documentation Group.
MySQL is not enabled by default, nor is the MySQL library
bundled with PHP. Read this
FAQ for details on why. Use the
--with-mysql[=DIR] configure option to
include MySQL support. You can download headers
and libraries from
MySQL.
Copyright 1997-2008 the PHP Documentation Group.
Copyright 1997-2008 the PHP Documentation Group.
The PHP MySQL extension is compiled into PHP.
Copyright 1997-2008 the PHP Documentation Group.
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 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.
Copyright 1997-2008 the PHP Documentation Group.
Warning
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.
Note
If you need charsets other than latin (default), you have to install external (not bundled) libmysql with compiled charset support.
Copyright 1997-2008 the PHP Documentation Group.
The behaviour of these functions is affected by settings in php.ini.
Table 20.4. MySQL Configuration Options
| Name | Default | Changeable | Changelog |
|---|---|---|---|
| mysql.allow_persistent | "1" | PHP_INI_SYSTEM | |
| mysql.max_persistent | "-1" | PHP_INI_SYSTEM | |
| mysql.max_links | "-1" | PHP_INI_SYSTEM | |
| mysql.trace_mode | "0" | PHP_INI_ALL | Available since PHP 4.3.0. |
| mysql.default_port | NULL | PHP_INI_ALL | |
| mysql.default_socket | NULL | PHP_INI_ALL | Available since PHP 4.0.1. |
| mysql.default_host | NULL | PHP_INI_ALL | |
| mysql.default_user | NULL | PHP_INI_ALL | |
| mysql.default_password | NULL | PHP_INI_ALL | |
| mysql.connect_timeout | "60" | PHP_INI_ALL | PHP_INI_SYSTEM in PHP <= 4.3.2. Available since PHP 4.3.0. |
For further details and definitions of the PHP_INI_* modes, see the configuration.changes.modes.
Here's a short explanation of the configuration directives.
-
mysql.allow_persistentboolean Whether to allow persistent connections to MySQL.
-
mysql.max_persistentinteger The maximum number of persistent MySQL connections per process.
-
mysql.max_linksinteger The maximum number of MySQL connections per process, including persistent connections.
-
mysql.trace_modeboolean Trace mode. When
mysql.trace_modeis enabled, warnings for table/index scans, non free result sets, and SQL-Errors will be displayed. (Introduced in PHP 4.3.0)-
mysql.default_portstring The default TCP port number to use when connecting to the database server if no other port is specified. If no default is specified, the port will be obtained from the
MYSQL_TCP_PORTenvironment variable, themysql-tcpentry in/etc/servicesor the compile-timeMYSQL_PORTconstant, in that order. Win32 will only use theMYSQL_PORTconstant.-
mysql.default_socketstring The default socket name to use when connecting to a local database server if no other socket name is specified.
-
mysql.default_hoststring The default server host to use when connecting to the database server if no other host is specified. Doesn't apply in SQL safe mode.
-
mysql.default_userstring The default user name to use when connecting to the database server if no other name is specified. Doesn't apply in SQL safe mode.
-
mysql.default_passwordstring The default password to use when connecting to the database server if no other password is specified. Doesn't apply in SQL safe mode.
-
mysql.connect_timeoutinteger Connect timeout in seconds. On Linux this timeout is also used for waiting for the first answer from the server.
Copyright 1997-2008 the PHP Documentation Group.
There are two resource types used in the MySQL module. The first one is the link identifier for a database connection, the second a resource which holds the result of a query.
User Comments
Add your own comment.