Laravel文件上传测试：如何上传可通过验证的真实或测试文件？

在Laravel项目中，使用ImportCustomersRequest请求类处理文件上传，前端真实上传时正常，但PHPUnit测试中始终提示'importfile needs to be a file.'，无法通过验证进入控制器。

相关代码 #

控制器代码 #

public function importCustomers(ImportCustomersRequest $request)
{
    dump('importCustomers called!');
}

ImportCustomersRequest验证规则 #

public function rules(): array
{
    dump('importfile', $this->importfile);

    return [
        'importfile' => 'required|file',
    ];
}

测试代码（无效写法） #

$file = UploadedFile::fake()->createWithContent('customer.csv', 'id;name;group\n9999;Customer1;');

// 其他无效尝试：
// $file = UploadedFile::fake()->create('customer.csv')
// $file = Storage::path('development/customers.csv')

$response = $this->post(route('import.customers', ['importfile' => $file]));
$response->assertStatus(302);

测试中的异常情况 #

前端上传时，dump($this->importfile)得到的是正常的Illuminate\Http\UploadedFile实例；但PHPUnit测试中得到的是：

array:2 [
  "name" => "customer.csv"
  "sizeToReport" => "67"
]

问题核心：测试时错误地将文件放到请求参数数组中，导致UploadedFile对象被转成普通数组，无法通过file验证。文件上传必须通过请求的文件参数传递。

方案1：使用带自定义内容的Fake文件（推荐） #

修正测试代码，通过post方法的第三个参数（files数组）传递文件，或使用attach辅助方法：

写法1：用files参数传递 #

$file = UploadedFile::fake()->createWithContent('customer.csv', "id;name;group\n9999;Customer1;");

// post方法的参数顺序：(url, params, headers, files)
$response = $this->post(route('import.customers'), [], [], ['importfile' => $file]);

$response->assertStatus(302);

写法2：用attach方法 #

$fileContent = "id;name;group\n9999;Customer1;";

$response = $this->post(route('import.customers'))
    ->attach('importfile', $fileContent, 'customer.csv');

$response->assertStatus(302);

方案2：使用真实文件 #

如果需要使用项目中已存在的真实文件，需手动实例化UploadedFile，并确保传递方式正确：

// 获取真实文件的绝对路径
$filePath = storage_path('app/development/customers.csv');

// 创建UploadedFile实例，最后一个参数设为true表示测试环境，避免移动真实文件
$file = new \Illuminate\Http\UploadedFile(
    $filePath,
    'customers.csv',
    'text/csv',
    null,
    true
);

// 传递文件并发起请求
$response = $this->post(route('import.customers'), [], [], ['importfile' => $file]);
// 或者用attach方法
// $response = $this->post(route('import.customers'))->attach('importfile', file_get_contents($filePath), 'customers.csv');

$response->assertStatus(302);

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