## setToken('令牌名稱', '令牌生成規則') >[info] 從`1.3.1`開始支持 從`1.3.1`開始，用ZBuilder生成的表單將默認帶有表單令牌，能起到`CSRF`防御作用。 ### 使用令牌驗證 在你的驗證規則中，添加`token`驗證規則即可，例如，如果使用的是驗證器的話，可以改為： ``` protected $rule = [ 'name' => 'require|max:25|token', 'email' => 'email', ]; ``` 或者 ``` protected $rule = [ 'name' => 'require|max:25', 'email' => 'email', '__token__' => 'token', ]; ``` ### 全局設置 如果所有表單都不需要開啟表單令牌，可以在 `\application\extra\zbuilder.php` 修改`form_token_name`為`false`。 ### 單獨關閉表單令牌 如果僅需要在某個表單關閉表單令牌，可以在創建ZBuilder表單時，這樣設置 ``` ->setToken(false) ``` ### 修改表單令牌名稱 如果你的令牌名稱不是`__token__`，可以自己自定義，比如： ``` ->setToken('__hash__') ``` 那么驗證器規則就需要修改為： ``` protected $rule = [ 'name' => 'require|max:25|token:__hash__', 'email' => 'email', ]; ``` 或者 ``` protected $rule = [ 'name' => 'require|max:25', 'email' => 'email', '__hash__' => 'token:__hash__', ]; ``` ### 自定義令牌生成規則 如果需要自定義令牌生成規則，則直接設置規則名稱，如： ``` ->setToken('', 'sha1') ``` 或者同時自定義名稱和生成規則 ``` ->setToken('__hash__', 'sha1') ```