当前位置: 首页 > 文档资料 > Laravel 源码详解 >

Laravel Database 数据库 - Laravel Database——查询构造器与语法编译器源码分析(下)

优质
小牛编辑
130浏览
2023-12-01

insert 语句

insert 语句也是我们经常使用的数据库操作,它的源码如下:

  1. public function insert(array $values)
  2. {
  3. if (empty($values)) {
  4. return true;
  5. }
  6. if (! is_array(reset($values))) {
  7. $values = [$values];
  8. }
  9. else {
  10. foreach ($values as $key => $value) {
  11. ksort($value);
  12. $values[$key] = $value;
  13. }
  14. }
  15. return $this->connection->insert(
  16. $this->grammar->compileInsert($this, $values),
  17. $this->cleanBindings(Arr::flatten($values, 1))
  18. );
  19. }

laravelinsert 是允许批量插入的,方法如下:

  1. DB::table('users')->insert([['email' => 'foo', 'name' => 'taylor'], ['email' => 'bar', 'name' => 'dayle']]);

一个语句可以向数据库插入两条记录。sql 语句为:

  1. insert into users (`email`,`name`) VALUES (NULL, 'taylor'), ('bar', 'dayle');

因此,laravel 在处理 insert 的时候,首先会判断当前的参数是单条插入还是批量插入。

  1. if (! is_array(reset($values))) {
  2. $values = [$values];
  3. }

reset 会返回 values 的第一个元素。如果是批量插入的话,第一个元素必然也是数组。如果的单条插入的话,第一个元素是列名与列值。因此如果是单条插入的话,会在最外层再套一个数组,统一插入的格式。

如果是批量插入的话,首先需要把插入的各个字段进行排序,保证插入时各个记录的列顺序一致。

compileInsert

insert 的编译也是按照批量插入的标准来进行的:

  1. public function compileInsert(Builder $query, array $values)
  2. {
  3. $table = $this->wrapTable($query->from);
  4. if (! is_array(reset($values))) {
  5. $values = [$values];
  6. }
  7. $columns = $this->columnize(array_keys(reset($values)));
  8. $parameters = collect($values)->map(function ($record) {
  9. return '('.$this->parameterize($record).')';
  10. })->implode(', ');
  11. return "insert into $table ($columns) values $parameters";
  12. }

首先对插入的列名进行 columnze 函数处理,之后对每个记录的插入都调用 parameterize 函数来对列值进行处理,并用 () 包围起来。

update 语句

  1. public function update(array $values)
  2. {
  3. $sql = $this->grammar->compileUpdate($this, $values);
  4. return $this->connection->update($sql, $this->cleanBindings(
  5. $this->grammar->prepareBindingsForUpdate($this->bindings, $values)
  6. ));
  7. }

与插入语句相比,更新语句更加复杂,因为更新语句必然带有 where 条件,有时还会有 join 条件:

  1. public function compileUpdate(Builder $query, $values)
  2. {
  3. $table = $this->wrapTable($query->from);
  4. $columns = collect($values)->map(function ($value, $key) {
  5. return $this->wrap($key).' = '.$this->parameter($value);
  6. })->implode(', ');
  7. $joins = '';
  8. if (isset($query->joins)) {
  9. $joins = ' '.$this->compileJoins($query, $query->joins);
  10. }
  11. $wheres = $this->compileWheres($query);
  12. return trim("update {$table}{$joins} set $columns $wheres");
  13. }

updateOrInsert 语句

updateOrInsert 语句会先根据 attributes 条件查询,如果查询失败,就会合并 attributesvalues 两个数组,并插入新的记录。如果查询成功,就会利用 values 更新数据。

  1. public function updateOrInsert(array $attributes, array $values = [])
  2. {
  3. if (! $this->where($attributes)->exists()) {
  4. return $this->insert(array_merge($attributes, $values));
  5. }
  6. return (bool) $this->take(1)->update($values);
  7. }

delete 语句

删除语句比较简单,参数仅仅需要 id 即可,delete 语句会添加 idwhere 条件:

  1. public function delete($id = null)
  2. {
  3. if (! is_null($id)) {
  4. $this->where($this->from.'.id', '=', $id);
  5. }
  6. return $this->connection->delete(
  7. $this->grammar->compileDelete($this), $this->getBindings()
  8. );
  9. }

删除语句的编译需要先编译 where 条件:

  1. public function compileDelete(Builder $query)
  2. {
  3. $wheres = is_array($query->wheres) ? $this->compileWheres($query) : '';
  4. return trim("delete from {$this->wrapTable($query->from)} $wheres");
  5. }

动态 where

laravel 有一个有趣的功能:动态 where。

  1. DB::table('users')->whereFooBarAndBazOrQux('corge', 'waldo', 'fred')

这个语句会生成下面的 sql 语句:

  1. select * from users where foo_bar = 'corge' and baz = 'waldo' or qux = 'fred';

也就是说,动态 where 将函数名解析为列名与连接条件,将参数作为搜索的值。

我们先看源码:

  1. public function dynamicWhere($method, $parameters)
  2. {
  3. $finder = substr($method, 5);
  4. $segments = preg_split(
  5. '/(And|Or)(?=[A-Z])/', $finder, -1, PREG_SPLIT_DELIM_CAPTURE
  6. );
  7. $connector = 'and';
  8. $index = 0;
  9. foreach ($segments as $segment) {
  10. if ($segment !== 'And' && $segment !== 'Or') {
  11. $this->addDynamic($segment, $connector, $parameters, $index);
  12. $index++;
  13. }
  14. else {
  15. $connector = $segment;
  16. }
  17. }
  18. return $this;
  19. }
  20. protected function addDynamic($segment, $connector, $parameters, $index)
  21. {
  22. $bool = strtolower($connector);
  23. $this->where(Str::snake($segment), '=', $parameters[$index], $bool);
  24. }
  • 首先,程序会提取函数名 whereFooBarAndBazOrQux,删除前 5 个字符,FooBarAndBazOrQux

  • 正则判断,根据 AndOr 对函数名进行切割:FooBarAndBazOrQux

  • 添加 where 条件,将驼峰命名改为蛇型命名。