介绍

你可以使用该函数库访问 MySQL 数据库服务器。有关 MySQL 的详细信息可以到 http://www.mysql.com/ 查询。

MySQL 的文档可以在 http://www.mysql.com/documentation/ 找到。

需求

为了能够顺利的使用该函数库，你必须在编译 PHP 的时候添加 MySQL 的支持。

安装

当你选择了 --with-mysql[=DIR] 配置选项的时候，你打开了 PHP 访问 MySQL 数据库的功能。

PHP 4 默认使用了 --with-mysql 选项，因此要禁用 MySQL 必须使用 --without-mysql。在 PHP 4 中，如果你没有在配置选项中指定 MySQL 的路径信息，PHP 会使用绑定的 MySQL 客户端库。在 Windows 下，没有相关的 DLL 文件，该模块已经内建在了 PHP 内核中。用户如果运行其它使用 MySQL 的应用（例如同时使用 Apache 模块化方式运行的 PHP 3 和 PHP 4，或者 auth-mysql 模块）需要指定 MySQL的路径：--with-mysql=/path/to/mysql。这会强迫 PHP 使用 MySQL 安装的客户端库函数来避免任何冲突。

在 PHP 5 中，MySQL 不再默认的开启，MySQL 库也不再和 PHP 绑定，请阅读该 FAQ 以获取更详细的信息。

该 MySQL 扩展库无法和 4.1.0 以上版本的 MySQL 一起工作。这时，您需要使用 MySQLi。

运行时配置

这些函数的行为受到全局配置文件 php.ini 的影响。

以下是该配置选项的简要解释。

资源类型

在 MySQL 模块中使用了两种资源类型。第一种是数据库的连接句柄，第二种是 SQL 查询返回的结果集。

预定义常量

由于这些常量是由该扩展模块定义的，因此只有在该扩展模块被编译到 PHP 中，或者在运行时被动态加载后，这些常量才有效。

在 PHP 4.3.0 以后的版本中，允许在 mysql_connect() 函数和 mysql_pconnect() 函数中指定更多的客户端标记。下面列出所定义的常量：

mysql_fetch_array() 函数使用一个常量来表示所返回数组的类型。下面是常量的定义：

范例

这个简单的例子演示如何连接数据库，执行查询语句，打印返回结果集和断开数据库等一系列基本的 MySQL 操作。

例子 1. MySQL 扩展范例 <?php     /* 连接选择数据库 */     $link = mysql_connect("mysql_host", "mysql_user", "mysql_password")         or die("Could not connect : " . mysql_error());     print "Connected successfully";     mysql_select_db("my_database") or die("Could not select database");     /* 执行 SQL 查询 */     $query = "SELECT * FROM my_table";     $result = mysql_query($query) or die("Query failed : " . mysql_error());     /* 在 HTML 中打印结果 */     print "<table>\n";     while ($line = mysql_fetch_array($result, MYSQL_ASSOC)) {         print "\t<tr>\n";         foreach ($line as $col_value) {             print "\t\t<td>$col_value</td>\n";         }         print "\t</tr>\n";     }     print "</table>\n";     /* 释放资源 */     mysql_free_result($result);     /* 断开连接 */     mysql_close($link); ?>