PHPackages visualweber/social-oauth-zf2 - 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. [Authentication & Authorization](/categories/authentication) 4. / 5. visualweber/social-oauth-zf2 ActiveModule[Authentication & Authorization](/categories/authentication) visualweber/social-oauth-zf2 ============================ Great OAuth2 client for ZF2. It provides clients for github, google, facebook and linkedin, others are coming soon. 0156PHP Since Mar 16Pushed 8y ago1 watchersCompare [ Source](https://github.com/visualweber/social-oauth-zf2)[ Packagist](https://packagist.org/packages/visualweber/social-oauth-zf2)[ RSS](/packages/visualweber-social-oauth-zf2/feed)WikiDiscussions master Synced 4w ago READMEChangelogDependenciesVersions (1)Used By (0) SocialOAuth =========== [](#socialoauth) Great OAuth2 client for ZF2. It provides clients for github, google, facebook and linkedin, others are coming soon. The library is kept as simple as possible, it does not provide routes or controllers. Installation with Composer -------------------------- [](#installation-with-composer) 1. Add this project in your `composer.json`: ``` "require": { "visualweber/social-oauth-zf2": "dev-master", } ``` 2. Fetch the repository with composer: ``` $ php composer.phar update ``` 3. Enable it in your `config/application.config.php` file: ``` return array( 'modules' => array( // ... 'SocialOAuth', ), // ... ); ``` Usage ----- [](#usage) As usual add it to your application.config.php 'SocialOAuth'. Copy & rename the `config/socialoauth.local.php.dist` to your autoload folder and fill the information needed. ### In your controller/action do: [](#in-your-controlleraction-do) ``` public function callbackAction() { $me = $this->getServiceLocator()->get('SocialOAuth\Google'); //$me = $this->getServiceLocator()->get('SocialOAuth\Github'); //$me = $this->getServiceLocator()->get('SocialOAuth\Facebook'); //$me = $this->getServiceLocator()->get('SocialOAuth\LinkedIn'); if (strlen($this->params()->fromQuery('code')) > 10) { if($me->getToken($this->request)) { $token = $me->getSessionToken(); // token in session } else { $token = $me->getError(); // last returned error (array) } $info = $me->getInfo(); } else { $url = $me->getUrl(); } return array('token' => $token, 'info' => $info, 'url' => $url); } ``` The action name depends on your settings. getUrl() will return the url where you should redirect the user, there is no automatic redirection do it yourself. ### Client Configuration [](#client-configuration) Beside the configuration options in `module.config.php` and `reverseoath2.local.php` you can change the client configuration on runtime. ``` public function callbackAction() { $me = $this->getServiceLocator()->get('SocialOAuth\Google'); //$me = $this->getServiceLocator()->get('SocialOAuth\Github'); //$me = $this->getServiceLocator()->get('SocialOAuth\Facebook'); //$me = $this->getServiceLocator()->get('SocialOAuth\LinkedIn'); $me->getOptions()->setScope(array('email', 'user')); $me->getOptions()->setAuthUri('http://google.com/'); $me->getOptions()->setTokenUri('http://google.com/'); $me->getOptions()->setInfoUri('http://google.com/'); $me->getOptions()->setClientId('my-id.com'); $me->getOptions()->setClientSecret('my-secret'); $me->getOptions()->setRedirectUri('http://my-server.com/'); } ``` ### The SocialOAuth authentication adapter [](#the-socialoauth-authentication-adapter) The module provides also an zend\\authentication\\adapter. ``` public function authGithubAction() // controller action { $me = $this->getServiceLocator()->get('SocialOAuth\Github'); $auth = new AuthenticationService(); // zend if (strlen($this->params()->fromQuery('code')) > 10) { if($me->getToken($this->request)) { // if getToken is true, the user has authenticated successfully by the provider, not yet by us. $token = $me->getSessionToken(); // token in session } else { $token = $me->getError(); // last returned error (array) } $adapter = $this->getServiceLocator()->get('SocialOAuth\Auth\Adapter'); // added in module.config.php $adapter->setOAuth2Client($me); // $me is the oauth2 client $rs = $auth->authenticate($adapter); // provides an eventManager 'oauth2.success' if (!$rs->isValid()) { foreach ($rs->getMessages() as $message) { echo "$message\n"; } echo 'no valid'; } else { echo 'valid'; } } else { $url = $me->getUrl(); } $view = new ViewModel(array('token' => $token, 'info' => $info, 'url' => $url, 'error' => $me->getError())); return $view; } ``` The adapter also provides an event called `oauth2.success`. Here you can check the data from the client against your user registry. You will be provided with information from the user, token info and provider type. In your module class you could do: ``` public function onBootstrap(Event $e) { /* Some bad code here, only for demo purposes. */ $userTable = new UserTable($e->getApplication()->getServiceManager()->get('Zend\Db\Adapter\Adapter')); // my user table $e->getApplication()->getServiceManager()->get('SocialOAuth\Auth\Adapter')->getEventManager() // the the adapters eventmanager ->attach('oauth2.success', //attach to the event function($e) use ($userTable){ $params = $e->getParams(); //print_r($params); so you see whats in if if($user = $userTable->getUserByRemote($params['provider'], $params['info']['id'])) { // check for user from facebook with id 1000 $user->token = $params['token']['access_token']; $expire = (isset($params['token']['expires'])) ? $params['token']['expires'] : 3600; $user->token_valid = new \Zend\Db\Sql\Expression('DATE_ADD(NOW(), INTERVAL '.$expire.' SECOND)'); $user->date_update = new \Zend\Db\Sql\Expression('NOW()'); $userTable->saveUser($user); } else { $user = new User; $user->token = $params['token']['access_token']; $expire = (isset($params['token']['expires'])) ? $params['token']['expires'] : 3600; $user->token_valid = new \Zend\Db\Sql\Expression('DATE_ADD(NOW(), INTERVAL '.$expire.' SECOND)'); $user->date_update = new \Zend\Db\Sql\Expression('NOW()'); $user->date_create = new \Zend\Db\Sql\Expression('NOW()'); $user->remote_source = $params['provider']; $user->remote_id = $params['info']['id']; $user->name = $params['info']['name']; $user->info = \Zend\Json\Encoder::encode($params['info']); $userTable->saveUser($user); } $user = $userTable->getUserByRemote($params['provider'], $params['info']['id']); $params['info'] = $user->getArrayCopy(); $params['info']['info'] = false; // here the params info is rewitten. The result object returned from the auth object will have the db row. $params['code'] = \Zend\Authentication\Result::FAILURE; // this would deny authentication. default is \Zend\Authentication\Result::SUCCESS. }); } ``` TODO ---- [](#todo) - Add other clients - Write some decent documentation. - Demo module is on it's way. ### Health Score 22 — LowBetter than 21% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity10 Limited adoption so far Community9 Small or concentrated contributor base Maturity41 Maturing project, gaining track record Bus Factor1 Top contributor holds 63.6% 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. ### Community Maintainers ![](https://www.gravatar.com/avatar/c6f3de3d3992647065c443eca835cac3f63e4a257e003367129e216638b98ef2?d=identicon)[vswb](/maintainers/vswb) --- Top Contributors [![vswb](https://avatars.githubusercontent.com/u/12278864?v=4)](https://github.com/vswb "vswb (7 commits)")[![bainguyen](https://avatars.githubusercontent.com/u/10115518?v=4)](https://github.com/bainguyen "bainguyen (4 commits)") ### Embed Badge ![Health badge](/badges/visualweber-social-oauth-zf2/health.svg) ``` [![Health](https://phpackages.com/badges/visualweber-social-oauth-zf2/health.svg)](https://phpackages.com/packages/visualweber-social-oauth-zf2) ``` ### Alternatives [kartik-v/yii2-password Useful password strength validation utilities for Yii Framework 2.0 761.2M17](/packages/kartik-v-yii2-password) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)