Download the PHP package archict/firewall without Composer
On this page you can find all versions of the php package archict/firewall. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package firewall
Firewall
Control access to your resources
How to use
The majority of the work is inside the config file firewall.yml
:
Let's go in details!
User provider
To help firewall to get current user, you need to give it a User provider.
This Brick provides you the interface \Archict\Firewall\UserProvider
:
The class you pass in the config must implement this interface. It can have dependencies like a Service, they will be injected during instantiation.
User
is an interface also provided by this Brick:
Access control
This config tag must contain an array of rules.
Each rule must have at least the path
tag. This tag define the path to match, it can be a pattern with the same rules
as in Archict\router
.
Then you have the choice between let the firewall check if user can access the resource (the check is based on user roles), or implement your own checker.
Firewall checker
If you choose to use firewall checker, then you must provide these 2 tags:
provider
➡ One of the previously defined providerroles
➡ An array of string. User must have one of these roles to access resource
Then you can define the behavior with one these rules (only one):
error
➡ a HTTP error code to returnredirect_to
➡ return a 301 response with the specified uri
Your own checker
To use your own checker, your class must implement this interface:
This method returns true
if user is authorized to see resource. It can throw an exception the same way as defined
in Archict\router
. Implementation of this interface can have some dependencies in
its constructor, they will be injected during instantiation.
Then you can provide the class name to your rule with the tag checker
:
You can also provide one of the behavior tag (see Firewall checker) in case your method
returns false
.
All versions of firewall with dependencies
archict/brick Version ^0
psr/http-message Version ^2.0
archict/router Version ^0