Points clés de ce numéro
Compréhension approfondie des diverses fonctions auxiliaires de fonction php Syntaxe de base PHP : Fonction
Comprendre ce qu'est la fonction Paramètres variables, ...$var, introduction aux nouvelles fonctionnalités de PHP5.6
compactUtilisation de la fonction PHP : compact - Manuel
listUtilisation de la fonction PHP : liste - Manuel
PHPMéthode magique
Avant de commencer
Ce problème concerne SQL. Parce que la complexité et la corrélation entre les instructions de requête dans plusieurs classes ne sont pas aussi simples que le chapitre Connector, cette fois nous devons expliquer la classe Builder, la classe Grammar et le Modèle classe en une seule fois. Bien sûr, interrogez simplement la partie
Builder.php
<?php
/**
* 请求构建器
*/
class Builder {
// 连接数据库, Connector类
protected $connector;
// 生成SQL语法，Grammar类
protected $grammar;
// 连接的Model, Model类
protected $model;
// SQL查询语句中条件的值
// 虽然列出了全部, 但本教程只实现了where,其余的因为懒(理直气壮),请自行实现, 逻辑和where函数大致
protected $bindings = [
'select' => [],
'join' => [],
'where' => [],
'having' => [],
'order' => [],
'union' => [],
];
// select 语法想要查看的字段
public $columns;
// 过滤重复值
public $distinct = false;
// 需要查询的表
public $from;
// 所有join 语法
public $joins;
// 所有where 语法
public $wheres;
// group 语法
public $groups;
// having 语法
public $havings;
// order by 语法
public $orders;
// 限制数据库返回的数据量, limit语法
public $limit;
// 需要略过的数据量, offset语法
public $offset;
// 数据写保护， 开启后该条数据无法删除或改写
public $writeLock = false;Copier après la connexion
Vient ensuite la fonction
where() a deux méthodes d'appel différentes
Les fonctions suivantes ont deux méthodes d'appel, veuillez comprendre par vous-même à partir de la logique du code suivant
sous forme de paramètres, la valeur par défaut est '='
Actor::select('first_name', 'last_name')
->where('first_name', 'NICK')
->where('last_name','!=', 'WAHLBERG')
->first()Copier après la connexion
sous forme de tableaux, ceci La méthode a des limites, elle ne peut faire correspondre que des champs égaux à des valeurs Situation
Actor::select('first_name', 'last_name')
->where(['first_name'=> 'NICK', 'last_name'=> 'WAHLBERG'])
->first()Copier après la connexion
Regardez ensuite le code
public function where($column, $operator = null, $value = null, $boolean = 'and') {
// 判定$column是否为数组
if (is_array($column)) {
// 如果是数组, 循环再调用本函数,where()
foreach ($column as $key => $value)
$this->where($key, "=", $value, $boolean);
}else {
// 反之, 判定参数数量和$value是否为空, 如果为真,这意味着用户省略了'=',自动添加
if(func_num_args() == 2 || is_null($value)) list($operator, $value) = ['=', $operator];
// 最简单原始的条件查询, 所以$type值为Basic
$type = "Basic";
// 将处理过的条件存入$wheres
$this->wheres[] = compact('type', 'column', 'operator', 'value', 'boolean');
// 将字段需要匹配的值存入$bindings中的where
$this->addBinding($value, 'where');
}
// 返回Builder实例
return $this;
}Copier après la connexion
- diverses variations de où
// 所有逻辑同where(), 不过这是or where
public function orWhere($column, $operator = null, $value = null) {
return $this->where($column, $operator, $value, 'or');
}
/**
* where in 语法, 字段匹配多个值
* @param string $column 字段
* @param array $values 一组字段需匹配的值
* @param string $boolean 默认为and
* @param boolean $not 默认为假, 真为排除所有$value里的数据
* @return Builder 返回Builder实例
*/
public function whereIn($column, $values, $boolean = 'and', $not = false) {
// 判定条件查询的类型, false = where in ($value),true = where not in ($value)
$type = $not ? 'NotIn' : 'In';
// 将条件存入$wheres
$this->wheres[] = compact('type', 'column', 'values', 'boolean');
// 循环将字段需要匹配的值存入$bindings中的where
foreach ($values as $value)
$this->addBinding($value, 'where');
// 返回Builder实例
return $this;
}
// 所有逻辑同whereIn(), 不过这是or where in
public function orWhereIn($column, $values) {
return $this->whereIn($column, $values, 'or');
}
// 所有逻辑同whereIn(), 不过这是and where not in
public function whereNotIn($column, $values, $boolean = 'and') {
return $this->whereIn($column, $values, $boolean, true);
}
// 所有逻辑同whereNotIn(), 不过这是or where not in
public function orWhereNotIn($column, $values) {
return $this->whereNotIn($column, $values, 'or');
}
/**
* where $coulmn is null 语法, 搜索字段为空的数据
* @param string $column 字段
* @param string $boolean 默认为and
* @param boolean $not 默认为假, 真为排除所有字段为空的数据
* @return Builder 返回Builder实例
*/
public function whereNull($column, $boolean = 'and', $not = false) {
// 判定条件查询的类型, false = where $column is null,true = where $column is not null
$type = $not ? 'NotNull' : 'Null';
// 将条件存入$wheres
$this->wheres[] = compact('type', 'column', 'boolean');
// 返回Builder实例
return $this;
}
// 所有逻辑同whereNull(), 不过这是or where $column is null
public function orWhereNull($column) {
return $this->whereNull($column, 'or');
}
// 所有逻辑同whereNull(), 不过这是and where $column is not null
public function whereNotNull($column, $boolean = 'and') {
return $this->whereNull($column, $boolean, true);
}
// 所有逻辑同whereNotNull(), 不过这是or where $column is not null
public function orWhereNotNull($column) {
return $this->whereNotNull($column, 'or');
}Copier après la connexion
- orderBy - instruction order by, détermine la disposition des données renvoyées
/**
* @param string/array $column 字段
* @param string $direction 排序,默认为asc, 顺序
* @return Builder 返回Builder实例
*/
public function orderBy($column, $direction = 'asc') {
// 局限性在于必须声明顺序或逆序
if(is_array($column)) {
foreach ($column as $key => $value)
$this->orderBy($key, $value);
}else {
// 简单判定后直接存入$orders, $direction输入错误不跳错误直接选择顺序
$this->orders[] = [
'column' => $column,
'direction' => strtolower($direction) == 'desc' ? 'desc' : 'asc',
];
}
// 返回Builder实例
return $this;
}Copier après la connexion
tableaux multidimensionnels Qu'est-ce que cela signifie ? Il s'agit de transformer un tableau multidimensionnel en un tableau unidimensionnel
function array_flatten(array $array) {
$return = array();
array_walk_recursive($array, function($a) use (&$return) {
$return[] = $a;
});
return $return;
}Copier après la connexion
$a = array('this', 'is', array('a', 'multidimentional', array('array') ), 'to', 'make', 'the', 'tutotal', array('more', 'easier', 'to', 'understand') );
dd(array_flatten($a));Copier après la connexion
array (size=13)
0 => string 'this' (length=4)
1 => string 'is' (length=2)
2 => string 'a' (length=1)
3 => string 'multidimentional' (length=16)
4 => string 'array' (length=5)
5 => string 'to' (length=2)
6 => string 'make' (length=4)
7 => string 'the' (length=3)
8 => string 'tutotal' (length=7)
9 => string 'more' (length=4)
10 => string 'easier' (length=6)
11 => string 'to' (length=2)
12 => string 'understand' (length=10)
Copier après la connexion
- groupBy - regrouper par instruction, intégrer les données
/**
* @param string/array $groups 字段
* @return Builder 返回Builder实例
*/
public function groupBy(...$groups) {
if(empty($this->groups)) $this->groups = [];
$this->groups = array_merge($this->groups, array_flatten($groups));
// 返回Builder实例
return $this;
}Copier après la connexion
- limiter - limiter la quantité de données renvoyé, sqlsrv est écrit différemment, si vous êtes intéressé, vous pouvez laisser un message
public function limit($value) {
// 如果$value大于零这条函数才生效
if ($value >= 0) $this->limit = $value;
return $this;
}
// limit函数的别名, 增加函数链的可读性
public function take($value) {
return $this->limit($value);
}Copier après la connexion
- offset - ignorer la quantité de données spécifiée La méthode d'écriture de sqlsrv est différente. vous êtes intéressé, vous pouvez laisser un message
public function offset($value) {
// 如果$value大于零这条函数才生效
if ($value >= 0) $this->offset = $value;
return $this;
}
// offset函数的别名, 增加函数链的可读性
public function skip($value) {
return $this->offset($value);
}Copier après la connexion
- obtenir - lire les données de la base de données
Voici le point culminant de toutes les fonctions précédentes qui renvoient des instances de Builder, ce qui signifie qu'elles peuvent être modifiées.
Ceci est un résumé, les requêtes de chaîne de fonctions frontales sont traitées ensemble
// 返回一组数据库数据, 可以在这里设定想返回的字段, 但是select()的优先度最高
public function get($columns = ['*']) {
// 如果Builder的$columns依然为空, 那么就用该函数的$columns, 反之则使用select()所声明的字段
if (is_null($this->columns)) $this->columns = $columns;
// 如果Builder的$orders依然为空, 那么就默认第一个字段顺序
// 发现一个莫名的bug, 可能是我理解错了, 不加 order by 1数据返回竟然不是按照主键(第一个字段)排序
// 所以以防万一加一个默认
if (is_null($this->orders)) $this->orderBy(1);
// 将Grammar类生成的语句,和处理过的字段所对应的值,都交给Connector类, 让它与数据库进行通信,返回数据
// 注意这里的三个函数
// read() 不用说Connector篇介绍过了
// compileSelect()是用来编译生成查询语句
// getBindings()用来获取收在$bindings中条件的值, 下方会有说明
$results = $this->connector->read($this->grammar->compileSelect($this), $this->getBindings());
// 返回一组数据库数据,如果查询为空,返回空数组
// cast()下方会有说明
return $this->cast($results);
}
// get函数的别名, 增加函数链的可读性
public function all($columns = ['*']) {
return $this->get($columns);
}Copier après la connexion
- getBindings - Renvoie les valeursdans tous les $bindings
public function getBindings() {
// 抚平多维数组成一维数组后再返回
return array_flatten($this->bindings);
}Copier après la connexion
- cast - Convertit le type de données renvoyé en sa propre sous-classe Model
Dans le chapitre sur les idées de base, la section sur l'effet final a mentionné l'opérabilité des données. Le code de base est ici
. Si vous ne comprenez pas cela, cela n'a pas d'importance. Ignorez-le pour l'instant. Vous le comprendrez après avoir lu Model.php (n'est-ce pas ?)
public function cast($results){
// 获取Model子类的名称
$class = get_class($this->model);
// 新建一个Model子类
$model = new $class();
// 如果获得的数据库数据是数组
if (gettype($results)=="array") {
$arr = [];
// 循环数据
foreach ($results as $result)
// 再调用本函数
$arr[] = $this->cast($result);
// 返回经过转化的数据数组
return $arr;
// 如果获得的数据库数据是对象
}elseif(gettype($results)=="object"){
// 存入数据对象
$model->setData($results);
// 加入主键或unique key以实现数据的可操作性
// 如果表存在主键和返回的数据中有主键的字段
if($model->getIdentity() && isset($results->{$model->getIdentity()})) {
$model->where($model->getIdentity(), $results->{$model->getIdentity()});
// 如果表存在unique key和返回的数据中有unique key的字段
}elseif($model->getUnique() && array_check($model->getUnique(),$results)) {
foreach ($model->getUnique() as $key)
$model->where($key, $results->$key);
// 改写和删除操作仅仅在符合以上两种条件其中之一的时候
// 反之, 开启写保护不允许改写
}else {
// 其实还可以考虑直接复制query
// 但变数太多干脆直接一棍子打死
$model->getBuilder()->writeLock = true;
}
// 返回该实例
return $model;
}
// 如果转化失败返回false
return false;
}Copier après la connexion
- d'abord -. ne récupère que le premier élément de données, il renvoie donc un objet, tandis que get renvoie un tableau contenant plusieurs objets
/**
* @param array $columns 如果Builder的$columns依然为空, 那么就用该函数的$columns, 反之则使用select()所声明的字段
* @return boolean/Model 查询为空返回false, 反之则返回附带数据的表类
*/
public function first($columns = ['*']) {
$results = $this->take(1)->get($columns);
return empty($results) ? false : $results[0];
}Copier après la connexion
- setModel - définition de l'instance du modèle
public function setModel(Model $model) {
$this->model = $model;
return $this;
}Copier après la connexion
Grammar.php
- Compile selon aux valeurs traitées stockées dans les attributs de l'instance Builder
- La compilation se fait lentement par une partie de la syntaxe, et enfin elle est résumée
<?php
/**
* 数据库语法生成
*/
class Grammar {
// 构建查询语句所可能出现的各种SQL语法
// 注意, 它们的顺序是对应着各自在SQL语句中合法的位置
// sqlsrv略微不同
protected $selectComponents = [
'distinct',
'columns',
'from',
'joins',
'wheres',
'groups',
'orders',
'limit',
'offset',
];Copier après la connexion
- concaténer - exclure les valeurs vides possibles après la compilation, puis concaténer l'intégralité de l'instruction SQL
protected function concatenate($segments) {
return implode(' ', array_filter($segments, function ($value) {
return (string) $value !== '';
}));
}Copier après la connexion
- compileSelect - compiler l'instruction de requête SQL
// 还记得Builder->get()中的compileSelect()吗?
public function compileSelect(Builder $query) {
// concatenate()排除编译后可能存在空的值,然后连接整句SQL语句
// 去掉可能存在的前后端空格再返回
return trim($this->concatenate($this->compileComponents($query)));
}Copier après la connexion
- compileComponents - boucle $selectComponents, compilez localement l'instruction correspondante selon une syntaxe différente
protected function compileComponents(Builder $query) {
$sql = [];
// 循环$selectComponents
foreach ($this->selectComponents as $component) {
// 如果Builder实例中对应的函数曾经被调用,那意味着对应的语法非空
if (!is_null($query->$component)) {
$method = 'compile'.ucfirst($component);
// 编译该语法并将之收入$sql
$sql[$component] = $this->$method($query, $query->$component);
}
}
// 返回$sql数组
return $sql;
}Copier après la connexion
- compileDistinct - Compilez l'instruction distincte
protected function compileDistinct(Builder $query, $distinct) {
return $distinct ? 'select distinct' : 'select';
}Copier après la connexion
- compileLimit - Instruction de limite de compilation
protected function compileLimit(Builder $query, $limit) {
return "limit $limit";
}Copier après la connexion
- compileOffset - Instruction de compensation de compilation
protected function compileOffset(Builder $query, $offset) {
return "offset $offset";
}Copier après la connexion
- compileColumns - compilez les champs à interroger
protected function compileColumns(Builder $query, $columns) {
return implode(', ', $columns);
}Copier après la connexion
- compileFrom - compilez et générez des noms de table
protected function compileFrom(Builder $query, $table) {
return 'from '.$table;
}Copier après la connexion
- compileJoins - Compiler l'instruction de jointure
protected function compileJoins(Builder $query, $joins) {
$sql = [];
foreach ($joins as $join) {
// 如果存在多个副键和主键
if(is_array($join->foregin) && is_array($join->primary)) {
$on = [];
// 循环键的数量, 将之与对应的主键组合
for($i=0; $i<sizeof($join->foregin); $i++)
$on[] = $join->foregin[$i]." = ".$join->primary[$i];
// 最后再将所有句子用and连接
$on = implode(' and ', $on);
} else {
//反之, 直接连接即可
$on = "$join->foregin = $join->primary";
}
// 附上join的类型和副表
$sql[] = trim("{$join->type} join {$join->table} on $on");
}
// 连接再返回
return implode(' ', $sql);
}Copier après la connexion
- compileWheres - Compiler l'instruction Where
protected function compileWheres(Builder $query) {
$sql = [];
// 类似与compileComponents(), 循环Builder实例中的$wheres
foreach ($query->wheres as $where) {
// 根据不同的$type来进行编译
$method = "where{$where['type']}";
// 返回的部分语句先收入数组
$sql[] = $where['boolean'].' '.$this->$method($query, $where);
}
// 最后将$sql数组连接起来, 删掉最前面的and或or在返回
return 'where '.preg_replace('/and |or /i', '', implode(" ", $sql), 1);
}Copier après la connexion
- whereBasic - Compiler l'utilisation la plus basique de Where
protected function whereBasic(Builder $query, $where) {
// 检测$where[column]是否存在小数点
// 是, 就意味着前缀已经附带了表名
// 否, 为之后的字段添上表名
// 因为join存在副表, 所以部分$where可能有附带表名, 这时候就不用添加了
$table = !preg_match('/\./', $where['column']) ? $query->from."." : '';
// 返回添上表名的字段,和表达式, 再一个问号
// 为何使用问号而不是:变量名? 因为:变量名存在太多局限性,不能标点符号,不能数字开头
return $table.$where['column'].' '.$where['operator'].' ?';
}Copier après la connexion
- whereIn - Compiler là où il est utilisé
protected function whereIn(Builder $query, $where) {
// 检测$where[column]是否存在小数点, 同理whereBasic()
$table = !preg_match('/\./', $where['column']) ? $query->from."." : '';
// 有多少个匹配值那就连接多少个问号
$values = implode(', ', array_fill(0, sizeof($where['values']), '?'));
// 返回where in 语句
return $table.$where['column'].' in ('.$values.')';
}Copier après la connexion
- whereNotIn - Compiler là où il n'est pas utilisé
protected function whereNotIn(Builder $query, $where) {
// 检测$where[column]是否存在小数点, 同理whereBasic()
$table = !preg_match('/\./', $where['column']) ? $query->from."." : '';
// 有多少个匹配值那就连接多少个问号
$values = implode(', ', array_fill(0, sizeof($where['values']), '?'));
// 返回where not in 语句
return $table.$where['column'].' not in ('.$values.')';
}Copier après la connexion
- whereNull - compile où utilisation nulle
protected function whereNull(Builder $query, $where) {
// 检测$where[column]是否存在小数点, 同理whereBasic()
$table = !preg_match('/\./', $where['column']) ? $query->from."." : '';
// 返回where is null 语句
return $table.$where['column'].' is null';
}Copier après la connexion
- whereNotNull - compile où utilisation non nulle
protected function whereNotNull(Builder $query, $where) {
// 检测$where[column]是否存在小数点, 同理whereBasic()
$table = !preg_match('/\./', $where['column']) ? $query->from."." : '';
// 返回where is not null 语句
return $table.$where['column'].' is not null';
}Copier après la connexion
- compileGroups - compiler groupe par instruction
protected function compileGroups(Builder $query, $groups) {
// 连接$groups, 返回group by语句
return 'group by '.implode(', ', $groups);
}Copier après la connexion
- compileOrders - compiler ordre par instruction
protected function compileOrders(Builder $query, $orders) {
// 连接每一个$order与其$direction, 然后返回order by语句
return 'order by '.implode(', ', array_map(function ($order) {
return $order['column'].' '.$order['direction'];
}, $orders));
}Copier après la connexion
fichier d'entrée, Classe Modèle, un monde magique
Model.php
<?php
/**
* 入口文件, 数据库表的父类
*/
class Model {
// SQL命令构建器, Builder类
protected $builder;
// 数据库返回的数据存在这里
protected $data;
// 数据库表名, 选填, 默认为类名
protected $table;
// 主键, 二选一($unique)
protected $identity;
// unique key, 二选一($identity)
protected $unique;Copier après la connexion
getTable - 获取数据库表名, 没有设置返回false
public function getTable() {
return isset($this->table) ? $this->table : false;
}Copier après la connexion
-
getIdentity - 获取主键名, 没有返回假
public function getIdentity() {
return isset($this->identity) ? $this->identity : false;
}Copier après la connexion
-
getUnique - 获取unique key名, 没有返回假
public function getUnique() {
// 检测是否存在unique key, 不存在返回假, 存在就在检查是否数组, 不是就装入数组再返回
return isset($this->unique) ? is_array($this->unique) ? $this->unique : [$this->unique] : false;
}Copier après la connexion
-
check - 检查必须预设的实例属性
public function check() {
// 如果数据库表的名称和Model的子类相同,可以选择不填,默认直接取类的名称
if(!$this->getTable())
$this->table = get_class($this);
// 跳出提醒必须设置$identity或$unique其中一项
if(!$this->getIdentity() && !$this->getUnique())
throw new Exception('One of $identity or $unique should be assigned in Model "'.get_called_class().'"');
}Copier après la connexion
-
set/getBuilder - 设置或读取Builder实例
// 设置Builder实例
public function setBuilder(Builder $builder) {
$this->builder = $builder;
return $this;
}
// 获取Builder实例
public function getBuilder() {
return $this->builder;
}Copier après la connexion
-
setData - 设置数据库数据
public function setData($data) {
$this->data = $data;
return $this;
}Copier après la connexion
-
construct - 创建实例后的第一步
function construct() {
// 检查设定是否正确
$this->check();
// 新建一个Builder实例
$this->setBuilder(new Builder);
// 设置构建器的主表名称
$this->getBuilder()->from($this->table);
// 将Model实例带入Builder
$this->getBuilder()->setModel($this);
}Copier après la connexion
魔术方法
-
callStatic - 如果找不到静态函数的时候自动运行下面的逻辑
static public function callStatic($method, $args = null) {
// 这是一个伪静态, 创建一个实例
$instance = new static;
// 在$instance->builder之中, 寻找函数$method, 并附上参数$args
return call_user_func_array([$instance->builder, $method], $args);
}Copier après la connexion
-
call - 如果找不到函数的时候自动运行下面的逻辑
public function call($method, $args) {
// 在$this->builder之中, 寻找函数$method, 并附上参数$args
return call_user_func_array([$this->builder, $method], $args);
}Copier après la connexion
-
debugInfo - 在调试的时候隐藏多余的信息, 只留下数据库返回的数据
public function debugInfo() {
// 也不懂算不算bug, 该方法强制要求返回的数据类型必须是array数组
// 但是就算我强行转换(casting)后返回的数据依然是对象(object)
return (array)$this->data;
}Copier après la connexion
-
get - 当调用对象的属性时, 强制调用这个魔术方法
// 为了避免局外人可以访问Model类的属性
// 为了避免对象属性和表的字段名字相同
public function get($field) {
// 如果调用的属性是Model类内的逻辑
// 直接返回该属性的值
if(get_called_class()==="Model")
return $this->$field;
// 反之, 则检查$data内是否存在该属性, 没有的话跳出错误
if(!isset($this->data->$field))
throw new Exception("column '$field' is not exists in table '$this->table'");
// 如果存在,由于返回的数据都是存在$data里, 所以要这样调用
return $this->data->$field;
}Copier après la connexion
-
set - 当想修改的对象属性时, 强制调用这个魔术方法
public function set($field, $value) {
// 如果调用的属性是Model类内的逻辑
// 直接赋值该属性
if(get_called_class()==="Model")
return $this->$field = $value;
// 反之, 则检查$data内是否存在该属性, 没有的话跳出错误
if(!isset($this->data->$field))
throw new Exception("column '$field' is not exists in table '$this->table'");
// 如果存在,由于返回的数据都是存在$data里, 所以要这样赋值
return $this->data->$field = $value;
}Copier après la connexion
进阶的Buider类封装没错, 我又把Builder(微)封装了
-
find - 使用主键查寻数据
/**
* @param int $id 主键
* @return Model subclass 返回一个Model的子类数据
*/
public static function find($id) {
// 这是一个伪静态, 创建一个实例
$self = new static;
// 该函数只适用于设置了主键的表, 如果没有设置, 跳出错误
if(!$self->getIdentity())
throw new Exception("Table's identity key should be assgined");
return $self->where($self->identity, $id)->first();
}Copier après la connexion
还有更多, 看心情更...
本期疑问
1.) 缺少的Builder函数如果有人愿意提供例子就好了, 进阶复杂的语句那就更好了, 直接写然后再分享给我那就最好了
2.) 有些函数或结构可能没有效率或者白白添加服务器压力, 但我写的顺了可能没看见, 请指出
3.) 有人能告诉我laravel是怎么解决pdo 2100个最大参数(bind)的问题吗? 源代码把我看蒙了
Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!
![[Web front-end] Démarrage rapide de Node.js](https://img.php.cn/upload/course/000/000/067/662b5d34ba7c0227.png)
