摘要：是一款為快速開發而設計的框架加星請點這里。對進行了封裝，使開發者可以更方便的編寫正確和安全的。下面將繼續上一篇快速開發接口的示例，介紹的使用。配置可以通過依賴注入的方式，對數據庫進行配置。

PhpBoot 是一款為快速開發 RESTful API 而設計的PHP框架（加星請點這里>>>PbpBoot Github<<<）。

PhpBootDB 對PDO進行了封裝，使開發者可以更方便的編寫正確和安全的 SQL。下面將繼續上一篇: 快速開發 RESTful 接口的示例，介紹PhpBootDB的使用。

可以通過依賴注入的方式，對數據庫進行配置。

在需要數據庫的類中加入依賴注入代碼：

use PhpBootDBDB;
use PhpBootDITraitsEnableDIAnnotations;

class Books
{
    use EnableDIAnnotations; //啟用通過@inject標記注入依賴

    /**
     * @inject
     * @var DB
     */
    private $db;
    
    public function getBooks()...
}

框架在實例化Books后，根據@inject注釋, 自動給屬性$db賦值，其邏輯等價于:

$books->db = $app->get(DB::class);

修改數據庫配置

在 config.php 中加入以下配置（數據庫地址等需根據實際情況修改）：

"DB.connection"=> "mysql:dbname=phpboot-example;host=127.0.0.1",
"DB.username"=> "root",
"DB.password"=> "root",
"DB.options" => [],

下面將通過實現 createBook、deleteBook、updateBook、findBooks 方法，演示insert、delete、update、select 的使用。

public function createBook(Book $book)
{
    $newId = $this->db->insertInto("books")
        ->values([
            "name"=>$book->name,
            "brief"=>$book->brief,
            ...
        ])
        ->exec()
        ->lastInsertId(); 
    return $newId;
}

public function deleteBook($id)
{
    $this->db->deleteFrom("books")
        ->where(["id"=>$id])
        ->exec();
}

public function updateBook(Book $book)
{
    $this->db->update("books")
        ->set([
            "name"=>$book->name,
            "brief"=>$book->brief,
            ...
        ])
        ->where(["id"=>$book->id])
        ->exec(); 
}

public function findBooks($name, $offsit, $limit)
{
    $books = $this->db->select("*")
        ->from("books")
        ->where("name LIKE ?", "%$name%")
        ->orderBy("id")
        ->limit($offsit, $limit)->get();
        
    return $books;
}

上述示例展示了PhpBootDB的基礎用法，PhpBootDB同時也支持更復雜的SQL。

類似 SQL WHERE a=1 OR (b=2 and c=3), 可以以下代碼實現:

->where(["a"=>1])
->orWhere(function(ScopedQuery $query){
    $query->where(["b"=>2, "c"=>3])
})

上面例子中，ScopedQuery 中還能再嵌套 ScopedQuery。

$db->select("books.*", DB::raw("authors.name as author"))
    ->from("books")
    ->where(["books.id"=>1])
    ->leftJoin("authors")->on("books.authorId = authors.id")
    ->get()

使用PDO時，WHERE IN的預處理方式很不方便，需要為IN的元素預留數量相等的?, 比如：

$pdo->prepare(
    "SELECT * FROM table WHERE a IN (?,?,?)"
)->execute([1,2,3])

而使用PhpBootDB可以解決這個問題：

$db->select()->from("table")->where("a IN (?)", [1,2,3]);

默認情況下，框架會對輸入做轉換, 如會在表名和列名外加上 `` ，會把變量作為綁定處理，比如下面的語句

$db->select("count(*) AS count")
    ->from("table")
    ->where(["time"=>[">"=>"now()"]]);

等價 的 SQL：

SELECT `count(*) AS count` FROM `table` where `time` > "now()"

如果希望框架不做轉換，需要使用DB::raw(),比如：

$db->select(DB::raw("count(*) AS count"))
    ->from("table")
    ->where(["time"=>[">"=>DB::raw("now()")]]);

與下面 SQL 等價

SELECT count(*) AS count FROM `table` where `time` > now()

下面代碼演示子查詢用法：

$parent = $db->select()->from("table1")->where("a=1");
$child = $db->select()->from($parent);

與下面 SQL 等價

SELECT * FROM (SELECT * FROM `table1` WHERE a=1)

$db->transaction(
    function(DB $db){
        $db->update("table1")->...
        $db->update("table1")->...
    }
)

事務允許嵌套，但只有最外層的事務起作用，內部嵌套的事務與最外層事務將被當做同一個事務。

PhpBoot 為DB 類定義了默認的構造方式，形式如下：

DB::class => DIfactory([DB::class, "connect"])
    ->parameter("dsn", DIget("DB.connection"))
    ->parameter("username", DIget("DB.username"))
    ->parameter("password", DIget("DB.password"))
    ->parameter("options", DIget("DB.options")),

所以如果你的業務只使用連接一個數據庫，只需要對DB.connection, DB.username ,DB.password, DB.options進行配置即可。但有的時候可能需要對在應用中連接不同的數據庫，這時可以通過依賴注入配置多個庫，如：

先配置另一個數據庫連接

"another_db" => DIfactory([DB::class, "connect"])
    ->parameter("dsn", "mysql:dbname=phpboot-example;host=127.0.0.1")
    ->parameter("username", "root")
    ->parameter("password", "root")
    ->parameter("options", [])

在需要的地方注入此連接

use PhpBootDB;

class Books
{
    /**
     * @inject another_db
     * @var DB
     */
    private $db2;
}

幫助和文檔

在線文檔

QQ 交流群:185193529

本人郵箱 caoyangmin@gmail.com