mohammedmanssour / form-request-tester
a collection of test helpers that help with testing form requests
Installs: 147 858
Dependents: 1
Suggesters: 0
Security: 0
Stars: 90
Watchers: 5
Forks: 9
Open Issues: 6
Requires (Dev)
- orchestra/testbench: ~6.0
This package is auto-updated.
Last update: 2024-11-05 09:37:42 UTC
README
A Simple collection of test helpers that help testing form request the easy way.
Why Bother
for full story on why this package was built please refer to This Blog Post
Installation
- Using composer
composer require --dev mohammedmanssour/form-request-tester
- add
MohammedManssour\FormRequestTester\TestsFormRequests
trait to your test case.
Testing a form request
- you need to intialize the form request using
formRequest
method, it takes the FormRequest class as first argument and an array of request data as a second argument
$this->formRequest(UpdatePost::class, [ 'title' => 'New Title', 'content' => 'Some Content here' ])
or you can use the intuitive methods to set form request method and data
$this->formRequest(UpdatePost::class) ->post([ 'title' => 'New Title', 'content' => 'Some Content here' ])
the previous code will intialize the request with post
method and /fake-route
if you want to change these options you can via the options array that can be set as a third argument
$this->formRequest(UpdatePost::class, [ 'title' => 'New Title', 'content' => 'Some Content here' ], [ 'method' => 'put', 'route' => 'posts/{post}' ])
$this->formRequest(UpdatePost::class) ->put([ 'title' => 'New Title', 'content' => 'Some Content here' ]) ->withRoute('posts/{post}')
- use the available assertions to test for request
Available Assertions
Example Usage:
Taking into consderation:
- title & content are required field,
- Content field is required is a custom error message used for content field
$this->route
method is used in authorize methodRoute::put('posts/{post}', 'PostsController@update')
is the route used to update a post
$this->formRequest(UpdatePost::class,[ 'title' => 'New Title' ],[ 'method' => 'put' 'route' => 'posts/{post}' ])->assertAuthorized() ->assertValidationFailed() ->assertValidationErrors(['content']) ->assertValidationErrorsMissing(['title']) ->assertValidationMessages(['Content field is required'])
you can now use intuitive methods to build form request
$this->formRequest(UpdatePost::class) ->put([ 'title' => 'New Title' ]) ->withRoute('posts/1') ->assertAuthorized() ->assertValidationFailed() ->assertValidationErrors(['content']) ->assertValidationErrorsMissing(['title']) ->assertValidationMessages(['Content field is required'])
Form Requests related methods and how to work with them
$this->route('parameter')
:
This method basically retreive the value of a routing rule parameter.
For example if you have a routing rule put posts/{post}
and browsed to posts/1
then the value of $this->route('post')
is 1.
for this to work with the package you need to
- Register the routing rule in your application routing files
web.php
orapi.php
Route::put('posts/{post}', [PostsController::class, 'update']);
- set the route using FormRequestTester
withRoute
method
$this->formRequest(UpdatePost::class) ->put($data) ->withRoute('posts/1');
this why when you use the $this->route('post')
in your form request, the result will be 1.
The package also supports substitube binding. All you need to be is to ؤreate an explicit binding and will do the work for you.
// somewhere in your app 🤔, ideally, your service provider Route::model('post', Post::class);
when you do the reigster, the value of $this->route('post')
will be a Post model rather than the id.
Alternatively
if you don't want to register a route just for the sake of resolving a route parameter then you can use FormRequestTester addRouteParameter($name, $value)
.
$this->formRequest(UpdatePost::class) ->put($data) ->addRouteParameter('post', 1) ->assertAuthorized();
according to the example above, with the new method addRouteParameter
, $this->route('post')
will be resolved to 1
$this->user()
:
This method will reteive the current authenticated user.
use laravel testing method actingAs
to set a user as the current authenticated user
$user = User::factory()->create(); $this->actingAs($user);