Thinkphp6学习笔记，持续记录

官方文档

由此开始：https://www.kancloud.cn/manual/thinkphp6_0/1037479

目录结构：https://www.kancloud.cn/manual/thinkphp6_0/1037483

伪静态设置：https://www.kancloud.cn/manual/thinkphp6_0/1037488

Thinkphp 网址导航：http://sites.thinkphp.cn/1556332

1. 安装 lnmp 之后做些什么？

open_basedir = /:/tmp/:/proc/，调整 PHP 目录访问权限；

display_errors = On，打开默认不显示的错误提示；

安装 Redis，安装 Swoole；

2. 安装 Thinkphp 之后要做些什么？

1. 安装 think-view 模板库：“topthink/think-view”:”*”；
2. Nginx 解析的根目录改为 Thinkphp 项目所在的 public 目录；
3. Thinkphp 伪静态修改好，并重启 Nginx；
4. 将 runtime、session 等需要写入的目录给予可写的权限；
5. 启用 Thinkphp 的 session：app/middleware.php 写入；

   thinkmiddlewareSessionInit::class
   

6. config/session.php 调整 session 的有效期；
7. config/middleware.php 新增中间件类的别名

   'alias'    => ["Token"=>appmiddlewareToken::class,
         "BusinessToken"=>appmiddlewareBusinessToken::class
   ],
   

8. configdatabase.php，修改数据库相关的配置信息；
9. configfilesystem.php，修改自带的文件管理库相关配置；
10. configapp.php，修改应用相关配置（是否显示错误信息等等）；
11. configcache.php，配置 redis 等缓存数据库；
12. .env，修改调试的相关配置信息；
13. appExceptionHandle.php，修改默认错误信息输出的默认模板；

细节总结

1. 基本

1. 助手函数：https://www.kancloud.cn/manual/thinkphp6_0/1037653
2. 门面 Facade：https://www.kancloud.cn/manual/thinkphp6_0/1037491
3. URL 访问模式：域名 / 入口 / 控制器 / 操作 / 参数名 / 参数 …，入口、控制器不填的时候默认 index。单个参数无需指定参数名。（参数绑定：https://www.kancloud.cn/manual/thinkphp6_0/1037523）
4. Request 请求对象：https://www.kancloud.cn/manual/thinkphp6_0/1037516
5. Response 响应对象：https://www.kancloud.cn/manual/thinkphp6_0/1037525
6. 在 Tp6 里不能通过 header 函数设置响应头，只能通过 response 对象。

2. 控制器以及多应用

1. 官方文档：https://www.kancloud.cn/manual/thinkphp6_0/1037510
2. Tp6 支持任意的多级路由器，访问时 URl 格式为：host/one.two.three/methods
3. 可以通过路由的方式精简 URL。路由不能针对整个控制器路由。
4. 跨域访问：https://www.kancloud.cn/manual/thinkphp6_0/1037507

3. 视图

1. 视图的目录规范：https://www.kancloud.cn/manual/thinkphp6_0/1037611
2. 视图模板赋值与输出：https://www.kancloud.cn/manual/thinkphp6_0/1037609
3. 模板开发文档：https://www.kancloud.cn/manual/think-template

4. // 模板变量赋值
   View::assign('name','ThinkPHP');
   // 或者批量赋值
   View::assign(['name'  => 'ThinkPHP',
        'email' => 'thinkphp@qq.com'
   ]);
   
   // 使用视图输出过滤
   return View::filter(function($content){return str_replace("rn",'',$content);
       })->fetch();
   
   

5. 可以使用 View 静态方法或者 view()助手函数返回的对象；
6. 模板路径：默认情况下，框架会自动定位你的模板文件路径，优先定位应用目录下的 view 目录 ，这种方式的视图目录下就是应用的控制器目录。（app/(多应用时存在的目录)/controller 同级目录的 view 目录 / 控制器目录 / 视图.html）；第二种方式是视图文件和应用类库文件完全分离， 统一放置在根目录下的 view 目录。
7. 表示系统会按照默认规则自动定位视图目录下的模板文件，其规则是：控制器名（小写 + 下划线）/ 操作名.html。如果有更改模板引擎的 view_depr，改为_后就变成控制器_视图.html;

   /* 指定模板输出 */
   return View::fetch('edit'); 
   /* 表示调用当前控制器下面的 edit 模板 */
   
   return View::fetch('member/read');
   /* 表示调用 Member 控制器下面的 read 模板。*/
   
   return View::fetch('admin@member/edit');
   /* 表示跨应用调用模板 */

4. 数据库

1. 原生查询：https://www.kancloud.cn/manual/thinkphp6_0/1037570

   $user=Db::table('$tablename');  /* 含前缀 */
   $user=Db::name('$name')；/* 不含前缀 */
   

2. 在 Db 类的方法中，name()，会自动加上表前缀，table()，则不会。
3. 链式查询：https://www.kancloud.cn/manual/thinkphp6_0/1037538，如 field 指定部分字段等等。
4. select 方法查询结果是一个数据集对象，如果需要转换为数组可以使用（toArray）
5. find 方法：查询符合条件的第一条数据。select 方法：查询符合条件的所有数据。find 只是取一条记录；打印出来的区别只是有个 limit 1 的限制；
6. 字符串条件查询：whereRaw(‘type=1 AND status=1’)，以及 whereOr、whereIn 等等
7. find 查询未找到数据是返回 null，findOrEmpty 未找到数据时返回空数组。insertGetId，插入数据时返回 Id
8. update 方法返回影响数据的条数，没修改任何数据返回 0；
9. fieldRaw 方法中可直接使用 Mysql 函数，fieldRaw(‘id,SUM(score)’)；
10. 如果要更新的数据需要使用 SQL 函数或者其它字段，exp(‘name’,’UPPER(name)’)；
11. getOptions()，$model_list = User::order();$options = $model_list->getOptions(); 获取本次查询的条件；
12. fetchSql()，fetchSql 用于直接返回 SQL 而不是执行查询，适用于任何的 CURD 操作方法。
13. buildSql()，返回用于子查询的 sql 语句
14. ‘break_reconnect’ => true，用于开启断线重连。
15. 配置中的 params 参数可设置 PDO 连接参数

5. 引入自定义类库、函数

1. 如果你需要在核心之外扩展和使用第三方类库，并且该类库不是通过 Composer 安装使用，那么可以直接放入应用根目录下面的 extend 目录下面，该目录是官方建议的第三方扩展类库目录。
2. 官方文档说明：https://www.kancloud.cn/manual/thinkphp5/177200
3. 强烈建议使用 Composer 安装和更新扩展类库，ThinkPHP5.0+ 的扩展类库都采用 Composer 方式进行安装。

6. 扩展和自定义配置目录：

1. 5.0.1 开始增加了扩展配置目录的概念，在应用配置目录或者模块配置目录下面增加 extra 子目录，下面的配置文件都会自动加载，无需任何配置。
2. Tp6.x 的 config 目录下的所有配置文件系统都会自动读取，不需要手动加载。如果存在子目录，你可以通过 Config 类的 load 方法手动加载
3. 官方说明文档：https://www.kancloud.cn/manual/thinkphp5/215848
4. 自定义函数直接写在 application 或 app 目录下的 common.php 即可。

7. 数据模型

1. 模型会自动对应数据表，模型类的命名规则是除去表前缀的数据表名称，采用驼峰法命名，并且首字母大写。
2. 模型可使用数据库 Db 的所有方法。
3. 模型类定义在 app/model 目录内，官方文档：https://www.kancloud.cn/manual/thinkphp6_0/1037483。
4. 模型在控制器中的引入方式有三种，在控制器的开始部分 use 进来（推荐使用）、使用 Loader 类加载模型、使用助手函数 model（不推荐使用，以防助手函数被覆盖掉）。
5. select 方法查询结果是一个数据集对象，如果需要转换为数组可以使用（toArrray()方法）。
6. V6.0.3+ 版本开始，原生查询仅支持 Db 类操作，不支持在模型中调用原生查询方法（包括 query 和 execute 方法）。

8. 异常处理

1. 官方文档：https://www.kancloud.cn/manual/thinkphp6_0/1037615

getStatusCode() == 404) {return json(["code" => 0, "errMsg" => $e->getMessage()])->code(404);
     } else {return json(["code" => 0, "errMsg" => $e->getMessage()]);
     }
    } else {return json(["code" => 0, "errMsg" => $e->getMessage()]);
    }
}

9. 中间件

1. 中间件主要用于拦截或过滤应用的 HTTP 请求，并进行必要的业务处理。
2. 全局中间件 ->应用中间件 ->路由中间件 ->控制器中间件；
3. 官方文档：https://www.kancloud.cn/manual/thinkphp6_0/1037493
4. 直接使用中间件时需要指定完整的包名 + 类名，通过 middleware.php 配置中间件的别名后可直接指定别名。
5. 直接传递参数到控制器；

   public function handle($request, Closure $next)
   {if ('think' == $request->name) {$request->name = 'ThinkPHP';
        }
   
        return $next($request);
   }
   

10. 事件

1. 事件相比较中间件的优势是事件比中间件更加精准定位（或者说粒度更细），并且更适合一些业务场景的扩展。例如，我们通常会遇到用户注册或者登录后需要做一系列操作，通过事件系统可以做到不侵入原有代码完成登录的操作扩展，降低系统的耦合性的同时，也降低了 BUG 的可能性。
2. 官方文档：https://www.kancloud.cn/manual/thinkphp6_0/1037492

11. 数据库事务

什么情况下应该使用事务，当数据库操作结束后，还有其它的非数据库业务流程，失败时数据库操作不应该存在时使用。

Thinkphp6 模型使用事务同 DB 类一致，实例化后直接调用 startTrans、commit、rollback；

回滚只能在 Commit 之前，Commit 之后将无法回滚。

12. 数据库加锁

排它锁：Db::name(‘user’)->where(‘id’,1)->lock(true)->find();

共享锁：Db::name(‘user’)->where(‘id’,1)->lock(‘lock in share mode’)->find();

13.Redis 的使用

官方文档：https://www.kancloud.cn/manual/thinkphp6_0/1037634

官方提供的方法都比较简单易用，当然也可以自己对 Redis 类进行封装；

路由相关

1. 基础知识

官方文档：https://www.kancloud.cn/manual/thinkphp6_0/1037494

路由解析的过程一般包含：

• 路由定义：完成路由规则的定义和参数设置；
• 路由检测：检查当前的 URL 请求是否有匹配的路由；
• 路由解析：解析当前路由实际对应的操作（方法或闭包）；
• 路由调度：执行路由解析的结果调度；
• 掌握路由主要是要掌握路由定义及参数设置，其它环节是由系统自动完成的。

1.1 单应用路由

├─route                 路由定义目录
│  ├─route.php          路由定义
│  ├─api.php            路由定义
│  └─...                更多路由定义

1.2 多应用路由

多应用模式，路由定义文件需要放入应用目录下：

├─app           应用目录
│  ├─app_name           应用目录
│  │  ├─common.php      函数文件
│  │  ├─controller      控制器目录
│  │  ├─model           模型目录
│  │  ├─view            视图目录
│  │  ├─config          配置目录
│  │  ├─route           路由目录
│  │  │  ├─route.php    路由定义
│  │  │  ├─api.php      路由定义
│  │  │  └─...          更多路由定义

2. 注册路由

要使用 Route 类注册路由必须首先在路由定义文件开头添加引用（定义路由之后，原来的访问地址会自动失效）

use thinkfacadeRoute;
Route::rule('路由表达式', '路由地址', '请求类型');
// 注册路由到 News 控制器的 read 操作
Route::rule('new/:id','News/read');
// 单独指定请求类型鹅快捷方法
Route:: 快捷方法名('路由表达式', '路由地址');

3. 路由类型

• 路由到控制器 / 操作，路由到 blog 控制器，Route::get(‘blog/:id’,’Blog/read’);
• 路由到类的方法，完整类名 @方法名，Route::get(‘blog/:id’,’appindexserviceBlog@read’);
• 重定向路由，Route::redirect(‘blog/:id’, ‘http://blog.thinkphp.cn/read/:id’, 302);
• 路由到模板，路由到模板文件，Route::view(‘hello/:name’, ‘index/hello’,[携带的变量]);
• 路由到闭包，Route::get(‘hello’, function () {return ‘hello,world!’;});

4. 路由参数

官方文档：https://www.kancloud.cn/manual/thinkphp6_0/1037499

Route::get('new/:id', 'News/read')
    ->ext('html')
    ->https();

路由参数可以混合使用，只要有任何一条参数检查不通过，当前路由就不会生效，继续检测后面的路由规则。

Route::rule('hello/:name','hello')
	->middleware(appmiddlewareAuth::class);

Route::group('hello', function(){Route::rule('hello/:name','hello');
})->middleware(appmiddlewareAuth::class);

Route::rule('hello/:name','hello')
	->middleware([appmiddlewareAuth::class,appmiddlewareCheck::class]);

composer require topthink/think-annotation

class Index
{
    /**
     * @param  string $name 数据名称
     * @return mixed
     * @Route("hello/:name")
     */
	public function hello($name)
    {return 'hello,'.$name;}
}

// 绑定当前的 URL 到 Blog 控制器
Route::bind('blog');
// 绑定当前的 URL 到 Blog 控制器的 read 操作
Route::bind('blog/read');

/* 设置默认值 */
Request::only(['id'=>0,'name'=>'']);

/*  只获取当前请求的 id 和 name 变量 */
Request::only(['id','name']);

/*  只获取 GET 请求的 id 和 name 变量 */
Request::only(['id','name'], 'get');

/*  排除 id 和 name 变量 */
Request::except(['id','name']); 

/*
 * 按照格式化字符获取当前时间
 * */
function now($format="Y-m-d H:i:s"){return date($format,time());
}

QdAccount::order('belong', 'desc')
           ->paginate(['list_rows' => $json['size'],
                 'page' => $json['page'],
           ])->toArray();

// 最终输出
 {
    "total": 2,
    "per_page": 30,
    "current_page": 1,
    "last_page": 1,
    "data": [
      {
        "id": 1,
        "mobile": "18273411374",
        "password": "123",
        "register_time": "2022-07-14 13:31:04"
      },
      {
        "id": 2,
        "mobile": "18273411374",
        "password": "123",
        "register_time": "2022-07-14 13:32:04"
      }
    ]
  }

require ext-fileinfo * -> it is missing from your system. Install or enable PHP's fileinfo extension.

// 开启字段缓存
'fields_cache'      => true,
// 字段缓存路径
'schema_cache_path' => 'path/to/cache',

// 原语句
$list=Db::name(‘sms_log’)->field(‘mobile’)->group(‘mobile’)->paginate(10);// 此时总页数和分页的 html 异常

// 修改后
$buildSql=Db::name(‘sms_log’)->field(‘mobile’)->group(‘mobile’)->buildSql();
$list=Db::table($buildSql)->alias(‘bs’)->paginate(10);// 总页数和分页的 html 正确.