バリデーションルール

デフォルトでは、モデルにバリデーションルールは設定されません。必要なルールはそれぞれ明示的に設定する必要があります。 PHP のアップロードエラーに関係しないルールは設定できますが、設定しない場合はビヘイビアの設定が使われます。

isUnderPhpSizeLimit

ファイルが PHP で指定された最大ファイルサイズを超えていないことをチェックします。

public $validate = [
    'photo' => [
        'rule' => 'isUnderPhpSizeLimit',
        'message' => 'File exceeds upload filesize limit',
    ],
];

isUnderFormSizeLimit

ファイルが HTML フォームで指定された最大ファイルサイズを超えていないことをチェックします。

public $validate = [
    'photo' => [
        'rule' => 'isUnderFormSizeLimit',
        'message' => 'File exceeds form upload filesize limit',
    ],
];

isCompletedUpload

ファイルが完全にアップロードされたことをチェックします。

public $validate = [
    'photo' => [
        'rule' => 'isCompletedUpload',
        'message' => 'File was not successfully uploaded',
    ],
];

isFileUpload

ファイルがアップロードされたことをチェックします。

public $validate = [
    'photo' => [
        'rule' => 'isFileUpload',
        'message' => 'File was missing from submission',
    ],
];

isFileUploadOrHasExistingValue

ファイルがアップロードされたか、データベースの既存の値が空でないことをチェックします。

public $validate = [
    'photo' => [
        'rule' => 'isFileUploadOrHasExistingValue',
        'message' => 'File was missing from submission',
    ],
];

tempDirExists

PHP の一時ディレクトリが存在することをチェックします。

public $validate = [
    'photo' => [
        'rule' => 'tempDirExists',
        'message' => 'The system temporary directory is missing',
    ],
];

引数 $requireUpload を渡すと、ファイルがアップロードされていない場合にこのチェックをスキップできます。

public $validate = [
    'photo' => [
        'rule' => ['tempDirExists', false],
        'message' => 'The system temporary directory is missing',
    ],
];

上の例では、変数 $requireUpload の値は false です。デフォルトでは requireUpload は true です。

isSuccessfulWrite

ファイルがサーバーに正常に書き込まれたことをチェックします。

public $validate = [
    'photo' => [
        'rule' => 'isSuccessfulWrite',
        'message' => 'File was unsuccessfully written to the server',
    ],
];

引数 $requireUpload を渡すと、ファイルがアップロードされていない場合にこのチェックをスキップできます。

public $validate = [
    'photo' => [
        'rule' => ['isSuccessfulWrite', false],
        'message' => 'File was unsuccessfully written to the server',
    ],
];

上の例では、変数 $requireUpload の値は false です。デフォルトでは requireUpload は true です。

noPhpExtensionErrors

PHP の拡張モジュールがエラーを起こさなかったことをチェックします。

public $validate = [
    'photo' => [
        'rule' => 'noPhpExtensionErrors',
        'message' => 'File was not uploaded because of a faulty PHP extension',
    ],
];

引数 $requireUpload を渡すと、ファイルがアップロードされていない場合にこのチェックをスキップできます。

public $validate = [
    'photo' => [
        'rule' => ['noPhpExtensionErrors', false],
        'message' => 'File was not uploaded because of a faulty PHP extension',
    ],
];

上の例では、変数 $requireUpload の値は false です。デフォルトでは requireUpload は true です。

isValidMimeType

ファイルが有効な MIME タイプであることをチェックします。

public $validate = [
    'photo' => [
        'rule' => ['isValidMimeType', ['application/pdf', 'image/png']],
        'message' => 'File is not a pdf or png',
    ],
];

引数 $requireUpload を渡すと、ファイルがアップロードされていない場合にこのチェックをスキップできます。

public $validate = [
    'photo' => [
        'rule' => ['isValidMimeType', ['application/pdf', 'image/png'], false],
        'message' => 'File is not a pdf or png',
    ],
];

上の例では、変数 $requireUpload の値は false です。デフォルトでは requireUpload は true です。

isWritable

アップロード先のディレクトリが書き込み可能であることをチェックします。

public $validate = [
    'photo' => [
        'rule' => ['isWritable'],
        'message' => 'File upload directory was not writable',
    ],
];

引数 $requireUpload を渡すと、ファイルがアップロードされていない場合にこのチェックをスキップできます。

public $validate = [
    'photo' => [
        'rule' => ['isWritable', false],
        'message' => 'File upload directory was not writable',
    ],
];

上の例では、変数 $requireUpload の値は false です。デフォルトでは requireUpload は true です。

isValidDir

アップロード先のディレクトリが存在することをチェックします。

public $validate = [
    'photo' => [
        'rule' => ['isValidDir'],
        'message' => 'File upload directory does not exist',
    ],
];

引数 $requireUpload を渡すと、ファイルがアップロードされていない場合にこのチェックをスキップできます。

public $validate = [
    'photo' => [
        'rule' => ['isValidDir', false],
        'message' => 'File upload directory does not exist',
    ],
];

上の例では、変数 $requireUpload の値は false です。デフォルトでは requireUpload は true です。

isBelowMaxSize

ファイルがアップロードの最大ファイルサイズを下回っていることをチェックします (バイト単位)。

public $validate = [
    'photo' => [
        'rule' => ['isBelowMaxSize', 1024],
        'message' => 'File is larger than the maximum filesize',
    ],
];

引数 $requireUpload を渡すと、ファイルがアップロードされていない場合にこのチェックをスキップできます。

public $validate = [
    'photo' => [
        'rule' => ['isBelowMaxSize', 1024, false],
        'message' => 'File is larger than the maximum filesize',
    ],
];

上の例では、変数 $requireUpload の値は false です。デフォルトでは requireUpload は true です。

isAboveMinSize

ファイルがアップロードの最小ファイルサイズを上回っていることをチェックします (バイト単位)。

public $validate = [
    'photo' => [
        'rule' => ['isAboveMinSize', 1024],
        'message' => 'File is below the minimum filesize',
    ],
];

引数 $requireUpload を渡すと、ファイルがアップロードされていない場合にこのチェックをスキップできます。

public $validate = [
    'photo' => [
        'rule' => ['isAboveMinSize', 1024, false],
        'message' => 'File is below the minimum filesize',
    ],
];

上の例では、変数 $requireUpload の値は false です。デフォルトでは requireUpload は true です。

isValidExtension

ファイルが有効な拡張子を持っていることをチェックします。

public $validate = [
    'photo' => [
        'rule' => ['isValidExtension', ['pdf', 'png', 'txt']],
        'message' => 'File does not have a pdf, png, or txt extension',
    ],
];

引数 $requireUpload を渡すと、ファイルがアップロードされていない場合にこのチェックをスキップできます。

public $validate = [
    'photo' => [
        'rule' => ['isValidExtension', ['pdf', 'png', 'txt'], false],
        'message' => 'File does not have a pdf, png, or txt extension',
    ],
];

上の例では、変数 $requireUpload の値は false です。デフォルトでは requireUpload は true です。

isAboveMinHeight

ファイルが必要な最小の高さを上回っていることをチェックします (ピクセル単位)。

public $validate = [
    'photo' => [
        'rule' => ['isAboveMinHeight', 150],
        'message' => 'File is below the minimum height',
    ],
];

引数 $requireUpload を渡すと、ファイルがアップロードされていない場合にこのチェックをスキップできます。

public $validate = [
    'photo' => [
        'rule' => ['isAboveMinHeight', 150, false],
        'message' => 'File is below the minimum height',
    ],
];

上の例では、変数 $requireUpload の値は false です。デフォルトでは requireUpload は true です。

isBelowMaxHeight

ファイルが必要な最大の高さを下回っていることをチェックします (ピクセル単位)。

public $validate = [
    'photo' => [
        'rule' => ['isBelowMaxHeight', 150],
        'message' => 'File is above the maximum height',
    ],
];

引数 $requireUpload を渡すと、ファイルがアップロードされていない場合にこのチェックをスキップできます。

public $validate = [
    'photo' => [
        'rule' => ['isBelowMaxHeight', 150, false],
        'message' => 'File is above the maximum height',
    ],
];

上の例では、変数 $requireUpload の値は false です。デフォルトでは requireUpload は true です。

isAboveMinWidth

ファイルが必要な最小の幅を上回っていることをチェックします (ピクセル単位)。

public $validate = [
    'photo' => [
        'rule' => ['isAboveMinWidth', 150],
        'message' => 'File is below the minimum width',
    ],
];

引数 $requireUpload を渡すと、ファイルがアップロードされていない場合にこのチェックをスキップできます。

public $validate = [
    'photo' => [
        'rule' => ['isAboveMinWidth', 150, false],
        'message' => 'File is below the minimum width',
    ],
];

上の例では、変数 $requireUpload の値は false です。デフォルトでは requireUpload は true です。

isBelowMaxWidth

ファイルが必要な最大の幅を下回っていることをチェックします (ピクセル単位)。

public $validate = [
    'photo' => [
        'rule' => ['isBelowMaxWidth', 150],
        'message' => 'File is above the maximum width',
    ],
];

引数 $requireUpload を渡すと、ファイルがアップロードされていない場合にこのチェックをスキップできます。

public $validate = [
    'photo' => [
        'rule' => ['isBelowMaxWidth', 150, false],
        'message' => 'File is above the maximum width',
    ],
];

上の例では、変数 $requireUpload の値は false です。デフォルトでは requireUpload は true です。