路由是應用開發中比較關鍵的一個環節,其主要作用包括但不限于:
* 讓URL更規范以及優雅;
* 隱式傳入額外請求參數;
* 統一攔截并進行權限檢查等操作;
* 綁定請求數據;
* 使用請求緩存;
* 路由中間件支持;
路由解析的過程一般包含:
* 路由定義:完成路由規則的定義和參數設置;
* 路由檢測:檢查當前的URL請求是否有匹配的路由;
* 路由解析:解析當前路由實際對應的操作(方法或閉包);
* 路由調度:執行路由解析的結果調度;
掌握路由主要是要掌握路由定義及參數設置,其它環節是由系統自動完成的。
>[danger] 路由的主體規劃和定義應該盡可能在應用開發前完成,在后期可以進行路由的參數調整和規則增補。
## 路由定義文件
路由規則的注冊必須在應用的路由定義文件中完成。路由定義和檢測是針對應用的,因此如果你采用的是多應用模式,每個應用的路由都是完全獨立的,并且路由地址不能跨應用(除非采用重定向路由)。
>[info] `route`目錄下的任何路由定義文件都是有效的,分開多個路由定義文件并沒有實際的意義,純粹出于管理方便而已。默認的路由定義文件是`route.php`,但你完全可以更改文件名,或者添加多個路由定義文件。
~~~php
├─route 路由定義目錄
│ ├─route.php 路由定義
│ ├─api.php 路由定義
│ └─... 更多路由定義
~~~
如果你使用了多應用模式,那么路由定義文件則放入應用目錄下:
~~~php
├─app 應用目錄
│ ├─app_name 應用目錄
│ │ ├─common.php 函數文件
│ │ ├─controller 控制器目錄
│ │ ├─model 模型目錄
│ │ ├─view 視圖目錄
│ │ ├─config 配置目錄
│ │ ├─route 路由目錄
│ │ │ ├─route.php 路由定義
│ │ │ ├─api.php 路由定義
│ │ │ └─... 更多路由定義
~~~
多應用模式下面,如果你開啟了自動多應用,路由的規則是指在URL地址的應用名之后的部分,也就是說URL中的應用名是不能省略和改變的,例如你在`index`應用中定義了路由。
```
Route::rule('hello/:name', 'index/hello');
```
在沒有開啟自動多應用的情況下,URL地址是
```
http://serverName/index.php/hello/think
```
一旦你開啟了自動多應用,那么實際的URL地址應該是
```
http://serverName/index.php/index/hello/think
```
>[danger] 如果不做特殊說明的話,后面章節的例子都采用單應用模式或者多個入口應用舉例,如果你是自動多應用的話請參考上面的實例進行URL地址調整。
## 路由配置文件
路由的配置文件獨立為`config`目錄下的`route.php`,如果是多應用模式則支持在應用配置的`route.php`設置,請注意路由配置文件和路由定義文件之間的區別。
## 關閉路由
如果你的某個應用不需要使用路由功能,那么可以在應用的`app.php`配置文件中設置:
~~~
// 關閉應用的路由功能
'with_route' => false,
~~~
關閉某個應用的路由。路由關閉后,你只能使用默認的URL解析規則來訪問。
- 序言
- 基礎
- 安裝
- 開發規范
- 目錄結構
- 配置
- 架構
- 請求流程
- 架構總覽
- 入口文件
- 多應用模式
- URL訪問
- 容器和依賴注入
- 服務
- 門面
- 中間件
- 事件
- 路由
- 路由定義
- 變量規則
- 路由地址
- 路由參數
- 路由中間件
- 路由分組
- 資源路由
- 注解路由
- 路由綁定
- 域名路由
- MISS路由
- 跨域請求
- URL生成
- 控制器
- 控制器定義
- 基礎控制器
- 空控制器
- 資源控制器
- 控制器中間件
- 請求
- 請求對象
- 請求信息
- 輸入變量
- 請求類型
- HTTP頭信息
- 偽靜態
- 參數綁定
- 請求緩存
- 響應
- 響應輸出
- 響應參數
- 重定向
- 文件下載
- 數據庫
- 連接數據庫
- 分布式數據庫
- 查詢構造器
- 查詢數據
- 添加數據
- 更新數據
- 刪除數據
- 查詢表達式
- 鏈式操作
- where
- table
- alias
- field
- strict
- limit
- page
- order
- group
- having
- join
- union
- distinct
- lock
- cache
- cacheAlways
- comment
- fetchSql
- force
- partition
- failException
- sequence
- replace
- extra
- duplicate
- procedure
- 聚合查詢
- 分頁查詢
- 時間查詢
- 高級查詢
- 視圖查詢
- JSON字段
- 子查詢
- 原生查詢
- 獲取查詢參數
- 查詢事件
- 獲取器
- 事務操作
- 存儲過程
- 數據集
- 數據庫驅動
- 模型
- 定義
- 模型字段
- 新增
- 更新
- 刪除
- 查詢
- 查詢范圍
- JSON字段
- 獲取器
- 修改器
- 搜索器
- 數據集
- 自動時間戳
- 只讀字段
- 軟刪除
- 類型轉換
- 模型輸出
- 模型事件
- 模型關聯
- 一對一關聯
- 一對多關聯
- 遠程一對多
- 遠程一對一
- 多對多關聯
- 多態關聯
- 關聯預載入
- 關聯統計
- 關聯輸出
- 虛擬模型
- 視圖
- 模板變量
- 視圖過濾
- 模板渲染
- 模板引擎
- 視圖驅動
- 錯誤和日志
- 異常處理
- 日志處理
- 調試
- 調試模式
- Trace調試
- SQL調試
- 變量調試
- 遠程調試
- 驗證
- 驗證器
- 驗證規則
- 錯誤信息
- 驗證場景
- 路由驗證
- 內置規則
- 表單令牌
- 注解驗證
- 雜項
- 緩存
- Session
- Cookie
- 多語言
- 上傳
- 命令行
- 啟動內置服務器
- 查看版本
- 自動生成應用目錄
- 創建類庫文件
- 清除緩存文件
- 生成數據表字段緩存
- 生成路由映射緩存
- 輸出路由定義
- 自定義指令
- Debug輸出級別
- 擴展庫
- 數據庫遷移工具
- Workerman
- think助手工具庫
- 驗證碼
- Swoole
- 附錄
- 助手函數
- 升級指導
- 更新日志