A lightweight and powerful OAuth 2.0 authorization and resource server library with support for all the core specification grants. This library will allow you to secure your API with OAuth and allow your applications users to approve apps that want to access their data from your API.



Security Notice

Please upgrade to version >=5.1.6 (backwards compatible) or 6.x (one tiny breaking change) to fix some potential security vulnerabilities - visit this page for more information


Latest Version Software License Build Status Coverage Status Quality Score Total Downloads

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.

It supports out of the box 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.


The following versions of PHP are supported:

  • PHP 5.6
  • PHP 7.0
  • PHP 7.1
  • PHP 7.2

The openssl extension is also required.


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


See the project releases page


Please see CONTRIBUTING.md and CONDUCT.md for details.


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.

Commercial Support

If you would like help implementing this library into your existing platform, or would be interested in OAuth advice or training for you and your team please get in touch with Glynde Labs.


If you discover any security related issues, please email hello@alexbilbie.com instead of using the issue tracker.


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


This code is principally developed and maintained by Andy Millington, Brian Retterer, and Simon Hamp.

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

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.