驗證類?

CodeIgniter 提供了全面的數(shù)據(jù)驗證類，最大程度減少你需要編寫的代碼量。

概述 ?

在解釋 CodeIgniter 的數(shù)據(jù)驗證之前，我們先介紹理想的狀況：

顯示一個表單。
你填寫并提交。
如果你提交的表單數(shù)據(jù)無效，或者丟失了必填項，將重新顯示包含了你的數(shù)據(jù)和錯誤消息的表單。
這個過長將一直持續(xù)到你提交的表單數(shù)據(jù)有效為止。

在接收端，腳本必須：

檢查需要的數(shù)據(jù)。
驗證數(shù)據(jù)的類型是否正確，并且符合要求的標準。例如，如果提交了用戶名，則必須僅包含允許的字符。它必須大于最小長度，小于最大長度。用戶名不能是系統(tǒng)中已經(jīng)存在的用戶名，甚至是保留的關(guān)鍵詞。等等。
處理數(shù)據(jù)以保證安全。
如果有必要，對數(shù)據(jù)進行格式化 (是否需要裁剪數(shù)據(jù) ? HTML 編碼? 等等。)
準備要插入數(shù)據(jù)庫的數(shù)據(jù)。

盡管上述過程沒有什么非常復(fù)雜的，但是通常需要編寫大量的代碼，并且顯示各種錯誤消息，在 HTML 表單中放置各種控制結(jié)構(gòu)。表單驗證雖然容易創(chuàng)建，但是通常十分混亂，實現(xiàn)起來很繁瑣。

表單驗證教程 ?

以下是實現(xiàn) CodeIgniter 表單驗證的“動手”教程。

為了實現(xiàn)表單驗證，你需要做三件事：

一個包含表單的 View 文件。
一個提交成功后顯示 “success” 的 View 文件。
一個 controller 方法用來接收和處理提交的數(shù)據(jù)。

讓我們以會員注冊表單為例來做這三件事。

表單 ?

使用編輯器創(chuàng)建一個名為 Signup.php 的視圖文件，將代碼復(fù)制到文件中，并保存到 app/Views/ 文件夾：

<html>
<head>
    <title>My Form</title>
</head>
<body>

    <?= $validation->listErrors() ?>

    <?= form_open('form') ?>

    <h5>Username</h5>
    <input type="text" name="username" value="" size="50" />

    <h5>Password</h5>
    <input type="text" name="password" value="" size="50" />

    <h5>Password Confirm</h5>
    <input type="text" name="passconf" value="" size="50" />

    <h5>Email Address</h5>
    <input type="text" name="email" value="" size="50" />

    <div><input type="submit" value="Submit" /></div>

    </form>

</body>
</html>

成功頁 ?

使用編輯器創(chuàng)建一個名為 Success.php 的視圖文件，將代碼復(fù)制到文件中，并保存到 app/Views/ 文件夾：

<html>
<head>
    <title>My Form</title>
</head>
<body>

    <h3>Your form was successfully submitted!</h3>

    <p><?= anchor('form', 'Try it again!') ?></p>

</body>
</html>

控制器 ?

使用編輯器創(chuàng)建一個名為 Form.php 的控制器文件，將代碼復(fù)制到文件中，并保存到 app/Controllers/ 文件夾：

<?php namespace App\Controllers;

use CodeIgniter\Controller;

class Form extends Controller
{
    public function index()
    {
        helper(['form', 'url']);

        if (! $this->validate([]))
        {
            echo view('Signup', [
                'validation' => $this->validator
            ]);
        }
        else
        {
            echo view('Success');
        }
    }
}

試一試!?

要嘗試使用表單，請使用與此網(wǎng)址相似的網(wǎng)址訪問你的網(wǎng)站

example.com/index.php/form/

如果你提交表單，則應(yīng)該只看到表單重新加載。那是因為你沒有設(shè)置任何驗證規(guī)則。

注解

由于你沒有告訴 Validation 類 進行任何驗證, 它在 默認情況 下 返回 false (boolean false)。 validate() 方法僅在驗證你設(shè)置的 所有規(guī)則 并且沒有 任何失敗 的情況下返回 true 。

說明 ?

你會注意到上述頁面的幾件事情：

表單 (Signup.php) 是一個標準的 web 表單，但有一些例外：

它使用表單輔助類來創(chuàng)建表單。從技術(shù)上講這沒必要，你可以使用標準的 HTML 代碼來創(chuàng)建表單。但是，使用表單輔助類可以根據(jù)配置文件中的 URL 來生成表單的 action URL。當(dāng)你的網(wǎng)址發(fā)生更改時，則你的程序更容易進行移植。
在表單的頂部，你會注意到調(diào)用了以下函數(shù)：
```
<?= $validation->listErrors() ?>
```
該函數(shù)將返回 validator 發(fā)送的所有錯誤消息。如果沒有消息，則返回一個空字符串。

控制器 (Form.php) 擁有一個方法： index()。這個方法使用控制器提供的 validate 方法，并加載表單輔助類和 URL 輔助類。它還運行驗證程序，根據(jù)驗證程序是否驗證成功，它將顯示表單或成功頁。

加載 validation 庫 ?

該庫通過名叫 validation 的服務(wù)進行加載：

$validation =  \Config\Services::validation();

這將自動加載 Config\Validation 文件，文件中包含了多個規(guī)則類，以及便于重用的規(guī)則集合。

注解

你可用永遠都不會使用該方法，因為 Controller 和 Model 中都提供了更簡便的驗證方法。

設(shè)置驗證規(guī)則 ?

CodeIgniter 允許你為給定字段設(shè)置多個驗證規(guī)則，并按順序執(zhí)行它們。要設(shè)置驗證規(guī)則，你將使用 setRule()，setRules() 方法。

setRule()?

該方法設(shè)置單個規(guī)則，它使用 字段名稱 作為第一個參數(shù)，第二個參數(shù)是一個可選的標簽，第三個參數(shù)是以豎線分隔的規(guī)則列表的字符串：

$validation->setRule('username', 'Username', 'required');

字段名稱 必須與需要驗證的任何數(shù)據(jù)數(shù)組的鍵匹配。如果直接從 $_POST 獲取數(shù)組，則它必須與表單的 input name 完全匹配。

setRules()?

與 setRule() 類似，但其接受字段名稱與其規(guī)則所組成的數(shù)組：

$validation->setRules([
    'username' => 'required',
    'password' => 'required|min_length[10]'
]);

想設(shè)置帶標簽的錯誤消息，你可以像這樣設(shè)置：

$validation->setRules([
    'username' => ['label' => 'Username', 'rules' => 'required'],
    'password' => ['label' => 'Password', 'rules' => 'required|min_length[10]']
]);

withRequest()?

使用驗證庫最常見的場景之一是驗證從 HTTP 請求輸入的數(shù)據(jù)。如果需要，你可以傳遞當(dāng)前的 Request 對象的實例，它將接收所有輸入數(shù)據(jù)，并將其設(shè)置為待驗證的數(shù)據(jù)：

$validation->withRequest($this->request)
           ->run();

處理 Validation ?

驗證數(shù)組的鍵 ?

如果需要驗證的數(shù)據(jù)在嵌套的關(guān)聯(lián)數(shù)組中，則可以使用 “點數(shù)組語法” 輕松驗證數(shù)據(jù)：

// The data to test:
'contacts' => [
    'name' => 'Joe Smith',
    'friends' => [
        [
            'name' => 'Fred Flinstone'
        ],
        [
            'name' => 'Wilma'
        ]
    ]
]

// Joe Smith
$validation->setRules([
    'contacts.name' => 'required'
]);

// Fred Flintsone & Wilma
$validation->setRules([
    'contacts.friends.name' => 'required'
]);

你可以使用通配符 “*” 來匹配數(shù)組的任何一個層級：

// Fred Flintsone & Wilma
$validation->setRules([
    'contacts.*.name' => 'required'
]);

“點數(shù)組語法” 也通常用于一維數(shù)組。例如，多選下拉列表返回的數(shù)據(jù)：

// The data to test:
'user_ids' => [
    1,
    2,
    3
]
// Rule
$validation->setRules([
    'user_ids.*' => 'required'
]);

驗證單個值 ?

根據(jù)規(guī)則驗證單個值：

$validation->check($value, 'required');

將驗證規(guī)則集合保存到配置文件 ?

Validation 類一個好的功能是，它允許你將整個程序的驗證規(guī)則存儲在配置文件中。將規(guī)則組合成一個 “group” ，可以在運行驗證時指定不同的組。

如何保存你的規(guī)則?

要存儲你的驗證規(guī)則，只需在 Config\Validation 類中使用 group 名創(chuàng)建一個新的公共屬性，該元素將包含你的驗證規(guī)則數(shù)組。驗證規(guī)則數(shù)組的原型如下所示：

class Validation
{
    public $signup = [
        'username'     => 'required',
        'password'     => 'required',
        'pass_confirm' => 'required|matches[password]',
        'email'        => 'required|valid_email'
    ];
}

你可以在調(diào)用 run() 方法時指定要使用的組：

$validation->run($data, 'signup');

你也可以將自定義錯誤消息存儲在配置文件中，屬性名稱與組名相同并添加 _errors。當(dāng)使用該組時，默認的錯誤消息將被替換：

class Validation
{
    public $signup = [
        'username'     => 'required',
        'password'     => 'required',
        'pass_confirm' => 'required|matches[password]',
        'email'        => 'required|valid_email'
    ];

    public $signup_errors = [
        'username' => [
            'required'    => 'You must choose a username.',
        ],
        'email'    => [
            'valid_email' => 'Please check the Email field. It does not appear to be valid.'
        ]
    ];
}

或者在組中傳遞所有的設(shè)置：

class Validation
{
    public $signup = [
        'username' => [
            'rules'  => 'required',
            'errors' => [
                'required' => 'You must choose a Username.'
            ]
        ],
        'email'    => [
            'rules'  => 'required|valid_email',
            'errors' => [
                'valid_email' => 'Please check the Email field. It does not appear to be valid.'
            ]
        ],
    ];
}

有關(guān)數(shù)組格式的詳細信息請查看下文。

獲取與設(shè)置規(guī)則組?

獲取規(guī)則組

該方法從驗證配置中獲取規(guī)則組：

$validation->getRuleGroup('signup');

設(shè)置規(guī)則組

該方法設(shè)置將規(guī)則組從驗證配置設(shè)置到驗證服務(wù)：

$validation->setRuleGroup('signup');

運行多個 Validation ?

注解

run() 方法不會重置錯誤狀態(tài)。如果上次運行失敗，run() 方法將始終返回 false ， getErrors() 方法將始終返回上次的所有錯誤，直至狀態(tài)被顯式重置。

如果需要運行多個驗證，例如在不同的數(shù)據(jù)集上運行或者一個接一個的運行不同的規(guī)則，你應(yīng)該在每次運行前調(diào)用 $validation->reset() 清除上次運行產(chǎn)生的錯誤。需要注意的是 reset() 將重置之前的所有數(shù)據(jù)、規(guī)則或是自定義錯誤消息。所以需要重復(fù) setRules()，setRuleGroup() 等方法：

for ($userAccounts as $user) {
    $validation->reset();
    $validation->setRules($userAccountRules);
    if (!$validation->run($user)) {
        // handle validation errors
    }
}

Validation 占位符 ?

Validation 類提供了一個簡單的方法，可以根據(jù)傳入的數(shù)據(jù)替換部分規(guī)則。這聽起來十分晦澀，但在使用 is_unique 進行驗證時十分方便。占位符是字段的名稱（或數(shù)組的鍵），該字段名稱（或數(shù)組的鍵）將用花括號包起來作為 $data 傳入。它將被替換為匹配的傳入字段的值。以下例子可以解釋這些：

$validation->setRules([
    'email' => 'required|valid_email|is_unique[users.email,id,{id}]'
]);

在這組規(guī)則中，它聲明 email 在數(shù)據(jù)庫中是唯一的，除了具有與占位符匹配的 id 信息，假設(shè)表單 POST 數(shù)據(jù)中有以下內(nèi)容：

$_POST = [
    'id' => 4,
    'email' => 'foo@example.com'
];

那么占位符 {id} 將被修改為數(shù)字 4，以下是修改后的規(guī)則：

$validation->setRules([
    'email' => 'required|valid_email|is_unique[users.email,id,4]'
]);

因此，在驗證 email 唯一時，將忽略數(shù)據(jù)庫中 id=4 的行。

這也可以用于在運行時動態(tài)創(chuàng)建更多的規(guī)則，只要你確保傳入的任何動態(tài)鍵都不會與表單數(shù)據(jù)產(chǎn)生沖突。

處理錯誤 ?

Validation 庫提供了幾種方法幫助你設(shè)置錯誤消息，提供自定義錯誤消息，以及顯示一個或多個錯誤消息。

默認情況下，錯誤消息來自 system/Language/en/Validation.php 中的語言字符串，其中每個規(guī)則都有一個條目。

設(shè)置自定義錯誤消息 ?

setRule() 和 setRules() 允許自定義錯誤消息數(shù)據(jù)作為最后一個參數(shù)傳入。每一個錯誤的錯誤消息都是定制的，這將帶來愉快的用戶體驗。如果沒有設(shè)置自定義錯誤消息，則提供默認值。

這是兩種設(shè)置錯誤消息的方式。

作為最后一個參數(shù)：

$validation->setRules([
        'username' => 'required|is_unique[users.username]',
        'password' => 'required|min_length[10]'
    ],
    [   // Errors
        'username' => [
            'required' => 'All accounts must have usernames provided',
        ],
        'password' => [
            'min_length' => 'Your password is too short. You want to get hacked?'
        ]
    ]
);

或者作為標簽樣式：

$validation->setRules([
        'username' => [
            'label'  => 'Username',
            'rules'  => 'required|is_unique[users.username]',
            'errors' => [
                'required' => 'All accounts must have {field} provided'
            ]
        ],
        'password' => [
            'label'  => 'Password',
            'rules'  => 'required|min_length[10]',
            'errors' => [
                'min_length' => 'Your {field} is too short. You want to get hacked?'
            ]
        ]
    ]
);

如果你希望包含字段的“human”名稱，或者某些規(guī)則允許的可選參數(shù) (比如 max_length)，或當(dāng)前參與驗證的值，則可以分別將 {field}，{param}，{value} 標記添加到你的消息中：

'min_length' => 'Supplied value ({value}) for {field} must have at least {param} characters.'

在一個用戶名字段為 Username ，驗證規(guī)則為 min_length[6] ，字段值為 “Pizza” 的驗證中，將顯示錯誤消息 “Supplied value (Pizza) for Username must have at least 6 characters”

注解

如果你傳遞最后一個參數(shù)，則標簽樣式的錯誤信息將被忽略。

消息和驗證標簽的翻譯 ?

要使用語言文件中的翻譯字符串，可以簡單的使用點語法。假設(shè)我們有一個包含翻譯的文件位于 app/Languages/en/Rules.php。我們可以簡單的使用定義在文件中的語言行，如下：

$validation->setRules([
        'username' => [
            'label'  => 'Rules.username',
            'rules'  => 'required|is_unique[users.username]',
            'errors' => [
                'required' => 'Rules.username.required'
            ]
        ],
        'password' => [
            'label'  => 'Rules.password',
            'rules'  => 'required|min_length[10]',
            'errors' => [
                'min_length' => 'Rules.password.min_length'
            ]
        ]
    ]
);

獲取所有錯誤 ?

如果你需要檢索所有驗證失敗字段的錯誤消息，你可以使用 getErrors() 方法：

$errors = $validation->getErrors();

// Returns:
[
    'field1' => 'error message',
    'field2' => 'error message',
]

如果沒有錯誤，則返回空數(shù)組。

獲取單個錯誤 ?

你可以使用 getError() 方法檢索單個字段的錯誤消息。參數(shù)名是唯一的參數(shù)：

$error = $validation->getError('username');

如果沒有錯誤，則返回空字符串。

檢查是否存在錯誤 ?

你可以使用 hasError() 方法檢查字段是否存在錯誤。字段名是唯一的參數(shù)：

if ($validation->hasError('username'))
{
    echo $validation->getError('username');
}

自定義錯誤顯示 ?

當(dāng)你調(diào)用 $validation->listErrors() 或 $validation->showError() ，它將在后臺加載一個視圖文件，該文件確定錯誤的顯示方法。默認情況下，它在經(jīng)過包裝的 div 上顯示 errors 。你可以輕松的創(chuàng)建視圖并在整個程序中使用它。

創(chuàng)建視圖 ?

第一步是創(chuàng)建視圖文件，它可以放在 view() 方法可以加載的任何地方。這意味著標準的 View 目錄，或者任何命名空間下的 View 目錄都可以正常工作。例如，可以在 /app/Views/_errors_list.php 創(chuàng)建新的視圖文件：

<div class="alert alert-danger" role="alert">
    <ul>
    <?php foreach ($errors as $error) : ?>
        <li><?= esc($error) ?></li>
    <?php endforeach ?>
    </ul>
</div>

$errors 數(shù)組可以在包含錯誤列表的視圖中使用，其中鍵是發(fā)生錯誤的字段名，值是錯誤消息，如下所示：

$errors = [
    'username' => 'The username field must be unique.',
    'email'    => 'You must provide a valid email address.'
];

實際上可以創(chuàng)建兩種類型的視圖文件。第一種包含所有錯誤消息，這就是我們剛才看到的。另一種更簡單，只包含一個錯誤消息變量 $error。它與指定字段名的 showError() 方法一起使用。

<span class="help-block"><?= esc($error) ?></span>

配置 ?

創(chuàng)建視圖后，需要讓 Validation 庫知道它們。打開 Config/Validation.php，在里面找到 $templates 屬性。你可以在其中列出任意多個自定義視圖，并提供一個可以引用他們的短別名。我們將添加上邊的示例文件，它看起來像：

public $templates = [
    'list'    => 'CodeIgniter\Validation\Views\list',
    'single'  => 'CodeIgniter\Validation\Views\single',
    'my_list' => '_errors_list'
];

指定模板 ?

通過將別名作為 listErrors 方法的第一個參數(shù)，來指定要使用的模板：

<?= $validation->listErrors('my_list') ?>

當(dāng)顯示特定字段錯誤時，你可以將別名作為第二個參數(shù)傳遞給 showError 方法，別名參數(shù)應(yīng)該在字段名稱之后：

<?= $validation->showError('username', 'my_single') ?>

創(chuàng)建自定義規(guī)則 ?

規(guī)則簡單的存儲在命名空間類中。只要自動加載器能找到它們，你可將他們存儲到任何位置。這些文件稱作規(guī)則集。要添加新的規(guī)則集，請編輯 Config/Validation.php 并將新文件添加到 $ruleSets 數(shù)組：

public $ruleSets = [
    \CodeIgniter\Validation\Rules::class,
    \CodeIgniter\Validation\FileRules::class,
    \CodeIgniter\Validation\CreditCardRules::class,
];

你可以將其添加為具有完全限定類的簡單字符串，或者使用 ::class 后綴進行添加。如上所示，這里的好處是，它在更高級的 IED 中提供了額外的一些導(dǎo)航功能。

在文件中，每一個方法都是一個規(guī)則，它必須接受字符串作為第一個字符串，并且必須返回布爾值 true 或 false 。如果通過測試則返回 true ，否則返回 false 。

class MyRules
{
    public function even(string $str): bool
    {
        return (int)$str % 2 == 0;
    }
}

默認情況下，系統(tǒng)將在 CodeIgniter\Language\en\Validation.php 中查找錯誤要使用語言字符串。在自定義規(guī)則中，你可以通過第二個參數(shù) $error 的引用來提供錯誤消息：

public function even(string $str, string &$error = null): bool
{
    if ((int)$str % 2 != 0)
    {
        $error = lang('myerrors.evenError');
        return false;
    }

    return true;
}

現(xiàn)在你可像其他規(guī)則一樣使用新的自定義規(guī)則：

$this->validate($request, [
    'foo' => 'required|even'
]);

允許參數(shù)?

如果你的方法需要使用參數(shù)，則該函數(shù)至少需要三個參數(shù)：要驗證的字符串、參數(shù)字符串以及包含提交表單所有數(shù)據(jù)的數(shù)組。 $data 數(shù)組對于像 require_with 這樣需要檢查另一個提交字段的值作為其結(jié)果基礎(chǔ)的規(guī)則來說十分方便：

public function required_with($str, string $fields, array $data): bool
{
    $fields = explode(',', $fields);

    // If the field is present we can safely assume that
    // the field is here, no matter whether the corresponding
    // search field is present or not.
    $present = $this->required($str ?? '');

    if ($present)
    {
        return true;
    }

    // Still here? Then we fail this test if
    // any of the fields are present in $data
    // as $fields is the lis
    $requiredFields = [];

    foreach ($fields as $field)
    {
        if (array_key_exists($field, $data))
        {
            $requiredFields[] = $field;
        }
    }

    // Remove any keys with empty values since, that means they
    // weren't truly there, as far as this is concerned.
    $requiredFields = array_filter($requiredFields, function ($item) use ($data) {
        return ! empty($data[$item]);
    });

    return empty($requiredFields);
}

自定義錯誤可以通過第四個參數(shù)傳遞，如上所述。

可用規(guī)則 ?

以下是可供使用的所有本地規(guī)則的列表：

注解

規(guī)則是一個字符串；參數(shù)之間 不能有空格，尤其是 is_unique 規(guī)則。 ignore_value 前后不能有空格。

// is_unique[table.field,ignore_field,ignore_value]

$validation->setRules([
    'name' => "is_unique[supplier.name,uuid, $uuid]",  // is not ok
    'name' => "is_unique[supplier.name,uuid,$uuid ]",  // is not ok
    'name' => "is_unique[supplier.name,uuid,$uuid]",   // is ok
    'name' => "is_unique[supplier.name,uuid,{uuid}]",  // is ok - see "Validation Placeholders"
]);

Rule	Parameter	Description	Example
alpha	No	Fails if field has anything other than alphabetic characters.
alpha_space	No	Fails if field contains anything other than alphabetic characters or spaces.
alpha_dash	No	Fails if field contains anything other than alphanumeric characters, underscores or dashes.
alpha_numeric	No	Fails if field contains anything other than alphanumeric characters.
alpha_numeric_space	No	Fails if field contains anything other than alphanumeric or space characters.
alpha_numeric_punct	No	Fails if field contains anything other than alphanumeric, space, or this limited set of punctuation characters: ~ (tilde), ! (exclamation), # (number), $ (dollar), % (percent), & (ampersand), * (asterisk), - (dash), _ (underscore), + (plus), = (equals), \| (vertical bar), : (colon), . (period).
decimal	No	Fails if field contains anything other than a decimal number. Also accepts a + or - sign for the number.
differs	Yes	Fails if field does not differ from the one in the parameter.	differs[field_name]
exact_length	Yes	Fails if field is not exactly the parameter value. One or more comma-separated values.	exact_length[5] or exact_length[5,8,12]
greater_than	Yes	Fails if field is less than or equal to the parameter value or not numeric.	greater_than[8]
greater_than_equal_to	Yes	Fails if field is less than the parameter value, or not numeric.	greater_than_equal_to[5]
hex	No	Fails if field contains anything other than hexadecimal characters.
if_exist	No	If this rule is present, validation will only return possible errors if the field key exists, regardless of its value.
in_list	Yes	Fails if field is not within a predetermined list.	in_list[red,blue,green]
integer	No	Fails if field contains anything other than an integer.
is_natural	No	Fails if field contains anything other than a natural number: 0, 1, 2, 3, etc.
is_natural_no_zero	No	Fails if field contains anything other than a natural number, except zero: 1, 2, 3, etc.
is_not_unique	Yes	Checks the database to see if the given value exist. Can ignore records by field/value to filter (currently accept only one filter).	is_not_unique[table.field,where_field,where_value]
is_unique	Yes	Checks if this field value exists in the database. Optionally set a column and value to ignore, useful when updating records to ignore itself.	is_unique[table.field,ignore_field,ignore_value]
less_than	Yes	Fails if field is greater than or equal to the parameter value or not numeric.	less_than[8]
less_than_equal_to	Yes	Fails if field is greater than the parameter value or not numeric.	less_than_equal_to[8]
matches	Yes	The value must match the value of the field in the parameter.	matches[field]
max_length	Yes	Fails if field is longer than the parameter value.	max_length[8]
min_length	Yes	Fails if field is shorter than the parameter value.	min_length[3]
numeric	No	Fails if field contains anything other than numeric characters.
regex_match	Yes	Fails if field does not match the regular expression.	regex_match[/regex/]
permit_empty	No	Allows the field to receive an empty array, empty string, null or false.
required	No	Fails if the field is an empty array, empty string, null or false.
required_with	Yes	The field is required when any of the other required fields are present in the data.	required_with[field1,field2]
required_without	Yes	The field is required when all of the other fields are present in the data but not required.	required_without[field1,field2]
string	No	A generic alternative to the alpha* rules that confirms the element is a string
timezone	No	Fails if field does match a timezone per `timezone_identifiers_list`
valid_base64	No	Fails if field contains anything other than valid Base64 characters.
valid_json	No	Fails if field does not contain a valid JSON string.
valid_email	No	Fails if field does not contain a valid email address.
valid_emails	No	Fails if any value provided in a comma separated list is not a valid email.
valid_ip	No	Fails if the supplied IP is not valid. Accepts an optional parameter of ‘ipv4’ or ‘ipv6’ to specify an IP format.	valid_ip[ipv6]
valid_url	No	Fails if field does not contain a valid URL.
valid_date	No	Fails if field does not contain a valid date. Accepts an optional parameter to matches a date format.	valid_date[d/m/Y]
valid_cc_number	Yes	Verifies that the credit card number matches the format used by the specified provider. Current supported providers are: American Express (amex), China Unionpay (unionpay), Diners Club CarteBlance (carteblanche), Diners Club (dinersclub), Discover Card (discover), Interpayment (interpayment), JCB (jcb), Maestro (maestro), Dankort (dankort), NSPK MIR (mir), Troy (troy), MasterCard (mastercard), Visa (visa), UATP (uatp), Verve (verve), CIBC Convenience Card (cibc), Royal Bank of Canada Client Card (rbc), TD Canada Trust Access Card (tdtrust), Scotiabank Scotia Card (scotia), BMO ABM Card (bmoabm), HSBC Canada Card (hsbc)	valid_cc_number[amex]

文件上傳規(guī)則 ?

這些驗證規(guī)則可以讓你進行基本的檢查，驗證上傳的文件是否滿足你的業(yè)務(wù)需求。由于文件上傳字段在 HTML 字段中不存在，并且存儲在 $_FILES 全局變量中，因此字段名需要輸入兩次，第一個用于指定驗證的字段，像其他規(guī)則一樣，第二次作為所有文件上傳規(guī)則的第一個參數(shù)：

// In the HTML
<input type="file" name="avatar">

// In the controller
$this->validate([
    'avatar' => 'uploaded[avatar]|max_size[avatar,1024]'
]);

Rule	Parameter	Description	Example
uploaded	Yes	Fails if the name of the parameter does not match the name of any uploaded files.	uploaded[field_name]
max_size	Yes	Fails if the uploaded file named in the parameter is larger than the second parameter in kilobytes (kb).	max_size[field_name,2048]
max_dims	Yes	Fails if the maximum width and height of an uploaded image exceed values. The first parameter is the field name. The second is the width, and the third is the height. Will also fail if the file cannot be determined to be an image.	max_dims[field_name,300,150]
mime_in	Yes	Fails if the file’s mime type is not one listed in the parameters.	mime_in[field_name,image/png,image/jpg]
ext_in	Yes	Fails if the file’s extension is not one listed in the parameters.	ext_in[field_name,png,jpg,gif]
is_image	Yes	Fails if the file cannot be determined to be an image based on the mime type.	is_image[field_name]

文件驗證規(guī)則適用于單個和多個文件上傳。

注解

你也可以使用任何最多允許兩個參數(shù)的本地 PHP 函數(shù)，其中至少需要一個參數(shù)（傳遞字段數(shù)據(jù)）。