如何写一个属于自己的数据库封装(1) - 基本思路(修订版)

下一期 如何写一个属于自己的数据库封装(2) - 数据库连接

写在前头

1. 依然在前进的菜鸟一只，错误什么的请轻喷指出
2. 对于数据库连接由于较浅的工作经验所以无法完全覆盖，较复杂的query可能会有意想不到的bug
3. 所以本系列只提供思路，成熟稳定的数据库封装有请自行搜索
4. 编写该系列的初衷就是为了抛砖引玉， 在每一节的后端，我都会提出一些个人疑问(或无)，希望能引出大神为我解答迷惑
5. 使用的php版本为7.0+，该系列并不向下兼容，还在5.6版本的童鞋们快过来玩呀
6. 数据库封装参考了laravel的源代码， 如有雷同， 不是巧合

最终效果

假设我们有一个表,名'Actor', 经过简单设置, 可以直接如下调用

$a = Actor::select('first_name', 'last_name')
        ->where('first_name', 'NICK')
        ->where('last_name', 'WAHLBERG')
        ->first()
var_dump($a);

返回格式

object(Actor)[11]
  public 'first_name' => string 'NICK' (length=4)
  public 'last_name' => string 'WAHLBERG' (length=8)

返回的数据依然可操作(update/delete)

$a->update(...);
$a->delete();

更多例子可以查看第4期 - 如何写一个属于自己的数据库封装(4) - 查询 - 入门篇用法

本期知识点

【PHP】PDO操作数据库

常见的数据库连接写法

对php有一定了解的人都知道，相比已被淘汰的mysql或取而代之的mysqli， pdo 可以避免SQL注入式攻击， 更安全， 而且面向对象， 所以请看下方pdo例子

<?php
$driver='mysql'; //数据库类型

$host='localhost'; //数据库主机名

$db = 'sakila'; //数据库名称

$username='root'; //数据库连接用户名

$password=''; //数据库密码

$dsn="$driver:host=$host;dbname=$db";

try {
    $pdo= new PDO($dsn, $username, $password); //初始化一个PDO对象

    $sql = "select * from actor";

    $res = $pdo->query($sql); // 从actor中获取所有数据

    foreach($res as $row)
        echo $row['first_name']."<br>";
} catch (PDOException $e) {
    die($e->getMessage());
}

例子中的代码看起来非常简洁, 然而, 这么做真的好吗?

很多菜鸟因为经验或自身的原因, 在实现业务逻辑时并未考虑过维护代码, 要不重复性代码全写在一块, 要不随便写个函数概括进去, 这一类代码, 是导致经手人辞职的最大元凶

代码太烂了我看不下去

因此, 考虑到一个项目长远开发, 我们需要一个封装类来减少代码的重复性， 就像平时自行写的一些辅助函数， 不过封装类略微进阶而已。

基本思路

那么，应该怎么写呢？
平时我们要简略一些代码， 都会自行编写一些辅助函数，比如我个人有个不好的习惯，不喜欢用编辑器的调试功能（画外音：我用的是sublime text 3），那么debug的时候一开始都是这么写的

$a = "is bug";
die(var_dump($a)); // 输出变量并且停止运行之后的代码
/***从xdebug得知bug出现在这一行，所以查看上一行的逻辑与数据 ***/

die(var_dump())的出场率略高， 因此我将它们写成了一个辅助函数

function dd($var) {
    die(var_dump($var));
}

同样道理，在数据库读取的时候，select的出场率极高， 所以简单的包裹一下

function select($pdo, $table, $require, $where = []) {
    $w = [];

    // 将搜索条件转化为数据库命令能接受的格式
    foreach ($where as $key => &$val)
        $w[] = "$key = '$val'";

    // 有时候并不需要条件，仅仅将所有数据取出，因此$where默认为空
    if(!empty($w))
        $w = "where ".implode(', ', $w);
    else
        $w = "";

    // 生成sql query
    $sql = "select $require from $table $w";

    // 将已生成的query带入pdo实例
    $res = $pdo->query($sql);

    // 返回结果
    return $res->fetchAll();
}

例子

select($pdo, 'actor', '*', ['first_name'=>'PENELOPE'])
/**
  * 生成sql query => select * from actor where first_name = 'PENELOPE'
**/

总结一下， 数据库封装浅显的形容就是将参数带入辅助函数，让其自动生成SQL命令。

数据库封装的架构

主要分成四个文件

• Connector.php - 负责与数据库的通信， 请求与返回数据库数据
• Model.php - 入口文件，作为一个模型, 定义表的各种属性(如主键, 表名等等)， 并接受请求， 返回数据库数据
• Grammar.php - 将Builder存储的请求转化为SQL语句
• Builder.php - 核心文件， 存储Model的请求，调用Grammar编译SQL语句， 与参数变量一并送往Connector以获取数据库数据，再返还给Model

架构可能解释得不太好，但没关系， 接下来会慢慢一个个的深入解释

大致如此， 如果可以的话点个赞，或在下方评论区讨论， 只有反馈才能推动一个懒癌晚期病患继续前行。

下一期 如何写一个属于自己的数据库封装(2) - 数据库连接