PHP 8.0 连接 PolarDB 2.0（MySQL 兼容版）需使用 mysqli 或 PDO_MySQL 驱动，确认已启用 pdo_mysql 和 mysqli 扩展，连接时使用标准 MySQL 协议参数，并注意 SSL 配置、白名单、字符集（推荐 utf8mb4）及 PHP 8.0 的严格类型处理。
PHP8.0 连接 PolarDB 2.0 需要什么驱动？
PolarDB 2.0（MySQL 兼容版）本质是 MySQL 协议，所以 PHP8.0 不需要专用 SDK，直接用 mysqli 或 PDO_MySQL 即可。但必须确认底层已启用对应扩展——mysqli 和 pdo_mysql 在 PHP8.0 中默认启用，但某些精简镜像（如 Alpine + php:8.0-cli）可能未安装。
验证方式：
php -m | grep -E '^(mysqli|pdo_mysql)$'
若无输出，需安装：
- Debian/Ubuntu：
apt-get install php-mysqli php-pdo-mysql - Alpine：
apk add php80-mysqli php80-pdo_mysql（注意版本前缀） - macOS（Homebrew + php@8.0）：
brew install php@8.0-mysql
连接字符串写法和常见报错原因
PolarDB 2.0 的连接参数与标准 MySQL 完全一致，但容易因网络或权限配置失败。典型错误包括：Connection refused（端口不通）、Access denied（账号权限不足）、SSL connection error（强制 SSL 但未配证书）。
推荐连接方式（PDO，带错误处理）：
$dsn = 'mysql:host=your-cluster-id-1234567890.region.polardb.rds.aliyuncs.com;port=3306;dbname=testdb;charset=utf8mb4';
try {
$pdo = new PDO($dsn, 'username', 'password', [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
]);
} catch (PDOException $e) {
// 注意：PolarDB 默认不支持旧式密码插件，务必用 mysql_native_password
error_log('DB connect failed: ' . $e->getMessage());
}
关键点：
- host 必须是 PolarDB 控制台提供的「集群地址」或「读写分离地址」，不是内网 IP
- port 默认 3306，但部分专有云环境可能为 3307，请以控制台「数据库连接」页为准
- 若开启 SSL（控制台可选），需额外加
&sslmode=require并挂载 CA 证书（见下节） - 账号需在 PolarDB 控制台「账号管理」中创建，并授权到目标数据库
启用 SSL 连接时的坑
PolarDB 控制台若开启「SSL 连接强制」，则 PHP 必须提供 CA 证书并启用验证，否则报错：SQLSTATE[HY000] [2002] SSL connection error 或 SSL operation failed。
立即学习“PHP免费学习笔记（深入）”；
操作步骤：
- 从阿里云控制台下载
aliyun-root-ca.pem（路径建议放/etc/ssl/certs/或项目config/目录） - PDO 连接时追加 SSL 选项：
$options = [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::MYSQL_ATTR_SSL_CA => '/path/to/aliyun-root-ca.pem',
PDO::MYSQL_ATTR_SSL_CERT => null,
PDO::MYSQL_ATTR_SSL_KEY => null,
];
$pdo = new PDO($dsn, $user, $pass, $options);
注意：
-
PDO::MYSQL_ATTR_SSL_CA是必须项；CERT和KEY非必须（PolarDB 不要求客户端证书） - 证书路径必须为绝对路径，且 PHP 进程有读取权限（Docker 中常因挂载遗漏导致失败）
- 若用
mysqli，需调用mysqli_ssl_set()，且必须在mysqli_real_connect()前设置
PHP8.0 特有兼容性注意点
PHP8.0 引入了严格类型和错误处理变化，连接层虽无大改，但几个细节易踩坑：
-
mysqli_connect()返回mysqli|false，PHP8.0 默认开启严格模式后，若未判断 false 直接调用方法会报Fatal error: Uncaught Error: Call to a member function query() on bool -
PDO::__construct()在 PHP8.0 中对空密码更敏感，若密码为空字符串，某些旧版 libmysqlclient 会拒绝连接（建议显式传''而非省略） - 字符集推荐用
utf8mb4，PolarDB 2.0 默认支持；但若 DSN 中写成charset=utf8（3 字节版本），插入 emoji 会失败 - Docker 环境下，
curl或openssl版本过低可能导致 SSL 握手失败（尤其 Alpine 3.14+ 的 musl libc 与 OpenSSL 3 兼容问题）
最常被忽略的是：PolarDB 控制台「白名单」默认只允许内网访问，公网测试必须手动添加 IP 或 0.0.0.0/0（仅限临时调试）。
