バリデーション

ビヘイビアは、ファイルのフィールド用のバリデーションルールを追加します。CakePHPのほかのルールと同じように、$validateに書いて使います。

public $validate = [
    'image' => [
        'allowExtension' => [
            'rule' => ['checkExtension', ['jpg', 'jpeg', 'png']],
            'allowEmpty' => true,
        ],
        'maxFileSize' => [
            'rule' => ['checkMaxFileSize', '2MB'],
            'allowEmpty' => true,
        ],
    ],
];

ルール

ルール	成功する条件
['checkExtension', ['jpg', 'png']]	ファイル名の拡張子が、指定したいずれかに一致する。大文字と小文字は区別しません。文字列でも指定できます。
['checkContentType', ['image/jpeg', 'image/png']]	ファイルのコンテンツタイプが、指定したいずれかに一致する。タイプは正規表現として扱います。文字列でも指定できます。
['checkMaxFileSize', '2MB']	ファイルが指定したサイズ以下である。
['checkMinFileSize', '1KB']	ファイルが指定したサイズ以上である。
['checkFileSize', '2MB']	checkMaxFileSizeと同じ。
['notEmptyFile']	ファイルがアップロードされている。
['alphaNumericFileName']	ファイル名が文字、数字、ドットだけでできている。
['funcCheckFile', 'checkIllegalCode']	アップロードされたファイルのパスを渡した関数やモデルのメソッドが、trueを返す。

ファイルサイズ

サイズのルールに渡せるのは、バイト数か単位付きの数値です。

単位	例	バイト数
KまたはKB	'100KB'	102400
MまたはMB	'2MB'	2097152
GまたはGB	'1G'	1073741824
TまたはTB	'1TB'	1099511627776

単位の大文字と小文字は区別しません。'2mb'と'2MB'は同じ意味です。

コンテンツタイプ

Ringコンポーネントは、アップロードされたファイルのコンテンツタイプを、fileinfo拡張でファイルの内容から判定します。判定したタイプはfile_content_typeに保存します。ブラウザが送ったタイプはユーザーが書き換えられるので使いません。

ビヘイビアは、ファイルを保存するときにもう一度タイプを判定します。保存するデータに何が入っていても、保存されるのは判定したタイプです。fileinfoでタイプがわからないときはapplication/octet-streamになります。

checkContentTypeが調べるのも、この判定したタイプです。loaderアクションは、このタイプとX-Content-Type-Options: nosniffヘッダーを付けてファイルを送ります。

ファイルの内容を調べる

funcCheckFileは、アップロードされたファイルのパスを渡して関数かモデルのメソッドを呼びます。メソッドがtrueを返せば成功です。ファイルが存在しないときは、メソッドを呼ばずに失敗します。

次のルールは、モデルのcheckIllegalCode()メソッドを呼びます。

public $validate = [
    'image' => [
        'illegalCode' => [
            'rule' => ['funcCheckFile', 'checkIllegalCode'],
            'allowEmpty' => true,
        ],
    ],
];

このメソッドは、PHPのコードを含むファイルを拒否します。

/**
 * Checks that a file has no PHP code.
 *
 * @param string $filePath Path of the uploaded file.
 * @return bool
 */
public function checkIllegalCode($filePath)
{
    return !preg_match('/<\?php/i', (string)file_get_contents($filePath));
}