## 注冊路由規則
路由注冊可以采用方法動態單個和批量注冊,也可以直接定義路由定義文件的方式進行集中注冊。
### 動態注冊
路由定義采用`\think\Route`類的`rule`方法注冊,通常是在應用的路由配置文件`application/route.php`進行注冊,格式是:
>[info] #### Route::rule('路由表達式','路由地址','請求類型','路由參數(數組)','變量規則(數組)');
例如注冊如下路由規則:
~~~
use think\Route;
// 注冊路由到index模塊的News控制器的read操作
Route::rule('new/:id','index/News/read');
~~~
我們訪問:
~~~
http://serverName/new/5
~~~
> ThinkPHP5.0的路由規則定義是從根目錄開始,而不是基于模塊名的。
會自動路由到:
~~~
http://serverName/index/news/read/id/5
~~~
并且原來的訪問地址會自動失效。
路由表達式(第一個參數)支持定義命名標識,例如:
~~~
// 定義new路由命名標識
Route::rule(['new','new/:id'],'index/News/read');
~~~
> 注意,路由命名標識必須唯一,定義后可以用于URL的快速生成。
可以在rule方法中指定請求類型,不指定的話默認為任何請求類型,例如:
~~~
Route::rule('new/:id','News/update','POST');
~~~
表示定義的路由規則在POST請求下才有效。
請求類型包括:
|類型|描述|
|---|---|
|GET| GET請求|
|POST| POST請求|
|PUT| PUT請求|
|DELETE |DELETE請求|
|* |任何請求類型|
> 注意:請求類型參數必須大寫。
系統提供了為不同的請求類型定義路由規則的簡化方法,例如:
~~~
Route::get('new/:id','News/read'); // 定義GET請求路由規則
Route::post('new/:id','News/update'); // 定義POST請求路由規則
Route::put('new/:id','News/update'); // 定義PUT請求路由規則
Route::delete('new/:id','News/delete'); // 定義DELETE請求路由規則
Route::any('new/:id','News/read'); // 所有請求都支持的路由規則
~~~
如果要定義get和post請求支持的路由規則,也可以用:
~~~
Route::rule('new/:id','News/read','GET|POST');
~~~
我們也可以批量注冊路由規則,例如:
~~~
Route::rule(['new/:id'=>'News/read','blog/:name'=>'Blog/detail']);
Route::get(['new/:id'=>'News/read','blog/:name'=>'Blog/detail']);
Route::post(['new/:id'=>'News/update','blog/:name'=>'Blog/detail']);
~~~
注冊多個路由規則后,系統會依次遍歷注冊過的滿足請求類型的路由規則,一旦匹配到正確的路由規則后則開始調用控制器的操作方法,后續規則就不再檢測。
## 路由表達式
路由表達式統一使字符串定義,采用規則定義的方式。
>[danger] 正則路由定義功能已經廢除,改由變量規則定義完成。
### 規則表達式
規則表達式通常包含靜態地址和動態地址,或者兩種地址的結合,例如下面都屬于有效的規則表達式:
~~~
'/' => 'index', // 首頁訪問路由
'my' => 'Member/myinfo', // 靜態地址路由
'blog/:id' => 'Blog/read', // 靜態地址和動態地址結合
'new/:year/:month/:day'=>'News/read', // 靜態地址和動態地址結合
':user/:blog_id'=>'Blog/read',// 全動態地址
~~~
規則表達式的定義以`/`為參數分割符(無論你的PATH_INFO分隔符設置是什么,請確保在定義路由規則表達式的時候統一使用`/`進行URL參數分割)。
每個參數中以“:”開頭的參數都表示動態變量,并且會自動綁定到操作方法的對應參數。
### 可選定義
支持對路由參數的可選定義,例如:
~~~
'blog/:year/[:month]'=>'Blog/archive',
~~~
`[:month]`變量用`[ ]`包含起來后就表示該變量是路由匹配的可選變量。
以上定義路由規則后,下面的URL訪問地址都可以被正確的路由匹配:
~~~
http://serverName/index.php/blog/2015
http://serverName/index.php/blog/2015/12
~~~
采用可選變量定義后,之前需要定義兩個或者多個路由規則才能處理的情況可以合并為一個路由規則。
> 可選參數只能放到路由規則的最后,如果在中間使用了可選參數的話,后面的變量都會變成可選參數。
### 完全匹配
規則匹配檢測的時候只是對URL從頭開始匹配,只要URL地址包含了定義的路由規則就會匹配成功,如果希望完全匹配,可以在路由表達式最后使用`$`符號,例如:
~~~
'new/:cate$'=> 'News/category',
~~~
~~~
http://serverName/index.php/new/info
~~~
會匹配成功,而
~~~
http://serverName/index.php/new/info/2
~~~
則不會匹配成功。
如果是采用
~~~
'new/:cate'=> 'News/category',
~~~
方式定義的話,則兩種方式的URL訪問都可以匹配成功。
如果你希望所有的路由定義都是完全匹配的話,可以直接配置
~~~
// 開啟路由定義的全局完全匹配
'route_complete_match' => true,
~~~
當開啟全局完全匹配的時候,如果個別路由不需要使用完整匹配,可以添加路由參數覆蓋定義:
~~~
Route::rule('new/:id','News/read','GET|POST',['complete_match' => false]);
~~~
## 額外參數
在路由跳轉的時候支持額外傳入參數對(額外參數指的是不在URL里面的參數,隱式傳入需要的操作中,有時候能夠起到一定的安全防護作用,后面我們會提到)。例如:
~~~
'blog/:id'=>'blog/read?status=1&app_id=5',
~~~
上面的路由規則定義中額外參數的傳值方式都是等效的。`status`和`app_id`參數都是URL里面不存在的,屬于隱式傳值,當然并不一定需要用到,只是在需要的時候可以使用。
- 序言
- 基礎
- 安裝ThinkPHP
- 開發規范
- 目錄結構
- 架構
- 架構總覽
- 生命周期
- 入口文件
- URL訪問
- 模塊設計
- 命名空間
- 自動加載
- Traits引入
- API友好
- 配置
- 配置目錄
- 配置格式
- 配置加載
- 讀取配置
- 動態配置
- 獨立配置
- 配置作用域
- 環境變量配置
- 路由
- 路由模式
- 路由定義
- 批量注冊
- 變量規則
- 組合變量
- 路由參數
- 路由地址
- 資源路由
- 快捷路由
- 路由別名
- 路由分組
- MISS路由
- 閉包支持
- 路由綁定
- 綁定模型
- 域名路由
- URL生成
- 控制器
- 控制器定義
- 控制器初始化
- 前置操作
- 跳轉和重定向
- 空操作
- 空控制器
- 多級控制器
- 分層控制器
- Rest控制器
- 自動定位控制器
- 資源控制器
- 請求
- 請求信息
- 輸入變量
- 更改變量
- 請求類型
- 請求偽裝
- HTTP頭信息
- 偽靜態
- 方法注入
- 屬性注入
- 參數綁定
- 依賴注入
- 請求緩存
- 數據庫
- 連接數據庫
- 基本使用
- 查詢構造器
- 查詢數據
- 添加數據
- 更新數據
- 刪除數據
- 查詢方法
- 查詢語法
- 鏈式操作
- where
- table
- alias
- field
- order
- limit
- page
- group
- having
- join
- union
- distinct
- lock
- cache
- comment
- fetchSql
- force
- bind
- partition
- strict
- failException
- sequence
- 聚合查詢
- 時間查詢
- 高級查詢
- 視圖查詢
- 子查詢
- 原生查詢
- 查詢事件
- 事務操作
- 監聽SQL
- 存儲過程
- 數據集
- 分布式數據庫
- 模型
- 定義
- 模型初始化
- 新增
- 更新
- 刪除
- 查詢
- 聚合
- 獲取器
- 修改器
- 時間戳
- 只讀字段
- 軟刪除
- 類型轉換
- 數據完成
- 查詢范圍
- 模型分層
- 數組訪問和轉換
- JSON序列化
- 事件
- 關聯
- 一對一關聯
- 一對多關聯
- 遠程一對多
- 多對多關聯
- 多態關聯
- 動態屬性
- 關聯預載入
- 關聯統計
- 聚合模型
- 視圖
- 視圖實例化
- 模板引擎
- 模板賦值
- 模板渲染
- 輸出替換
- 模板
- 模板定位
- 模板標簽
- 變量輸出
- 系統變量
- 請求參數
- 使用函數
- 使用默認值
- 使用運算符
- 三元運算
- 原樣輸出
- 模板注釋
- 模板布局
- 模板繼承
- 包含文件
- 標簽庫
- 內置標簽
- 循環輸出標簽
- 比較標簽
- 條件判斷
- 資源文件加載
- 標簽嵌套
- 原生PHP
- 定義標簽
- 日志
- 介紹
- 日志驅動
- 日志寫入
- 獨立日志
- 日志清空
- 寫入授權
- 錯誤和調試
- 調試模式
- 異常處理
- 拋出異常
- Trace調試
- 變量調試
- 性能調試
- SQL調試
- 遠程調試
- 404頁面
- 驗證
- 驗證器
- 驗證規則
- 錯誤信息
- 驗證場景
- 控制器驗證
- 模型驗證
- 內置規則
- 靜態調用
- 表單令牌
- 安全
- 輸入安全
- 數據庫安全
- 上傳安全
- 其它安全建議
- 雜項
- 緩存
- Session
- Cookie
- 多語言
- 分頁
- 上傳
- 驗證碼
- 圖像處理
- 文件處理
- 單元測試
- 擴展
- 函數
- 類庫
- 行為
- 驅動
- Composer包
- Time
- 數據庫遷移工具
- Workerman
- MongoDb
- SAE
- 標簽擴展
- 命令行
- 自動生成目錄結構
- 創建類庫文件
- 生成類庫映射文件
- 生成路由緩存
- 清除緩存文件
- 生成配置緩存文件
- 生成數據表字段緩存
- 自定義命令行
- 部署
- 虛擬主機環境
- Linux 主機環境
- URL重寫
- 附錄
- 配置參考
- 常量參考
- 助手函數
- 升級指導
- 更新日志