虚谷文档 v1.0.1

适用虚谷数据库版本

v12.9



适用虚谷数据库版本

v12.9


快速入门 ​

此章节将使用最简单的代码展示如何使用 XuguDB-PDO 向虚谷数据库插入查询和数据，以及展示如何通过 XuguDB-PDO 操作数值类型、字符类型和日期类型的字段以实现数值的插入和查询。

创表 ​

使用 xgconsole 或其他管理工具连接虚谷数据库实例，在 SYSTEM 库中创建此章节所依赖的表。建表语句如下：

SQL
CREATE TABLE tab_test (
    id INT AUTO_INCREMENT PRIMARY KEY,
    name VARCHAR(20),
    created DATE
);

PDO 接口中的类 ​

  • PDO 类：与连接相关，通过 new 得到
  • PDOStatement 类：与语句相关，通过 prepare 或 query 方法得到

连接数据库 ​

使用 PDO 类的构造方法连接数据库：

PHP
$pdo = new PDO("xugusql:ip=127.0.0.1;port=5138;db=SYSTEM;", "SYSDBA", "SYSDBA");

其中，第一个参数为连接串，第二个参数为用户名，第三个参数为密码。

执行 SQL 语句 ​

使用 exec 方法执行非查询语句

PHP
$res = $pdo->exec("INSERT INTO tab_test (id, name, created) VALUES(1, '张三', '2000-01-01')");
//受影响行数
echo $res;

使用 query 方法执行查询语句

PHP
$stmt = $pdo->query("SELECT * FROM tab_test");
while($row = $stmt->fetch()) {
    print_r($row);
}

完整代码 ​

PHP
//demo.php
$pdo = new PDO("xugusql:ip=127.0.0.1;port=5138;db=SYSTEM;", "SYSDBA", "SYSDBA");

//执行插入
$res = $pdo->exec("INSERT INTO tab_test (id, name, created) VALUES(1, '张三', '2000-01-01')");
echo $res;

//执行查询
$stmt = $pdo->query("SELECT * FROM tab_test");
while($row = $stmt->fetch()) {
    print_r($row);
}