Why

Colin DeCarlo gave a talk on Laracon online 21 about unit testing Laravel form requests classes. If you haven't seen his talk, I recommend that you watch it. He prefers testing form requests as a unit and not as feature tests.I like this approach too.

He asked Freek Van der Herten to convert his gist code to package. Granted, I am not Freek; however, I accepted the challenge, and I did it myself. So this package is just a wrapper for Colin's gist, and I added two methods from Jason's package for asserting that controller has the form request.

Installation

composer require --dev jcergolj/laravel-form-request-assertions

Usage

Controller

  
   web.php routes 
  
  
 
 
  
    Request 
   
   user()->id === 1 && $this->post->id === 1;
    }

    function rules()
    {
        return ['email' => ['required', 'email']];
    }
}

 
  
  
    Add trait to unit test
 After package installation add the TestableFormRequest trait 
   
   
 
  
  
     Does the controller have the form request test? 
    
    public function controller_has_form_request()
{
    $this->assertActionUsesFormRequest(PostController::class, 'store', CreatePostRequest::class);
}
 
   
  
     Test Validation Rules 
    
    public function email_is_required()
{
    $this->createFormRequest(CreatePostRequest::class)
        ->validate(['email' => ''])
        ->assertFails(['email' => 'required'])
	    ->assertHasMessage('Email is required', 'required')
}
 
   
  
     Test Form Request 
    
     /** @test */
function test_post_author_is_authorized()
{
    $author = User::factory()->make(['id' => 1]);
    $post = Post::factory()->make(['id' => 1]);

    $this->createFormRequest(CreatePostRequest::class)
        ->withParam('post', $post)
        ->actingAs($author)
        ->assertAuthorized();
}
 
   
  
     Available Methods 
    
    createFormRequest(string $requestClass, $headers = [])
 
    
    
    assertRouteUsesFormRequest(string $routeName, string $formRequest)
 
    
    
    assertActionUsesFormRequest(string $controller, string $method, string $form_request)
 
    
    
    validate(array $data)
 
    
    
    by(Authenticatable $user = null)
 
    
    
    actingAs(Authenticatable $user = null)
 
    
    
    withParams(array $params)
 
    
    
    withParam(string $param, $value)
 
    
    
    assertAuthorized()
 
    
    
    assertNotAuthorized()
 
    
    
    assertPasses()
 
    
    
    assertFails($expectedFailedRules = [])
 
    
    
    assertHasMessage($message, $rule = null)
 
    
    
    getFailedRules()
 
   
  
     Contributors
 A huge thanks go to Colin and Jason. I created a package from Colin's gist and I copied two methods from Jason's package. 
    
     
      
         
 _{Colin DeCarlo}   
         
 _{Jason McCreary}   
         
 _{Janez Cergolj}

Releases(v1.3)

v1.3(Nov 3, 2021)

bugfix
Source code(tar.gz)
Source code(zip)
v1.2(Nov 3, 2021)

add option to pass rule classes to assertFails method
Source code(tar.gz)
Source code(zip)
v1.1(Nov 3, 2021)

add param contains an instance of a rule assertion
Source code(tar.gz)
Source code(zip)
v1.0(Oct 8, 2021)

Fixing bugs, adding few methods
Source code(tar.gz)
Source code(zip)
v0.9(Oct 7, 2021)

First working version
Source code(tar.gz)
Source code(zip)