当 cakephp 4 中没有文件上传时避免 mimeType 验证

Question

这是我的输入文件“图像”的验证：

public function validationDefault(Validator $validator): Validator
{
    $validator = parent::validationDefault($validator);

    $validator
        ->allowEmptyFile('image')
        ->add('image', 'uploadError', [
            'rule' => function ($value, $context) {
                foreach ($value as $v) {
                    return Validation::uploadError($v, true);
                }
            },
            'last' => true,
            'message' => 'Upload error'
        ])
        ->add('image', 'mimeType', [
            'rule' => function ($value, $context) {
                foreach ($value as $v) {
                    return Validation::mimeType($v, [
                        'image/png',
                        'image/gif',
                        'image/pjpeg',
                        'image/jpeg'
                    ]);
                }
            },
            'message' => 'Bad mime type.',
        ]);

}

提交文件时效果很好，但是当没有文件上传时触发mimeType验证错误。

所以我修改了 mimeType 规则，以在检查 mimeType 之前检查文件是否已上传：

public function validationDefault(Validator $validator): Validator
{
    $validator = parent::validationDefault($validator);

    $validator
        ->allowEmptyFile('image')
        ->add('image', 'uploadError', [
            'rule' => function ($value, $context) {
                foreach ($value as $v) {
                    return Validation::uploadError($v, true);
                }
            },
            'last' => true,
            'message' => 'Upload error'
        ])
        ->add('image', 'mimeType', [
            'rule' => function ($value, $context) {

                // Added to avoid mimeType validation when no file is uploaded
                if ($value[0]->getError() === UPLOAD_ERR_NO_FILE) {
                    return true;
                }

                foreach ($value as $v) {
                    return Validation::mimeType($v, [
                        'image/png',
                        'image/gif',
                        'image/pjpeg',
                        'image/jpeg'
                    ]);
                }
            },
            'message' => 'Bad mime type.',
        ]);

}

它有效，但对我来说添加起来似乎不太干净 if ($value[0]->getError() === UPLOAD_ERR_NO_FILE) {return true;} 在 mime 类型检查之后可以添加的每条规则（例如，我将添加文件大小检查、图像宽度检查等）

有没有更好的方法在提交文件时才在文件上添加验证规则？

Answer 1

查看您的上传功能当前的结构，即所有上传都存储在同一个表中，行为通过hasMany 关联处理它们，包括仅接受单个文件的模型，以及使用多文件的前端-file 输入，一种可能的解决方案是在上传空文件的情况下简单地删除该字段。

您可以通过Model.beforeMarshal事件/回调更改数据，它将在创建/修补实体时运行，在应用验证之前，例如：

public function beforeMarshal(
    \Cake\Event\EventInterface $event,
    \ArrayAccess $data,
    \ArrayObject $options
): void {
    if (
        isset($data['image'][0]) &&
        $data['image'][0] instanceof \Psr\Http\Message\UploadedFileInterface &&
        $data['image'][0]->getError() === \UPLOAD_ERR_NO_FILE
    ) {
        unset($data['image']);
    }
}

这将删除image 字段，以防它是一个数组，并且第一个元素是一个空的上传文件对象。这是未选择文件的多文件输入以及使用数组作为名称的单文件输入所收到的内容。

当该字段不再存在时，您的验证规则将根本不运行，并且当它们确实运行时，它们不必允许这种情况，而是可以严格要求有效的上传文件对象。

因此，例如对于应该只接受单次上传的模型，您可以执行以下操作来确保该值是一个数组，该数组只包含一个带有上传文件对象的元素：

$validator
    ->add('image', 'exactlyOneUploadedFile', [
        'rule' => function ($value, $context) {
            if (
                is_array($value) &&
                count($value) === 1 &&
                $value[0] instanceof \Psr\Http\Message\UploadedFileInterface
            ) {
                return true;
            }

            return false;
        },
        // ...
    ])
    // ...

同样，对于应该接受多次上传的模型，您可以执行以下操作来确保该值是一个数组，其中包含仅上传文件对象的一个​​或多个元素：

$validator
    ->add('image', 'onlyUploadedFiles', [
        'rule' => function ($value, $context) {
            if (
                !is_array($value) ||
                count($value) < 1
            ) {
                return false;
            }

            foreach ($value as $upload) {
                if (!($upload instanceof \Psr\Http\Message\UploadedFileInterface)) {
                    return false;
                }
            }

            return true;
        },
        // ...
    ])
    // ...

您必须严格执行这些检查，这一点很重要！例如，您发布的验证规则将仅检查数组中的第一个条目，但不检查是否存在更多元素，这可能会导致发送多个上传的情况，并且额外的上传单通过未验证！

另见

• Cookbook > Database Access & ORM > Saving Data > Modifying Request Data Before Building Entities