Download the PHP package gobline/auth without Composer
On this page you can find all versions of the php package gobline/auth. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Package auth
Short Description Authentication component
License BSD-3-Clause
Homepage https://github.com/gobline
Informations about the package auth
Authentication component
Most oftenly, your server needs a way to identify the user making the current request. The authentication component provides a means for representing the user making the request and for authenticating this user against a DB or other datasource.
- the allows the server to identify the user making the current request.
- the allows the server to authenticate the user with provided credentials.
Usage
In order to authenticate a user, you will first need to create a object.
Once we have a user, we can authenticate the latter using an adapter implementing . One implementation is already provided, authenticating the user against a database: .
Firstly, we will have to set up the adapter. The requires a PDO instance and an instance of wrapping some metadata about the DB table we are authenticating against.
By default, assumes that
- the column contains the id of the user
- the column contains the login of the user
- the column contains the password of the user
- the password encryption is bcrypt (possible values are: bcrypt, md5, sha1 or clear)
Customize these metadata for your database.
You will also notice that besides the id, login and password, it is possible to specify a column containing the role (or group, type) of the user. This is especially useful when combining the authentication component with an ACL component (which is usually the case).
Now that we have set up our adapter, it's time to authenticate the user.
The authenticator sets the id and the login of the user. It can additionally add the user's role (for ACL) and other column data.
An authenticated user is a user whose id is not null.
Persist the user's data among requests
While the above works perfectly for the first request, the user's data will be lost on subsequent requests. One way to achieve persistence is to store the user data in session. acts like a decorator over (or any implementation), allowing to persist the data in session.
Installation
You can install Gobline Auth using the dependency management tool Composer. Run the require command to resolve and download the dependencies: