使用PHP构建基于YugabyteDB的云原生应用教程-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00882/article/details/148419211

使用PHP构建基于YugabyteDB的云原生应用教程

yugabyte-db yugabyte/yugabyte-db: 是 YugaByte DB 的官方仓库，一个高性能、高可扩展、分布式的 SQL 数据库，支持 PostgreSQL 兼容性。适合对分布式数据库、SQL 数据库和云原生应用的开发者。项目地址: https://gitcode.com/gh_mirrors/yu/yugabyte-db

前言

YugabyteDB是一个高性能、云原生的分布式SQL数据库，兼容PostgreSQL协议。本文将详细介绍如何使用PHP语言通过php-pgsql驱动连接YugabyteDB集群，并构建一个完整的银行账户管理应用。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

PHP运行时环境：建议使用PHP 8.1或更高版本
- macOS用户可通过Homebrew安装：brew install php
- Ubuntu/Debian用户：sudo apt-get install php
- CentOS/RHEL用户：sudo yum install php
php-pgsql驱动：
- macOS：随PHP自动安装
- Ubuntu：sudo apt-get install php-pgsql
- CentOS：sudo yum install php-pgsql

应用架构概述

我们将构建一个简单的银行账户管理系统，主要功能包括：

账户表的创建与初始化
账户数据查询
账户间转账操作

配置数据库连接

首先需要配置应用与YugabyteDB集群的连接参数：

// 数据库连接配置
define('HOST', '127.0.0.1');        // 集群主机地址
define('PORT', 5433);               // YSQL服务端口
define('DB_NAME', 'yugabyte');      // 默认数据库名
define('USER', 'yugabyte');         // 数据库用户名
define('PASSWORD', 'yugabyte');     // 数据库密码
define('SSL_MODE', 'verify-full');  // SSL连接模式
define('SSL_ROOT_CERT', '/path/to/ca.crt');  // CA证书路径

对于云上部署的YugabyteDB集群，这些参数通常可以在集群管理界面找到。

核心功能实现

1. 数据库连接

使用PDO扩展建立与YugabyteDB的连接：

function connect() {
    $conn = new PDO('pgsql:host=' . HOST . ';port=' . PORT . ';dbname=' . DB_NAME .
                    ';sslmode=' . SSL_MODE . ';sslrootcert=' . SSL_ROOT_CERT,
                    USER, PASSWORD,
                    array(PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
                          PDO::ATTR_EMULATE_PREPARES => true,
                          PDO::ATTR_PERSISTENT => true));
    return $conn;
}

2. 创建数据表

初始化银行账户表结构并插入测试数据：

function create_database($conn) {
    // 删除已存在的表（如果存在）
    $conn->exec('DROP TABLE IF EXISTS DemoAccount');
    
    // 创建账户表
    $conn->exec('CREATE TABLE DemoAccount (
                    id int PRIMARY KEY,
                    name varchar,
                    age int,
                    country varchar,
                    balance int)');
    
    // 插入初始数据
    $conn->exec("INSERT INTO DemoAccount VALUES
                    (1, 'Jessica', 28, 'USA', 10000),
                    (2, 'John', 28, 'Canada', 9000)");
}

3. 查询账户数据

实现账户数据的查询功能：

function select_accounts($conn) {
    $query = 'SELECT name, age, country, balance FROM DemoAccount';
    
    foreach ($conn->query($query) as $row) {
        printf("name=%s, age=%d, country=%s, balance=%d\n", 
               $row['name'], $row['age'], $row['country'], $row['balance']);
    }
}

4. 账户间转账

实现分布式事务处理，确保转账操作的原子性：

function transfer_money_between_accounts($conn, $amount) {
    try {
        // 开始事务
        $conn->beginTransaction();
        
        // 扣减转出账户余额
        $conn->exec("UPDATE DemoAccount SET balance = balance - " . $amount . " 
                    WHERE name = 'Jessica'");
        
        // 增加转入账户余额
        $conn->exec("UPDATE DemoAccount SET balance = balance + " . $amount . " 
                    WHERE name = 'John'");
        
        // 提交事务
        $conn->commit();
        
        echo ">>>> 成功转账 " . $amount . " 元\n";
    } catch (PDOException $e) {
        // 处理并发事务冲突
        if ($e->getCode() == '40001') {
            echo "操作因并发事务修改相同数据而中止。\n";
            echo "生产环境中应考虑添加重试逻辑。\n";
        }
        throw $e;
    }
}

应用运行流程

完整的应用执行流程如下：

try {
    // 1. 建立数据库连接
    $conn = connect();
    echo ">>>> 成功连接到YugabyteDB集群！\n";
    
    // 2. 创建数据表并初始化数据
    create_database($conn);
    echo ">>>> 成功创建DemoAccount表\n";
    
    // 3. 查询并显示账户数据
    echo ">>>> 查询账户数据：\n";
    select_accounts($conn);
    
    // 4. 执行转账操作
    transfer_money_between_accounts($conn, 800);
    
    // 5. 再次查询显示转账后的账户数据
    echo ">>>> 转账后账户数据：\n";
    select_accounts($conn);
    
} catch (PDOException $e) {
    // 错误处理
    echo "数据库错误: " . $e->getMessage() . "\n";
} finally {
    // 清理资源
    if (isset($conn)) {
        $conn = null;
    }
}