PHPackages vdmi/guzzle-oauth - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [HTTP & Networking](/categories/http) 4. / 5. vdmi/guzzle-oauth ActiveLibrary[HTTP & Networking](/categories/http) vdmi/guzzle-oauth ================= An oAuth 1 and oAuth 2 library based on Guzzle with the big four (google, linkedin, twitter, facebook) baked in. v0.0.4(7y ago)873.2k1MITPHPPHP >=5.3.0 Since Apr 6Pushed 7y ago2 watchersCompare [ Source](https://github.com/VDMi/Guzzle-oAuth)[ Packagist](https://packagist.org/packages/vdmi/guzzle-oauth)[ Docs](http://github.com/VDMi/Guzzle-oAuth)[ RSS](/packages/vdmi-guzzle-oauth/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (2)Dependencies (1)Versions (5)Used By (0) Guzzle-oAuth ============ [](#guzzle-oauth) Guzzle oAuth is a oAuth 1 and oAuth 2 library based on Guzzle with the big four (google, linkedin, twitter, facebook) baked in. ### Installing via Composer [](#installing-via-composer) The recommended way to install Guzzle oAuth is through [Composer](http://getcomposer.org). ``` # Install Composer curl -sS https://getcomposer.org/installer | php ``` Next, update your project's composer.json file to include Guzzle oAuth: ``` { "require": { "vdmi/guzzle-oauth": ">=0.0.1" } } ``` After installing, you need to require Composer's autoloader: ``` require 'vendor/autoload.php'; ``` ### Example with other provider [](#example-with-other-provider) See for an example that uses another provider then one of the big four. The example is an implementation of meetup.com as provider. ### Usage [](#usage) Guzzle oAuth makes the flow to authorize and the user info abstract. That means that you can use the same code for all providers to authorize, get an access token and get the account information. Send user to provider. ``` // Authorize flow, send user to provider to authorize $config = array( 'consumer_key' => '--YOUR-APP-ID-FROM-FACEBOOK--', 'consumer_secret' => '--YOUR-APP-SECRET-FROM-FACEBOOK--', 'scope' => 'email,manage_pages', // scopes for this connection ); $provider = 'facebook'; $client = \GuzzleOauth\Consumers::get($provider, $config); // return path after authorization. $callback_uri = 'http://test.com/callback/uri'; // state param, that makes the round trip to facebook and must be the same on return. $state = '--some-random-string--'; //optional // oAuth2 does not use request tokens, we use it here to be consistent with oAuth1 // This makes it possible to replace 'facebook' with 'twitter' in $provider without // changing the code. $request_token = $client->getRequestToken($callback_uri); // get the redirect url $url = $client->getAuthorizeUrl($request_token, $callback_uri, $state); // Note! // You need to store $request_token (and $state) in a session or db, so that you can // pickit up on return. $_SESSION['REQUEST_TOKEN_' . $provider] = serialize($request_token); // send the user to facebook to login and authorize your app. header('Location: ' . $url); exit; ``` On the callback router ``` // Return (callback) after authorize // In our example we are on $callback_uri (http://test.com/callback/uri) // We setup our client again $config = array( 'consumer_key' => '--YOUR-APP-ID-FROM-FACEBOOK--', 'consumer_secret' => '--YOUR-APP-SECRET-FROM-FACEBOOK--', 'scope' => 'email,manage_pages', // scopes for this connection ); $provider = 'facebook'; $client = \GuzzleOauth\Consumers::get($provider, $config); // Let's get the request token $request_token = unserialize($_SESSION['REQUEST_TOKEN_' . $provider]); // we could test if $_GET['state'] is the same as the $state from above. // Let us get the access_token $access_token = $client->getAccessToken($_GET, $request_token); // Store access token in session, unset request token unset($_SESSION['REQUEST_TOKEN_' . $provider]); $_SESSION['ACCESS_TOKEN_' . $provider] = serialize($access_token); ``` When we have a valid access token ``` // Now that we have an access token, do calls to facebook $provider = 'facebook'; // Get access token $access_token = unserialize($_SESSION['ACCESS_TOKEN_' . $provider]); // Add access token to config $config = array( 'consumer_key' => '--YOUR-APP-ID-FROM-FACEBOOK--', 'consumer_secret' => '--YOUR-APP-SECRET-FROM-FACEBOOK--', 'scope' => 'email,manage_pages', // scopes for this connection ) + $access_token; // create client $client = \GuzzleOauth\Consumers::get($provider, $config); // Get a collection with all user info $info = $client->getUserInfo(); // Get remote user id without making a new http call $facebook_id = $client->getUserId($info); // Get remote user id making a new http call $facebook_id = $client->getUserId(); // Get email (if provider provides one (note FB needs the scope 'email')) $email = $client->getUserEmail($info); // Get user account label (name) $label = $client->getUserLabel($info); // $client is a normal guzzle client, so we can talk to any endpoint. $data = $client->get('me/likes')->send()->json(); ``` ### Health Score 33 — LowBetter than 75% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity35 Limited adoption so far Community12 Small or concentrated contributor base Maturity51 Maturing project, gaining track record Bus Factor1 Top contributor holds 58.3% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~621 days Total 4 Last Release 2561d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/8a13b24f2b68d178490e1427aabef5176d284653a1eb9a4c8ef5bf156e4447f7?d=identicon)[FransvanderMeer](/maintainers/FransvanderMeer) --- Top Contributors [![FransvanderMeer](https://avatars.githubusercontent.com/u/4189592?v=4)](https://github.com/FransvanderMeer "FransvanderMeer (7 commits)")[![makchich](https://avatars.githubusercontent.com/u/24384976?v=4)](https://github.com/makchich "makchich (3 commits)")[![matglas](https://avatars.githubusercontent.com/u/572208?v=4)](https://github.com/matglas "matglas (2 commits)") --- Tags restfacebookgoogleGuzzleoauthoauth2twitteroauth1linkedin ### Embed Badge ![Health badge](/badges/vdmi-guzzle-oauth/health.svg) ``` [![Health](https://phpackages.com/badges/vdmi-guzzle-oauth/health.svg)](https://phpackages.com/packages/vdmi-guzzle-oauth) ``` ### Alternatives [hwi/oauth-bundle Support for authenticating users using both OAuth1.0a and OAuth2 in Symfony. 2.4k21.5M69](/packages/hwi-oauth-bundle)[and/oauth Simple and amazing OAuth library with many providers. Just try it out! 4645.2k2](/packages/and-oauth) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)