關於 Xmf\Request 變數過濾物件

11-3 建立區塊

12-2 $xoopsUser 使用者物件 next

XOOPS快速模組開發

12-1 關於 Xmf\Request 變數過濾物件

Xmf\Request 是用來接收並過濾各種外來變數用的物件
一樣要在檔案前面加入
```
use Xmf\Request;
```
常用的方法有以下這些：
1. 常用過濾整數
```
Request::getInt($name, $default = 0, $hash = 'default')
```
  $name 是變數名稱
  $default 是若該變數不存在，是否要給他一個預設值
  $hash 則是該變數的傳遞方法，如 POST、GET、FILES、COOKIE、ENV、SERVER（沒有SESSION），預設是 REQUEST
2. 一般過濾浮點數
```
Request::getFloat($name, $default = 0.0, $hash = 'default')
```
3. 常用過濾布林值
```
Request::getBool($name, $default = false, $hash = 'default')
```
4. 一般過濾英文文字（只允許 A-Z、a-z 及 _，一般用於帳號）
```
Request::getWord($name, $default = '', $hash = 'default')
```
5. 一般過濾指令（只允許 A-Z、a-z、0-9 及 _、.、-，過濾後一律傳回小寫）
```
Request::getCmd($name, $default = '', $hash = 'default')
```
6. 常用過濾一般文字
```
Request::getString($name, $default = '', $hash = 'default', $mask = 0)
```
  $mask 加入過濾遮罩，其值有：（若設5，代表 1+4，預設 0 採最嚴格之過濾）
  1：不做修剪，例如去除頭尾空白之類
  2：不再做任何額外過濾
  4：允许使用HTML
7. 常用過濾陣列
```
Request::getArray($name, $default = array(), $hash = 'default')
```
  注意，若陣列中有HTML也都會被過濾掉
8. 一般過濾大量文字（其實等同跑 getString，然後 $mask 值為 2 不做任何額外過濾之意）
```
Request::getText($name, $default = '', $hash = 'default')
```
9. 一般過濾網址
```
Request::getUrl($name, $default = '', $hash = 'default')
```
10. 一般過濾路徑
```
Request::getPath($name, $default = '', $hash = 'default')
```
11. 一般過濾Email
```
Request::getEmail($name, $default = '', $hash = 'default')
```
12. 少用過濾IP
```
Request::getIP($name, $default = '', $hash = 'default')
```
13. 少用過濾請求的檔頭
```
Request::getHeader($headerName, $default = '')
```
  $headerName 為欲過濾的檔頭名稱