PhpBoot 入门（二） 面向对象的方式编写 SQL

PhpBoot 是一款为快速开发 RESTful API 而设计的 PHP 框架（加星请点这里>>>PbpBoot Github<<<）。

PhpBoot\DB 对 PDO 进行了封装，使开发者可以更方便的编写正确和安全的 SQL。下面将继续上一篇: 快速开发 RESTful 接口的示例，介绍PhpBoot\DB的使用。

配置

可以通过依赖注入的方式，对数据库进行配置。

1. 在需要数据库的类中加入依赖注入代码：

   use PhpBoot\DB\DB; use PhpBoot\DI\Traits\EnableDIAnnotations; class Books { use EnableDIAnnotations; //启用通过 @inject 标记注入依赖 /** * @inject * @var DB */ private $db; public function getBooks()... } 

   框架在实例化Books后，根据@inject注释, 自动给属性$db赋值，其逻辑等价于:

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

2. 修改数据库配置

   在 config.php 中加入以下配置（数据库地址等需根据实际情况修改）：

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

编写 SQL

下面将通过实现 createBook、deleteBook、updateBook、findBooks 方法，演示 insert、delete、update、select 的使用。

INSERT

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

DELETE

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

UPDATE

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

SELECT

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

高级用法

上述示例展示了PhpBoot\DB的基础用法，PhpBoot\DB同时也支持更复杂的 SQL。

复杂 WHERE

类似 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。

JOIN

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

WHERE ... IN ...

使用PDO时，WHERE IN的预处理方式很不方便，需要为IN的元素预留数量相等的?, 比如：

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

而使用PhpBoot\DB可以解决这个问题：

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

使用 SQL 函数

默认情况下，框架会对输入做转换, 如会在表名和列名外加上``，会把变量作为绑定处理，比如下面的语句

$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 => \DI\factory([DB::class, 'connect']) ->parameter('dsn', \DI\get('DB.connection')) ->parameter('username', \DI\get('DB.username')) ->parameter('password', \DI\get('DB.password')) ->parameter('options', \DI\get('DB.options')), 

所以如果你的业务只使用连接一个数据库，只需要对DB.connection, DB.username ,DB.password, DB.options进行配置即可。但有的时候可能需要对在应用中连接不同的数据库，这时可以通过依赖注入配置多个库，如：

1. 先配置另一个数据库连接

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

2. 在需要的地方注入此连接

   use PhpBoot\DB; class Books { /** * @inject another_db * @var DB */ private $db2; } ``` 

帮助和文档

• 在线文档
• QQ 交流群:185193529
• 本人邮箱 [email protected]