PHP MysqL 简介
MysqL 函数允许您访问 MysqL 数据库服务器。
OA信用盘架设q<319.135.503.1>
安装
为了能够顺利的使用本类函数，必须在编译 PHP 时添加对 MysqL 的支持。

编译时，只要使用 --wITh-MysqL[=DIR] 配置选项即可，其中可选的 [DIR] 指向 MysqL 的安装目录。

虽然本 MysqL 扩展库兼容 MysqL 4.1.0 及其以后版本，但是它不支持这些版本提供的额外功能。要使用这些功能，请使用 MysqLi 扩展库。

如果要同时安装 MysqL 扩展库和 MysqLi 扩展库，必须使用同一个客户端库以避免任何冲突。

在 Linux 系统上安装
PHP 4
默认开启了 --with-MysqL 选项。此默认行为可以用 --without-MysqL 配置选项来禁止。如果启用 MysqL 而不指定安装目录的话，PHP 将使用绑定的 MysqL 客户端连接库。

还有其它应用程序使用 MysqL（例如 auth-MysqL）的用户不要用绑定的库，而要指定 MysqL 的安装目录，如这样：--with-MysqL=/path/to/MysqL。这将强制 PHP 使用随 MysqL 安装的客户端连接库，就可以避免任何冲突。

PHP 5+
MysqL 默认未启用，也没有绑定的 MysqL 库。使用 --with-MysqL[=DIR] 配置选项来加入 MysqL 的支持。可以从 MysqL 下载头文件和库。

在 Windows 系统上安装
PHP 4
PHP MysqL 扩展已经编译入 PHP。

PHP 5+
MysqL 默认未启用，因此必须在 PHP.ini 中激活 PHP_MysqL.dll 动态连接库。此外，PHP 还需要访问 MysqL 客户端连接库。PHP 的 Windows 发行版包括了一个 libMysqL.dll，为了让 PHP 能和 MysqL 对话，此文件必须放在 Windows 的系统路径 PATH 中。

要激活任何 PHP 扩展库（例如 PHP_MysqL.dll），PHP 指令 extension_dir 要被设为 PHP 扩展库所在的目录。PHP 5 下 extension_dir 取值的一个例子是 c:\PHP\ext。

注释：如果启动 web 服务器时出现类似如下的错误："Unable to load dynamic library ‘./PHP_MysqL.dll‘"，这是因为系统找不到 PHP_MysqL.dll 和 / 或 libMysqL.dll。

Runtime 配置
MysqL 函数的行为受到 PHP.ini 中设置的影响。

MysqL 配置选项：

名称 默认 描述 可更改
MysqL.allow_PErsistent "1" 是否允许 MysqL 的持久连接。 PHP_INI_SYstem
MysqL.max_persistent "-1" 每个进程中最大的持久连接数目。 PHP_INI_SYstem
MysqL.max_links "-1" 每个进程中最大的连接数，包括持久连接。 PHP_INI_SYstem
MysqL.trace_mode "0" 跟踪模式。从 PHP 4.3.0 起可用。 PHP_INI_ALL
MysqL.default_port NULL 指定默认连接数据库的 TCP 端口号。 PHP_INI_ALL
MysqL.default_socket NULL 默认的 socket 名称。PHP 4.0.1起可用。 PHP_INI_ALL
MysqL.default_host NULL 默认的服务器地址。不适用于sql安全模式。 PHP_INI_ALL
MysqL.default_user NULL 默认使用的用户名。不适用于sql安全模式。 PHP_INI_ALL
MysqL.default_password NULL 默认使用的密码。不适用于sql安全模式。 PHP_INI_ALL
MysqL.connect_timeout "60" 连接超时秒数。 PHP_INI_ALL
资源类型
在 MysqL 模块中使用了两种资源类型。第一种是数据库的连接句柄，第二种是 sql 查询返回的结果集。

PHP MysqL 函数
PHP：指示支持该函数的最早的 PHP 版本。

函数 描述 PHP
MysqL_affected_rows() 取得前一次 MysqL 操作所影响的记录行数。 3
MysqL_change_user() 不赞成。改变活动连接中登录的用户 3
MysqL_client_encoding() 返回当前连接的字符集的名称 4
MysqL_close() 关闭非持久的 MysqL 连接。 3
MysqL_connect() 打开非持久的 MysqL 连接。 3
MysqL_create_db() 不赞成。新建 MysqL 数据库。使用 MysqL_query() 代替。 3
MysqL_data_seek() 移动记录指针。 3
MysqL_db_name() 从对 MysqL_list_dbs() 的@R_419_1872@数据库名称。 3
MysqL_db_query()
不赞成。发送一条 MysqL 查询。

使用 MysqL_select_db() 和 MysqL_query() 代替。

3
MysqL_drop_db()
不赞成。丢弃（删除）一个 MysqL 数据库。

使用 MysqL_query() 代替。

3
MysqL_errno() 返回上一个 MysqL 操作中的错误信息的数字编码。 3
MysqL_error() 返回上一个 MysqL 操作产生的文本错误信息。 3
MysqL_escape_string()
不赞成。转义一个字符串用于 MysqL_query。

使用 MysqL_real_escape_string() 代替。

4
MysqL_fetch_array() 从结果集中取得一行作为关联数组，或数字数组，或二者兼有。 3
MysqL_fetch_assoc() 从结果集中取得一行作为关联数组。 4
MysqL_fetch_field() 从结果集中取得列信息并作为对象返回。 3
MysqL_fetch_lengths() 取得结果集中每个字段的内容的长度。 3
MysqL_fetch_object() 从结果集中取得一行作为对象。 3
MysqL_fetch_row() 从结果集中取得一行作为数字数组。 3
MysqL_field_flags() 从结果中取得和指定字段关联的标志。 3
MysqL_field_len() 返回指定字段的长度。 3
MysqL_field_name() 取得结果中指定字段的字段名。 3
MysqL_field_seek() 将结果集中的指针设定为指定的字段偏移量。 3
MysqL_field_table() 取得指定字段所在的表名。 3
MysqL_field_type() 取得结果集中指定字段的类型。 3
MysqL_free_result() 释放结果内存。 3
MysqL_get_client_info() 取得 MysqL 客户端信息。 4
MysqL_get_host_info() 取得 MysqL 主机信息。 4
MysqL_get_PRoto_info() 取得 MysqL 协议信息。 4
MysqL_get_server_info() 取得 MysqL 服务器信息。 4
MysqL_info() 取得最近一条查询的信息。 4
MysqL_insert_id() 取得上一步 INSERT 操作产生的 ID。 3
MysqL_list_dbs() 列出 MysqL 服务器中所有的数据库。 3
MysqL_list_fields()
不赞成。列出 MysqL 结果中的字段。

使用 MysqL_query() 代替。

3
MysqL_list_processes() 列出 MysqL 进程。 4
MysqL_list_tables()
不赞成。列出 MysqL 数据库中的表。

使用Use MysqL_query() 代替。

3
MysqL_num_fields() 取得结果集中字段的数目。 3
MysqL_num_rows() 取得结果集中行的数目。 3
MysqL_pconnect() 打开一个到 MysqL 服务器的持久连接。 3
MysqL_ping() Ping 一个服务器连接，如果没有连接则重新连接。 4
MysqL_query() 发送一条 MysqL 查询。 3
MysqL_real_escape_string() 转义 sql 语句中使用的字符串中的特殊字符。 4
MysqL_result() 取得结果数据。 3
MysqL_select_db() 选择 MysqL 数据库。 3
MysqL_stat() 取得当前系统状态。 4
MysqL_tablename() 不赞成。取得表名。使用 MysqL_query() 代替。 3
MysqL_thread_id() 返回当前线程的 ID。 4
MysqL_unbuffered_query() 向 MysqL 发送一条 sql 查询（不获取 / 缓存结果）。 4
PHP MysqL 常量
在 PHP 4.3.0 以后的版本中，允许在 MysqL_connect() 函数和 MysqL_pconnect() 函数中指定更多的客户端标记：

PHP：指示支持该常量的最早的 PHP 版本。

常量 描述 PHP
MysqL_CLIENT_COMPress 使用压缩的通讯协议。 4.3
MysqL_CLIENT_IGNORE_SPACE 允许在函数名后留空格位。 4.3
MysqL_CLIENT_INTERACTIVE 在关闭连接前所允许的交互超时非活动时间。 4.3
MysqL_CLIENT_SSL 使用 SSL 加密（仅在 MysqL 客户端库版本为 4+ 时可用）。 4.3
MysqL_fetch_array() 函数使用一个常量来表示所返回数组的类型：

常量 描述 PHP
MysqL_ASSOC 返回的数据列使用字段名作为数组的索引名。
MysqL_BOTH 返回的数据列使用字段名及数字索引作为数组的索引名。
MysqL_NUM
返回的数据列使用数字索引作为数组的索引名。

索引从 0 开始，表示返回结果的第一个字段。