aura / auth
Provides a unified interface to authenticate a user with local or remote authentication systems.
Maintainers
Requires
- php: >=7.2.0
Requires (Dev)
- acclimate/container: ^2
- phpunit/phpunit: ~8
- vimeo/psalm: ~v4.15
Suggests
- ext/imap: For IMAP/POP/NNTP integration.
- ext/ldap: For LDAP integration.
This package is auto-updated.
Last update: 2026-07-25 11:26:53 UTC
README
Provides authentication functionality and session tracking using various adapters; currently supported adapters are:
- Apache htpasswd files
- SQL tables via the PDO extension
- IMAP/POP/NNTP via the imap extension
- LDAP and Active Directory via the ldap extension
- OAuth via customized adapters
It also provides a secure, pluggable "remember me" feature for long-term authentication.
Note that the purpose of this package is only to authenticate user credentials. It does not currently, and probably will not in the future, handle user account creation and management. That is more properly the domain of application-level functionality, or at least a separate Aura bundle.
Foreword
Installation
This library requires PHP 8.2 or later, and depends only on aura/session-interface for its shared session contracts.
It is installable and autoloadable via Composer as aura/auth.
Alternatively, download a release or clone this repository, then require or include its autoload.php file.
Quality
To run the unit tests at the command line, issue composer install and then vendor/bin/phpunit at the package root. This requires Composer to be available as composer.
This library attempts to comply with PSR-1, PSR-2, and PSR-4. If you notice compliance oversights, please send a patch via pull request.
Community
To ask questions, provide feedback, or otherwise communicate with the Aura community, please join our Google Group, follow @auraphp on Twitter, or chat with us on #auraphp on Freenode.
Documentation
This package is fully documented here.