PHP8.3如何用PHP连接OceanBase3.0数据库-php教程-PHP中文网

php8.3连接oceanbase 3.0无需专用驱动，直接使用已启用的mysqli或pdo_mysql扩展即可；需确保租户为mysql模式、端口2883、用户名格式为user@tenant#cluster、数据库名格式为tenant@cluster，并禁用pdo预处理模拟以保障decimal等类型精度。

php8.3如何用php连接oceanbase3.0数据库

PHP8.3 连接 OceanBase 3.0 需要什么驱动？

OceanBase 3.0 兼容 MySQL 协议（5.6/5.7），所以 PHP8.3 不需要专用驱动，直接用 mysqli 或 PDO_MySQL 即可。但必须确认两点：一是 OceanBase 的 MySQL 模式租户已启用；二是 PHP 编译时启用了对应扩展——mysqli 和 pdo_mysql 都得加载，缺一不可。

常见错误现象：Class 'PDO' not found 或 Call to undefined function mysqli_connect()，本质是扩展没开，不是 OceanBase 本身的问题。

检查扩展是否启用：php -m | grep -E "mysqli|pdo_mysql"
若缺失，在 php.ini 中取消注释：extension=mysqli 和 extension=pdo_mysql
重启 PHP-FPM 或 Web 服务器（如 Apache/Nginx）

连接字符串怎么写？端口和数据库名有啥讲究？

OceanBase 3.0 默认监听 2883 端口（非标准 MySQL 的 3306），且必须指定租户名作为数据库名的一部分——格式为 tenant_name@cluster_name，例如租户 test_tenant 在集群 obcluster 下，完整数据库名为 test_tenant@obcluster。

不按这个格式填，会报错：Access denied for user 'xxx'@'xxx' (using password: YES) 或 Unknown database 'xxx'，其实不是密码错，而是租户上下文没识别到。

amphp

使用 AMPHP 框架编写非阻塞异步 PHP 代码，依赖 revolt/event-loop、amphp/amp ^3 及完整 amphp/* 生态（http‑server、http‑client 等）。

下载

mysqli 示例：

$conn = mysqli_connect('127.0.0.1', 'root@test_tenant@obcluster', 'password', '', 2883);

PDO DSN 示例：

$dsn = 'mysql:host=127.0.0.1;port=2883;dbname=test_tenant@obcluster;charset=utf8mb4';

用户名必须带租户上下文，不能只写 root；密码是租户下用户的密码，不是 OBProxy 或 sys 租户的

PHP8.3 的严格类型和 OceanBase 字段类型兼容吗？

PHP8.3 启用严格类型后，OceanBase 返回的 TINYINT(1)（常被用作布尔）会被 mysqli_fetch_assoc() 当成整数 0/1，而非 bool；DECIMAL 字段默认以字符串返回（避免精度丢失），这点比老版本更安全，但如果你代码里直接做算术比较（比如 $row['amount'] == 100.0），可能因类型不一致失效。

建议显式转换：(bool) $row['is_valid'] 或 floatval($row['price'])
使用 PDO::ATTR_EMULATE_PREPARES => false，确保原生预处理生效，避免某些 DECIMAL 四舍五入异常
OceanBase 的 JSON 类型字段，PHP8.3 会原样返回字符串，需手动 json_decode($row['data'], true)

连接池和长连接要注意什么？

OceanBase 官方不推荐 PHP 层做连接池（无内置支持），但 PHP8.3 的 mysqli 支持持久连接，用 mysqli_pconnect() 或在 DSN 加 persist: 前缀。不过要注意：OceanBase 的会话变量（如 @tx_isolation）不会自动重置，持久连接复用时可能残留上一个请求的状态。

避免在持久连接中依赖会话级 SET 语句（如 SET NAMES utf8mb4），应改用连接初始化 SQL 或客户端字符集参数
如果用 Swoole 或 RoadRunner，务必在每次请求开始时调用 $pdo->exec("RESET SESSION") 清理会话上下文
OceanBase 的连接空闲超时默认是 30 分钟（wait_timeout），PHP 层需配合 mysqli.reconnect = On（仅 CLI 有效）或应用层心跳检测

租户权限、网络 ACL、OBProxy 转发配置这些不在 PHP 控制范围内，但连不上时，先 telnet 通 2883 再查 PHP 配置，顺序别反了。