Download the PHP package lorenzoferrarajr/lfj-opauth without Composer

LfjOpauth

Created By Lorenzo Ferrara Junior

Introduction

LfjOpauth is a Zend Framework 2 module that enables support for many authentication providers through the Opauth framework.

Installation

To use the module you need to:

• Install the LfjOpauth module using using composer
• Install at least one of the Opauth strategies
• Enable the LfjOpauth module

To install the LfjOpauth module, you need to add "lorenzoferrarajr/lfj-opauth": "dev-master" to the require list of your project's composer.json file.

To install the Opauth strategy, you need find the required package on Packagist or on GitHub and add it to the require list of your project's composer.json file.

This is an example of a modified composer.json which includes the LfjOpauth module and the Facebook strategy:

The example includes the installation of the Facebook Opauth strategy. More info on Opauth strategies can be found on GitHub:

• opauth-facebook
• opauth-twitter
• more of them...

Installing LfjOpauth using composer, the Opauth dependecy is automatically resolved, but you still must provide at least one strategy.

Next, you need to add LfjOpauth to the modules list in the config/application.config.php file of your Zend Framework 2 project.

This is an example:

Configuration

Once LfjOpauth is installed you must create a file named lfjopauth.global.php in your config/autoload directory. This is the configuration file where you specify the LfjOpauth options.

An example of the lfjopauth.global.php file:

The configuration is pretty much the same as the Opauth configuration, without the path and callback_url options, which are handled by the module.

The check_controller_enabled flag enables or disables access to CheckController.

Alternatively, an option provider can be set using the Service Manager to replace the current configuration loader. To do that, you just have to :

• Register a service named lfjopauth_module_options,
• Implement the interface LfjOpauth\Provider\OptionsProviderInterface,
• And return a configuration array as above.

This can be usefull if you want to load your configuration from database or generate configuration for complexe cases.

Login and callback urls

Given the above configuration (and the corresponding Facebook applications), you will be able to login using:

• http://example.com/user/opauth/login/facebook
• http://example.com/user/opauth/login/second_facebook_app

and to logout using:

• http://example.com/user/opauth/logout

For the two demo Facebook application described in the example configuration, you should use

• http://example.com/user/login/facebook
• http://example.com/user/login/second_facebook_app

as value of the Website with Facebook Login, Site URL option.

Events

The LfjOpauth\Service\OpauthService triggers the LfjOpauth\LfjOpauthEvent::EVENT_LOGIN_CALLBACK event after the callback is processed. Be aware that the LfjOpauth\LfjOpauthEvent::EVENT_LOGIN_CALLBACK event is alwais triggered, even when the login process fails. Use the available event parameters to implement result checking.

The event contains three parameters:

• authenticationService: a Zend\Authentication\Result instance
• authenticationResult: a Zend\Authentication\AuthenticationService instance
• provider: is the provider used to try the login (example: facebook, google)

and its target is an instance of LfjOpauth\Service\OpauthService.

As en example on how to attach to the event, please refer to the following code.

Custom callback urls

If you need custom login and/or callback urls (for example containing more parameters), you can code custom routes and controller.

This is the code that defines the custom_lfjopauth_login and custom_lfjopauth_callback routes (custom-auth is the controller alias):

This is the code of the hypothetical controller that manages login and callback actions:

Checking login status

If the check_controller_enabled flag is enabled, you will be able to print current session info at this url:

• http://example.com/user/opauth/check

The default value of check_controller_enabled is false.

Other info

LfjOpauth uses Zend\Authentication\AuthenticationService (alias lfjopauth_auth_service) to manage authentication.

The LfjOpauth\Service\OpauthService (alias: opauth_service) class exposes the redirect and callback methods which can be used in any controller. An example can be found in the LfjOpauth\Controller\LoginController class.

LICENSE

The files in this archive are released under the MIT license. You can find a copy of this license in LICENSE.txt.