A Stack middleware to enable HTTP Basic Authentication following the STACK-2 Authentication conventions.
Through Composer as dflydev/stack-basic-authentication.
The BasicAuthentication middleware accepts the following options:
- authenticator: (required) A callback used to ensure that the specified credentials are correct.
- realm: The HTTP Basic Authentication realm as defined by RFC1945.
- firewall: A firewall configuration compatible with dflydev/stack-firewall.
<?php
$authenticator = function ($username, $password) {
// Given a username and password credentials, ensure that
// the credentials are correct and return a token that
// represents the user for this request.
if ('admin' === $username && 'default' === $password) {
return 'admin-user-token';
}
};
$app = new Dflydev\Stack\BasicAuthentication($app, [
'firewall' => [
['path' => '/', 'anonymous' => true],
['path' => '/login'],
],
'authenticator' => $authenticator,
'realm' => 'here there be dragons',
]);
See the examples/
directory for some live examples of this middleware in
action.
MIT, see LICENSE.
If you have questions or want to help out, join us in the #stackphp or #dflydev channels on irc.freenode.net.