如何在Laminas框架中检查是否选择上传文件并修复验证逻辑

在Laminas框架项目中，我希望通过输入过滤器检查用户是否选择了要上传的文件，并在未选择时显示对应提示消息。当前代码存在问题：点击上传按钮但未选择文件时，不会触发文件未选择的检查，直接验证文件扩展名。当前代码如下：

// file_upload
$this->add([
    'name' => 'file_upload',
    'required' => true,
    'filters' => [],
    'validators' => [
        [
            'name' => 'NotEmpty',
            'options' => [
                'message' => 'There is no file selected',
                'break_chain_on_failure' => true
            ]
        ],
        [
            'name' => 'Laminas\Validator\File\Extension',
            'options' => [
                'extension' => 'csv',
                'message' => 'Files that have the extension "%extension%" are only allowed',
                'break_chain_on_failure' => true
            ]
        ],
        [
            'name' => 'Laminas\Validator\File\Size',
            'options' => [
                'min' => '10B',
                'max' => '12Mb',
                'message' => 'Cannot import the CSV file data. No data was found within the CSV file, or, the data was incomplete or invalid.',
                'break_chain_on_failure' => true
            ]
        ],
    ]
]);

需要修复实现：用户点击上传按钮但未选择文件时，显示“未选择文件”的提示消息。

问题出在你使用了通用的NotEmpty验证器，而文件上传场景需要使用Laminas专门的文件验证器来检测是否有文件被上传。通用的NotEmpty无法正确识别文件上传控件的空值状态，需要替换为Laminas\Validator\File\UploadFile，它会专门检查是否有文件被成功上传（包括未选择文件的情况）。

修改后的代码如下：

// file_upload
$this->add([
    'name' => 'file_upload',
    'required' => true,
    'filters' => [],
    'validators' => [
        [
            'name' => 'Laminas\Validator\File\UploadFile',
            'options' => [
                'messages' => [
                    \Laminas\Validator\File\UploadFile::NO_FILE => 'There is no file selected',
                    \Laminas\Validator\File\UploadFile::INI_SIZE => 'File exceeds the upload limit set in php.ini',
                    \Laminas\Validator\File\UploadFile::FORM_SIZE => 'File exceeds the upload limit set in the form',
                    // 可根据需求添加其他上传错误提示
                ],
                'break_chain_on_failure' => true
            ]
        ],
        [
            'name' => 'Laminas\Validator\File\Extension',
            'options' => [
                'extension' => 'csv',
                'message' => 'Files that have the extension "%extension%" are only allowed',
                'break_chain_on_failure' => true
            ]
        ],
        [
            'name' => 'Laminas\Validator\File\Size',
            'options' => [
                'min' => '10B',
                'max' => '12Mb',
                'message' => 'Cannot import the CSV file data. No data was found within the CSV file, or, the data was incomplete or invalid.',
                'break_chain_on_failure' => true
            ]
        ],
    ]
]);

关键说明： #

• 用Laminas\Validator\File\UploadFile替换原有的NotEmpty，这个验证器会直接检查文件上传的状态，当用户未选择文件时，会触发NO_FILE错误，对应你设置的提示消息。
• break_chain_on_failure保持为true，这样一旦检测到未选择文件，就会停止后续的扩展名、大小验证，直接返回提示。
• 可根据需求添加其他上传错误的提示消息，比如文件大小超过php.ini限制、表单限制等，提升用户体验。

内容的提问来源于stack exchange，提问作者Tharisha Perera