A spec compliant, secure by default PHP OAuth 2.0 Server

Go to file

Andrew Millington 0b0b43d433 Merge pull request #1035 from matt-allan/prevent-public-client-confidential-grant Prevent public clients from using the client_credentials grant type		2019-07-25 19:20:11 +01:00
examples	Fix inheritdoc case	2019-07-13 17:49:26 +01:00
src	Add blank line above throw	2019-07-25 19:04:44 +01:00
tests	Add blank space to keep formatting consistent	2019-07-25 19:09:47 +01:00
.gitattributes	fix .gitattributes	2018-01-03 09:41:39 +01:00
.gitignore	Merge master into 8.0.0 branch	2019-05-14 15:46:01 +01:00
.scrutinizer.yml	Updated .scrutenizer.yml	2016-04-18 12:23:13 +01:00
.styleci.yml	removing simplified_null_return	2019-04-29 19:13:26 +02:00
.travis.yml	Remove branch 8.0.0 from travis checks	2019-07-13 19:56:44 +01:00
CHANGELOG.md	Reword changelog	2019-07-25 19:14:08 +01:00
CODE_OF_CONDUCT.md	Rename CONDUCT.md to CODE_OF_CONDUCT.md	2018-04-21 22:25:51 +01:00
CONTRIBUTING.md	Fix #772 - PR should be based on master branch	2017-07-29 17:41:44 +02:00
LICENSE	Rename license file	2015-12-03 14:30:37 +01:00
README.md	Remove Simon Hamp from README	2019-07-02 22:20:37 +01:00
composer.json	Removing php stan strict rules	2019-07-02 22:10:17 +01:00
phpstan.neon	Fix phpstan issues	2019-07-01 19:17:43 +01:00
phpunit.xml.dist	Ignore TemplateRenderer method	2016-03-10 17:45:31 +00:00

README.md

PHP OAuth 2.0 Server

league/oauth2-server is a standards compliant implementation of an OAuth 2.0 authorization server written in PHP which makes working with OAuth 2.0 trivial. You can easily configure an OAuth 2.0 server to protect your API with access tokens, or allow clients to request new access tokens and refresh them.

Out of the box it supports the following grants:

Authorization code grant
Implicit grant
Client credentials grant
Resource owner password credentials grant
Refresh grant

The following RFCs are implemented:

This library was created by Alex Bilbie. Find him on Twitter at @alexbilbie.

Requirements

The following versions of PHP are supported:

PHP 7.1
PHP 7.2
PHP 7.3

The openssl and json extensions are also required.

All HTTP messages passed to the server should be PSR-7 compliant. This ensures interoperability with other packages and frameworks.

Installation

composer require league/oauth2-server

Documentation

The library documentation can be found at https://oauth2.thephpleague.com. You can contribute to the documentation in the gh-pages branch.

Testing

The library uses PHPUnit for unit tests and PHPStan for static analysis of the code.

vendor/bin/phpunit
vendor/bin/phpstan analyse -l 7 -c phpstan.neon src tests

Continous Integration

We use Travis CI, Scrutinizer, and StyleCI for continuous integration. Check out our configuration files if you'd like to know more.

Community Integrations

Changelog

See the project changelog

Contributing

Contributions are always welcome. Please see CONTRIBUTING.md and CODE_OF_CONDUCT.md for details.

Support

Bugs and feature request are tracked on GitHub.

If you have any questions about OAuth please open a ticket here; please don't email the address below.

Security

If you discover any security related issues, please email andrew@noexceptions.io instead of using the issue tracker.

License

This package is released under the MIT License. See the bundled LICENSE file for details.

Credits

This code is principally developed and maintained by Andy Millington.

Between 2012 and 2017 this library was developed and maintained by Alex Bilbie.

PHP OAuth 2.0 Server is one of many packages provided by The PHP League. To find out more, please visit our website.

Special thanks to all of these awesome contributors.

Additional thanks go to the Mozilla Secure Open Source Fund for funding a security audit of this library.

The initial code was developed as part of the Linkey project which was funded by JISC under the Access and Identity Management programme.