oauth2-server/README.md

73 lines
3.3 KiB
Markdown
Raw Normal View History

2014-10-03 19:12:01 +05:30
# PHP OAuth 2.0 Server by [@alexbilbie](https://twitter.com/alexbilbie)
2013-12-06 03:02:29 +05:30
2014-10-01 03:42:43 +05:30
[![Latest Version](http://img.shields.io/packagist/v/league/oauth2-server.svg?style=flat-square)](https://github.com/thephpleague/oauth2-server/releases)
2014-10-03 19:12:01 +05:30
[![Software License](https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square)](LICENSE.md)
2014-10-01 03:42:43 +05:30
[![Build Status](https://img.shields.io/travis/thephpleague/oauth2-server/master.svg?style=flat-square)](https://travis-ci.org/thephpleague/oauth2-server)
[![Coverage Status](https://img.shields.io/scrutinizer/coverage/g/thephpleague/oauth2-server.svg?style=flat-square)](https://scrutinizer-ci.com/g/thephpleague/oauth2-server/code-structure)
[![Quality Score](https://img.shields.io/scrutinizer/g/thephpleague/oauth2-server.svg?style=flat-square)](https://scrutinizer-ci.com/g/thephpleague/oauth2-server)
2014-12-26 22:29:09 +05:30
[![Total Downloads](https://img.shields.io/packagist/dt/league/oauth2-server.svg?style=flat-square)](https://packagist.org/packages/league/oauth2-server) [![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/thephpleague/oauth2-server?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
2013-12-06 03:02:29 +05:30
2012-06-05 01:30:52 +05:30
2014-10-01 03:42:43 +05:30
A standards compliant [OAuth 2.0](http://tools.ietf.org/wg/oauth/draft-ietf-oauth-v2/) authorization server and resource 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.
2014-10-01 03:42:43 +05:30
It supports out of the box the following grants:
2014-10-01 03:42:43 +05:30
* Authorization code grant
* Client credentials grant
* Resource owner password credentials grant
* Refresh grant
2012-08-27 20:13:17 +05:30
2014-10-01 03:42:43 +05:30
You can also define your own grants.
2012-08-27 20:13:17 +05:30
2014-10-01 03:42:43 +05:30
In addition it supports the following token types:
2013-07-26 15:38:24 +05:30
2014-10-01 03:42:43 +05:30
* Bearer tokens
* MAC tokens (coming soon)
* JSON web tokens (coming soon)
2013-07-26 15:38:24 +05:30
2012-08-27 20:13:17 +05:30
2014-10-01 03:42:43 +05:30
## Requirements
2013-12-19 18:03:39 +05:30
2014-10-01 03:42:43 +05:30
The following versions of PHP are supported:
2013-12-19 18:03:39 +05:30
2014-10-01 03:42:43 +05:30
* PHP 5.4
* PHP 5.5
* PHP 5.6
* HHVM
2013-12-19 18:03:39 +05:30
2014-10-01 03:42:43 +05:30
## Documentation
2012-08-27 20:13:17 +05:30
2014-10-01 03:42:43 +05:30
This library has [full documentation](http://oauth2.thephpleague.com), powered by [Jekyll](http://jekyllrb.com/).
2012-08-27 20:13:17 +05:30
2014-10-01 03:42:43 +05:30
Contribute to this documentation in the [gh-pages branch](https://github.com/thephpleague/oauth2-server/tree/gh-pages/).
2013-02-22 19:01:05 +05:30
## Changelog
2012-08-27 20:13:17 +05:30
2014-10-01 04:46:26 +05:30
[See the project releases page](https://github.com/thephpleague/oauth2-server/releases)
2012-08-27 20:13:17 +05:30
## Contributing
2012-08-27 20:13:17 +05:30
2014-10-01 04:46:26 +05:30
Please see [CONTRIBUTING](https://github.com/thephpleague/oauth2-server/blob/master/CONTRIBUTING.md) for details.
2013-07-24 22:44:48 +05:30
## Support
2013-07-24 22:44:48 +05:30
2014-10-01 03:42:43 +05:30
Bugs and feature request are tracked on [GitHub](https://github.com/thephpleague/oauth2-server/issues)
2013-07-24 22:44:48 +05:30
## License
2013-07-24 22:44:48 +05:30
2014-10-01 04:46:26 +05:30
This package is released under the MIT License. See the bundled [LICENSE](https://github.com/thephpleague/oauth2-server/blob/master/LICENSE) file for details.
2013-07-24 22:44:48 +05:30
## Credits
2013-07-24 22:44:48 +05:30
This code is principally developed and maintained by [Alex Bilbie](https://twitter.com/alexbilbie).
2012-09-07 16:29:41 +05:30
Special thanks to:
2012-09-07 16:29:41 +05:30
* [Dan Horrigan](https://github.com/dandoescode)
* [Nick Jackson](https://github.com/jacksonj04)
* [Michael Gooden](https://github.com/MichaelGooden)
* [Phil Sturgeon](https://github.com/philsturgeon)
2014-10-01 04:46:26 +05:30
* [and all the other contributors](https://github.com/thephpleague/oauth2-server/contributors)
2013-12-06 02:50:48 +05:30
2014-08-06 22:46:16 +05:30
The initial code was developed as part of the [Linkey](http://linkey.blogs.lincoln.ac.uk) project which was funded by [JISC](http://jisc.ac.uk) under the Access and Identity Management programme.