Phoenix项目router.ex中pipeline、scope的定义与含义说明

你在VS Code里找不到pipeline、scope的引用是正常现象：二者不是Elixir原生关键字，也不是普通Elixir函数，是Phoenix框架为路由模块提供的编译期宏（Macro），属于Phoenix路由DSL的组成部分。
这两个宏的定义位于Phoenix.Router模块中，你的router.ex文件顶部必然有use Phoenix.Router语句，这行代码会在编译期把包括pipeline、scope在内的所有路由DSL宏导入到当前模块作用域供你使用。普通静态代码引用查找工具无法识别宏生成的隐式导入，自然没法直接跳转定位。

pipeline #

pipeline的作用是定义一组按顺序执行的Plug（插件）链，对匹配到的请求做统一预处理。
结合你贴的代码举例：

• 你定义的:browser管道专门服务浏览器端HTML请求，按顺序执行7个插件：校验请求接收格式为html、拉取Session数据、加载LiveView Flash信息、设置页面根布局、开启CSRF跨站伪造防护、添加浏览器安全响应头、设置默认请求语言为英文。
• 你定义的:api管道专门服务API接口请求，仅做了校验请求接收格式为json的处理。

注意：pipeline定义后不会自动生效，必须在路由分组中通过pipe_through显式挂载，请求匹配到对应路由时才会按顺序执行管道内的所有插件。

scope #

scope的作用是给一组路由做统一配置分组，消除重复代码，它能统一配置三类规则：

• 统一路径前缀：scope的第一个参数是路径前缀，分组内所有路由的路径都会自动拼接这个前缀。你代码里前缀是/也就是根路径，所以感知不强；如果写scope "/admin", HelloWeb.Admin，分组内所有路由都会自动带上/admin前缀。
• 统一模块命名空间：scope的第二个参数是模块命名空间，分组内所有控制器、视图模块都会自动拼接这个命名空间前缀。你代码里命名空间是HelloWeb，所以写的PageController会被自动解析为HelloWeb.PageController，不需要每次写完整模块名。
• 统一管道配置：scope内通过pipe_through指定的管道，会作用于分组内所有路由。你代码里指定了pipe_through :browser，所以分组下三个路由在执行控制器逻辑前，都会先跑完:browser管道的全部插件。

你贴的代码里scope块内的三个路由，最终编译后的实际逻辑是：

• 匹配GET请求到/路径，先执行:browser管道全部插件，再调用HelloWeb.PageController.index/2处理请求
• 匹配GET请求到/hello路径，先执行:browser管道全部插件，再调用HelloWeb.HelloController.index/2处理请求
• 匹配GET请求到/hello/:messenger路径（带路径参数messenger），先执行:browser管道全部插件，再调用HelloWeb.HelloController.show/2处理请求

内容的提问来源于stack exchange，提问作者Chen Yu