MySQL 函数 (PDO_MYSQL)

简介

PDO_MYSQL 是一个驱动程序，它实现了 PHP 数据对象 (PDO) 接口，以允许从 PHP 访问 MySQL 数据库。

PDO_MYSQL 默认使用模拟准备。

MySQL 8

在运行 PHP 版本早于 7.1.16 或 PHP 7.2 早于 7.2.4 时，请将 MySQL 8 服务器的默认密码插件设置为 mysql_native_password，否则您将看到类似于 服务器请求客户端未知的身份验证方法 [caching_sha2_password] 的错误，即使未使用 caching_sha2_password。

这是因为 MySQL 8 默认使用 caching_sha2_password，该插件不被旧版 PHP (mysqlnd) 版本识别。相反，通过在 my.cnf 中设置 default_authentication_plugin=mysql_native_password 来更改它。从 PHP 7.4.4 开始完全支持 caching_sha2_password 插件。对于较旧的版本，mysql_xdevapi 扩展确实支持它。

注意:

MySQL 驱动程序不支持 PDO::PARAM_INPUT_OUTPUT 通过 PDOStatement::bindParam()；虽然可以使用此类参数，但它们不会更新（即实际输出被忽略）。

安装

常见的 Unix 发行版包含可以安装的 PHP 二进制版本。尽管这些二进制版本通常是在支持 MySQL 扩展的情况下构建的，但扩展库本身可能需要使用额外的软件包进行安装。检查您选择的发行版附带的软件包管理器以查看可用性。

例如，在 Ubuntu 上，php5-mysql 包安装 ext/mysql、ext/mysqli 和 PDO_MYSQL PHP 扩展。在 CentOS 上，php-mysql 包也安装了这三个 PHP 扩展。

或者，您可以自己编译此扩展。从源代码构建 PHP 允许您指定要使用的 MySQL 扩展，以及您为每个扩展选择的客户端库。

编译时，使用 --with-pdo-mysql[=DIR] 安装 PDO MySQL 扩展，其中可选的 [=DIR] 是 MySQL 基本库。 Mysqlnd 是默认库。有关选择库的详细信息，请参阅 选择 MySQL 库。

可选地，--with-mysql-sock[=DIR] 设置为所有 MySQL 扩展（包括 PDO_MYSQL）的 MySQL unix 套接字指针的位置。如果未指定，则会搜索默认位置。

可选地，--with-zlib-dir[=DIR] 用于设置 libz 安装前缀的路径。

$ ./configure --with-pdo-mysql --with-mysql-sock=/var/mysql/mysql.sock

SSL 支持使用适当的 PDO_MySQL 常量 启用，这等效于调用 » MySQL C API 函数 mysql_ssl_set()。此外，无法使用 PDO::setAttribute 启用 SSL，因为连接已存在。另请参阅有关 » 使用 SSL 连接到 MySQL 的 MySQL 文档。

预定义常量

以下常量由此驱动程序定义，并且只有在已将扩展编译到 PHP 中或在运行时动态加载时才可用。此外，这些特定于驱动程序的常量仅在使用此驱动程序时使用。将特定于驱动程序的属性与另一个驱动程序一起使用可能会导致意外行为。 PDO::getAttribute() 可用于获取 PDO::ATTR_DRIVER_NAME 属性以检查驱动程序，如果您的代码可以在多个驱动程序上运行。

PDO::MYSQL_ATTR_USE_BUFFERED_QUERY (bool)

默认情况下，所有语句都在 缓冲模式 下执行。如果此属性在 PDO 对象上设置为 false，则 MySQL 驱动程序将使用非缓冲模式。

示例 #1 设置 MySQL 非缓冲模式

<?php
$pdo = new PDO("mysql:host=localhost;dbname=world", 'my_user', 'my_password');
$pdo->setAttribute(PDO::MYSQL_ATTR_USE_BUFFERED_QUERY, false);

$unbufferedResult = $pdo->query("SELECT Name FROM City");
foreach ($unbufferedResult as $row) {
echo $row['Name'] . PHP_EOL;
}
?>

PDO::MYSQL_ATTR_LOCAL_INFILE (int)

启用 LOAD LOCAL INFILE。

注意，此常量只能在构建新数据库句柄时在 driver_options 数组中使用。

PDO::MYSQL_ATTR_LOCAL_INFILE_DIRECTORY (string)

允许将 LOCAL DATA 加载限制到位于此指定目录中的文件。从 PHP 8.1.0 开始可用。

注意，此常量只能在构建新数据库句柄时在 driver_options 数组中使用。

PDO::MYSQL_ATTR_INIT_COMMAND (string)

连接到 MySQL 服务器时要执行的命令。在重新连接时会自动重新执行。

注意，此常量只能在构建新数据库句柄时在 driver_options 数组中使用。

PDO::MYSQL_ATTR_READ_DEFAULT_FILE (int)

从指定的选项文件而不是从 my.cnf 中读取选项。如果使用 mysqlnd，则此选项不可用，因为 mysqlnd 不读取 mysql 配置文件。

PDO::MYSQL_ATTR_READ_DEFAULT_GROUP (int)

从 my.cnf 中的指定组或使用 MYSQL_READ_DEFAULT_FILE 指定的文件中读取选项。如果使用 mysqlnd，则此选项不可用，因为 mysqlnd 不读取 mysql 配置文件。

PDO::MYSQL_ATTR_MAX_BUFFER_SIZE (int)

最大缓冲区大小。默认为 1 MiB。当针对 mysqlnd 编译时，此常量不受支持。

PDO::MYSQL_ATTR_DIRECT_QUERY (int)

执行直接查询，不要使用准备好的语句。

PDO::MYSQL_ATTR_FOUND_ROWS (int)

返回找到（匹配）的行数，而不是更改的行数。

PDO::MYSQL_ATTR_IGNORE_SPACE (int)

允许函数名称后面的空格。使所有函数名称成为保留字。

PDO::MYSQL_ATTR_COMPRESS (int)

启用网络通信压缩。

PDO::MYSQL_ATTR_SSL_CA (int)

SSL 证书颁发机构的文件路径。

PDO::MYSQL_ATTR_SSL_CAPATH (int)

包含受信任 SSL CA 证书的目录的文件路径，这些证书存储在 PEM 格式中。

PDO::MYSQL_ATTR_SSL_CERT (int)

SSL 证书的文件路径。

PDO::MYSQL_ATTR_SSL_CIPHER (int)

一个或多个可用于 SSL 加密的允许密码列表，格式应为 OpenSSL 可识别格式。例如：DHE-RSA-AES256-SHA:AES128-SHA

PDO::MYSQL_ATTR_SSL_KEY (int)

SSL 密钥的文件路径。

PDO::MYSQL_ATTR_SSL_VERIFY_SERVER_CERT (int)

提供了一种禁用服务器 SSL 证书验证的方法。此选项仅在使用 mysqlnd 时可用。

此选项从 PHP 7.0.18 和 PHP 7.1.4 开始提供。

PDO::MYSQL_ATTR_MULTI_STATEMENTS (int)

当设置为 false 时，将禁用 PDO::prepare() 和 PDO::query() 中的多查询执行。

注意，此常量只能在构建新数据库句柄时在 driver_options 数组中使用。

运行时配置

这些函数的行为受 php.ini 中设置的影响。

以下是配置指令的简要说明。

pdo_mysql.default_socket string

设置 Unix 域套接字。如果在配置时找到了域套接字，则此值可以在编译时设置。此 ini 设置仅适用于 Unix。

pdo_mysql.debug bool

启用 PDO_MYSQL 的调试。此设置仅在 PDO_MYSQL 针对 mysqlnd 编译并在 PDO 调试模式下可用。