主题 题 题（ （ （T h e m e ） ） ） 輲 輮 輰 主题的运作方式跟以往完全不同了。它们现在基于路 路 路径 径 径映 映 映射 射 射机 机 机制 制 制，该机 制会把一个源视图文件的路径映射到一个主题视图文件路径。 举例来说， 如果路径映射为 [ ' / w e b / v i e w s ' = > ' / w e b / t h e m e s / b a s i c ' ] 轐 轅 轃 轌 轩 轮 轴 转 轐 轈 轐 轭 软 轤 轵 转 轥 1 2 （轐 轈 轐 的国际化扩展）的使用。 消息翻译现在由 i 1 8 n 应用组件执行。 该组件管理一系列消息源， 允许 使用基于消息类别的不同消息源。 更多细节请参阅国际化（轉 轮 轴 轥 轲 轮 轡 轴 轩 软 轮 轡 转 轩 轺 轡 轴 轩 软 轮 ）章节。 1 . 2 . 1 5 动 动 动作 作 作过 过 过滤 滤 滤器 轔 轅 轒 輱 輮 介绍（轉 轎 轔 轒 轏 轄 轕 轃 轔 轉 轏 轎 ） 1 . 2 . 1 6 前 前 前端 端 端资 资 资源 源 源（ （ （A s s e t s ） ） ） 轙 轩 轩 輲 輮 輰 引入了一个新的概念，称为资 资 资源 源 源包 包 包（轁 轳 轳 轥 轴 轂 轵 轮 轤 转 轥 ），以代替 輱 輮 輱 的 脚本包概念。 一个资源包是一个目录下的资源文件集合（如 轊

locale（分别用于配置时区和 本地化）。 你可能还想要配置 Laravel 的一些其它组件，比如缓存、数据库、 Session 等，关于这些我们将会在后续文档一一探讨。 Web 服务器配置 关于虚拟主机的配置（映射域名到 Laravel 应用目录）略过，如果 了解细节可参考这篇教程，当然也可以留待下一篇讲 Homestead 和 Valet 再去了解。本文只探讨如何美化 URL 让其更具有可读性。 注：所谓 /home/vagrant/project1 注：map 表示宿主机 Web 项目根目录，to 表示映射到 的虚拟机 Web 项目根目录，Windows 下需要将 ~ 替换 成完整的目录路径，比 如 C:\Users\user\Code\project1。 你需要将每个项目映射自己的对应目录而不是映射整个 ~/code 目 录： folders: 本文档由学院君提供 学院君致力于提供优质 /home/vagrant/project2 当你映射目录时，虚拟机会跟踪该目录下每个文件的所有磁盘 IO， 随着站点数量的增加，可能会遇到性能问题，尤其是在包含大量文件 的低端机器或项目中，性能问题可能会非常明显，这是因为这个原因， 所以不推荐映射整个 ~/code 目录。 注：在使用 Homestead 的时候，永远不要挂载当前目 录（.），这会导致 Vagrant 不映射当前目录 到 /vagrant

locale（分别用于配置时区和本地化）。 你可能还想要配置 Laravel 的一些其它组件，比如缓存、数据库、Session 等，关于这些我们将会在后续文档一一探讨。 Web 服务器配置 关于虚拟主机的配置（映射域名到 Laravel 应用目录）略过，如果了解细节可参考这篇教程，当然也可以留待下一篇讲 Homestead 和 Valet 再去了 解。本文只探讨如何美化 URL 让其更具有可读性。 Apache ~/Development to: /home/vagrant/Code 如果你只是创建了很少的站点，使用一般的映射就够了。不过，随着站点数量的增加，你就会遇到性能问题，尤其是在包含大量文件的低端机器或项 目中，性能问题可能会非常明显。如果你不幸遇到了这个问题，可以尝试映射每个项目到各自的 Vagrant 文件夹： folders: - map: ~/code/project1 "-zz"] rsync__exclude: ["node_modules"] 配置 Nginx 站点 对 Nginx 不熟？没关系！通过 sites 属性你可以方便地将“域名”映射到 Homestead 虚拟机的指定目录，Homestead.yaml 中默认已经配置了一个示 例站点。和共享文件夹一样，你可以配置多个站点： sites: - map: homestead

ll(); Eloquent $morphClass 属性 可以在 Eloquent 模型上定义的$morphClass 属性已经被移除，以便定义一个“morph map”（变形 映射），定义变形映射可以支持渴求式加载并且解决使用多态关联关系引起的额外 bugs，如果你 之前使用了$morphClass 属性，需要使用如下语法将其迁移到 morphMap： Relation::morphMap([ Route::resource，将 会注册 URI 如下： /photos/{photo} 如 果 你 想 要 继 续 维 护 之 前 版 本 的 行 为 而 不 是 自 动 单 数 化 资 源 路 由 参 数 ， 可 以 在 AppServiceProvider 中这样调用 singularResourceParameters 方法： use Illuminate\Support\Facades\Route; to: /home/vagrant/Code type: "nfs" 配置 Nginx 站点 对 Nginx 不熟？没问题，通过 sites 属性你可以方便地将“域名”映射到 Homestead 虚拟机的指 定目录，Homestead.yaml 中默认已经配置了一个示例站点。和共享文件夹一样，你可以配置多个 本文档由 Laravel 学院（LaravelAcademy

to: /home/vagrant/Code type: "nfs" 配置 Nginx 站点 对 Nginx 不熟？没问题，通过 sites 属性你可以方便地将“域名”映射到 Homestead 虚拟 机的指定目录，Homestead.yaml 中默认已经配置了一个示例站点。和共享文件夹一样，你 可以配置多个站点： sites: - map: homestead 当用户通过 HTTP 请求传递一个不被期望的参数值时就会出现安全隐患，然后该参数以 不被期望的方式修改数据库中的列值。例如，恶意用户通过 HTTP 请求发送一个 is_admin 参数，然后该参数映射到模型的 create 方法，从而允许用户将自己变成管理 员。 所以，你应该在模型中定义哪些属性是可以进行赋值的，使用模型上的$fillable 属性即 可实现。例如，我们设置 Flight 模型上的 App\User::where('active', 1)->get(); foreach ($users as $user) { echo $user->name; } 然而，集合使用直观的接口提供了各种映射/简化操作，因此比数组更加强大。例如，我们 可以通过以下方式移除所有无效的模型并聚合还存在的用户的名字： $users = App\User::where('active', 1)->get();

'app_view_path_name' => 'View',//渲染模板用 'app_controller_path_name' => 'Controller',//路 由根据请求url映射控制器用 'app_static_path_name' => 'Resource', //静态资源 目录名 ]); //根据上面配置的目录，配置其它目录 Cml::setApplicationDir([ \Cml\Logger\File::class); //必须绑定。路由 //框架自带的路由支持restful分格的路由、路由分组。 在未 声明/未匹配到路由规则时会按url映射到文件的方式来执行相应的控制 器方法。具体参考 http://doc.cmlphp.com/devintro/route/readme.html。 //如果想使用第三方的路由只要简单封装一个服务。实现 (可选) 该目录为站点对外目录,在服务器配置方便修改的情况下入口文件 也在这个目录下，在框架推荐的分应用模式下,上线后通过系统命 令会将 projxxx 下的所有应用下 Resource目录 映射到 public 下。详情查看 静态资源管理 开发指引 本章节主要从开发的各个模块讲解 CmlPHP 的使用。帮忙开发人员快 速、高效的使用 CmlPHP 开发项目。 配置 在项目目录说明

'app_view_path_name' => 'View',//渲染模板用 'app_controller_path_name' => 'Controller',//路由根据请求url映射控制器用 'app_static_path_name' => 'Resource', //静态资源目录名 ]); //根据上面配置的目录，配置其它目录 Cml::setApplicationDir([ , \Cml\Logger\File::class); //必须绑定。路由 //框架自带的路由支持restful分格的路由、路由分组。 在未声明/未匹配到路由规则时会按url映射到文 件的方式来执行相应的控制器方法。具体参考 http://doc.cmlphp.com/devintro/route/readme.html。 //如果想使用第三方的路由只要简单封 (可选) 该目录为站点对外目录,在服务器配置方便修改的情况下入口文件也在这个目录下，在框架推荐的 分应用模式下,上线后通过系统命令会将 projxxx 下的所有应用下 Resource目录 映射到 public 下。详情查看 静态资源管理 15 开发指引 本章节主要从开发的各个模块讲解 CmlPHP 的使用。帮忙开发人员快速、高效的使用 CmlPHP 开发项 目。 16

'app_view_path_name' => 'View',//渲染模板用 'app_controller_path_name' => 'Controller',//路由根据请求url映射控制器用 'app_static_path_name' => 'Resource', //静态资源目录名 ]); //根据上面配置的目录，配置其它目录 Cml::setApplicationDir([ , \Cml\Logger\File::class); //必须绑定。路由 //框架自带的路由支持restful分格的路由、路由分组。 在未声明/未匹配到路由规则时会按url映射到文 件的方式来执行相应的控制器方法。具体参考 http://doc.cmlphp.com/devintro/route/readme.html。 //如果想使用第三方的路由只要简单封 public目录 (可选) 该目录为站点对外目录,在服务器配置方便修改的情况下入口文件也在这个目录 下，在框架推荐的分应用模式下,上线后通过系统命令会将 projxxx 下的所有应用 下 Resource目录 映射到 public 下。详情查看 静态资源管理 开发指引 本章节主要从开发的各个模块讲解 CmlPHP 的使用。帮忙开发人员快速、高效的使 用 CmlPHP 开发项目。 配置 在项目目录说明

延伸補充資料 製作⼀個簡易的⽂章管理系統 只有兩個欄位 title 、 content 筆記連結：https://hackmd.io/ZDoduP_oQ5WXYsO7TyJsiQ 新建單⼀資源 POST https://localhost/api/v1/articles { "data": { "id": 1, "title": "我是標題⽂字" } } 201 CREATED Request Response { "title": "我是標題⽂字", "content": "我是內容" } 查看單⼀資源 GET https://localhost/api/v1/articles/1 Response Request { "data": { "id": 1, "created_at": "2021-09-08 14:07:22", "updated_at": "2021-09-08 14:07:22" } } 200 OK 查看資源列表 GET https://localhost/api/v1/articles { "data": [ { "id": 1,

请求传递一个不被期望的参数值时就会出现 mass-assignment 隐患，然后 该参数以不被期望的方式修改数据库中的列值。例如，恶意用户通过 HTTP 请求发送一个 is_admin 参数，然后该参数映射到模型的 create 方法，从而允许用户将自己变成管理员。 所以，作为开始，你应该定义模型属性中哪些是可以进行赋值的，使用模型上的$fillable 属性即可实现。例如，我们设置 Flight 模型上的 e', 1)->get(); foreach ($users as $user) { echo $user->name; } 然而，集合比数组更加强大，使用直观的接口提供了各种映射/简化操作。例如，让我们移 除所有无效的模型并聚合还存在的用户的名字： $users = App\User::where('active', 1)->get(); $names = $us listen 属性包 含了事件（键）和对应监听器（值）数组。如果应用需要，你可以添加多个事件到该数组。 例如，让我们添加 PodcastWasPurchased 事件： /** * 事件监听器映射 * * @var array */ protected $listen = [ 'App\Events\PodcastWasPurchased' => [