vilshub/dbant

dbAnt 是一个用于数据库输入输出的 PHP 库,用于 zion light 框架中

v1.2.0 2023-06-20 20:47 UTC

This package is auto-updated.

Last update: 2024-09-20 23:34:00 UTC


README

dbAnt 是一个用于数据库输入输出的 PHP 库,用于 zion light 框架中

要求

  • 它需要 PHP 版本 5.x
  • vilshub/helpers 库

安装

它支持 composer 安装,链接为 composer require vilshub/dbant

特性

  • 支持预处理语句的单次查询执行
  • 支持预处理语句的批量查询执行

演示

单次查询执行

<?php
        //$pdo as PDO connection handler
        
        use vilshub\dbant\dbAnt;
        $dbAnt = new dbAnt($pdo);
        $sqlPrepared = "INSERT INTO cars SET
      	    name = ?,
            model = ?,
            color = ?,
            price = ?,
            available = ?";

        $data = ["Nissan", "Primera", "Blue", "3000", "30"];
        $exec =  $dbAnt->run($sqlPrepared, $data);
        if($exec["status"]){
            //suucess
        }
?>

批量查询执行

    <?php
        //$pdo as PDO connection handler
        
        use vilshub\dbant\dbAnt;
        $dbAnt = new dbAnt($pdo);
        $sqlPrepared = "INSERT INTO cars SET
      	    name = ?,
            model = ?,
            color = ?,
            price = ?,
            available = ?";

        $data = [
            array("Nissan", "Primera", "Blue", "3000", "30"),
            array("Nissan", "Primera", "Blue", "3000", "30"),
            array("Nissan", "Primera", "Blue", "3000", "30"),
            array("Nissan", "Primera", "Blue", "3000", "30"),
            array("Nissan", "Primera", "Blue", "3000", "30"),
            array("Nissan", "Primera", "Blue", "3000", "30"),
            array("Nissan", "Primera", "Blue", "3000", "30")
        ]

        $exec =  $dbAnt->batchRun($sqlPrepared, $data);
        if($exec){
            //suucess
        }
    ?>

文档

run() 方法

run 方法通过 PDO 扩展执行 SQL 语句。

语法

    $obj->run($query, [$data]) 

第二个参数 $data 是可选的,仅在需要为查询提供数据时使用。它返回以下内容

[
    "status"=>false | true,
    "rowCount"=>null | totalAffectRow,
    "lastInsertId"=>null | lastInsertedID,
    "data"=>null | fetchedResult
]

batchRun() 方法

batchRun 方法使用提供的单个 SQL 查询上的数据执行多个 SQL 查询。它通过 PDO 扩展执行 SQL 语句。

语法

$obj->batchRun($query, $data)

第二个参数 $data 必须是数值数组,每个数组包含要执行查询的值。成功执行批量操作时返回 TRUE。

此库的更全面文档将很快提供,您可以 关注 此仓库以获取更新。