https://github.com/ojhaujjwal/auth

A Zend framework module based on ZfcUser to check if user is logged in and to manage session, session save handler etc.
https://github.com/ojhaujjwal/auth

Last synced: 17 days ago
JSON representation

A Zend framework module based on ZfcUser to check if user is logged in and to manage session, session save handler etc.

• Host: GitHub
• URL: https://github.com/ojhaujjwal/auth
• Owner: ojhaujjwal
• License: gpl-2.0
• Created: 2013-11-21T15:03:46.000Z (almost 11 years ago)
• Default Branch: master
• Last Pushed: 2014-05-26T06:40:50.000Z (over 10 years ago)
• Last Synced: 2024-04-21T05:23:05.596Z (7 months ago)
• Language: PHP
• Size: 176 KB
• Stars: 2
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
auth

====

A Zend framework module based on ZfcUser to check if user is logged in and to manage session, session save handler etc.

## Note

This module is currently unmaintained. Please use [HtSession](https://github.com/hrevert/HtSession) instead.

##Requirements

* Zend Framework 2

* ZfcUser

* ZfcBase

##Installation

* Add `"ujjwal/auth": "1.0.*",` to your composer.json and run `php composer.phar update`

* Enable the module in `config/application.config.php`

* Copy file located in `./vendor/ujjwal/auth/config/Auth.local.php` to `./config/autoload/Auth.local.php` and change the values as you wish

##Options

Check Options available in `config/Auth.local.php` 

 

##Features

* Modules and Controllers Access

* Session configurations

* Session set save handler

* Session Validators

####Modules and Controllers Access

With this module you can restrict unauthorized users from accessing certain controllers and modules. This can be done easily from module options. To do so, edit the `Auth.local.php`


$auth_settings = array(


    /**

     * Log In Modules

     *

     * Please set modules where logged in user can only gain access

     */

    'modules' => array(

            'Admin',

            'Application',    

    ),

    /**

     * Controllers where you can set if user can access or not

     *

     * 'controllers' => array(

        'include' => array(), // Please set controllers where logged in user can only gain access

        'exclude' => array(), // Please set controllers where public user as well as logged in user can gain access

        // Note that, this part will override above `include` and `modules`

     ),

    */

);



#### Session configurations

You can set all the session options as session name, save path, save handler etc.

To do so, edit the `Auth.local.php` as follows:


$session_settings = array(

    /**

     * Session Config Class

     *

     * Name of class used to manage session config options. Useful to create your own

     * Session Config Class.  Default is Zend\Session\Config\SessionConfig.

     * The class should implement Zend\Session\Config\ConfigInterface.

     */

    //'config_class' => 'Zend\Session\Config\SessionConfig',


    /**

     * Session Config Options

     *

     * session options such as name, save_path can be set from here

     * This is the part sent to Session Config Class. Default is empty array.

     */

    'config_options' => array(

            'name' => 'my_application',

            'save_path' => 'data/session'

    ),

);



#### Session set save handler

This module also comes with session set save handler to store session data in database.

By default session_set_save_hander is already enabled. If you want to disable it, disable it in the following settings:


$session_settings = array(

    /**

     * Use session save handler or not.

     * 

     * Default is true. Useful to store session data in database

     * see http://php.net/manual/en/function.session-set-save-handler.php

     * Accept values: true and false

     */

    //'save_handler_or_not' => true,


    /**

     * Session Save Handler DI Alias

     *

     * Please specify the DI alias for the configured AuthSessionSaveHandler

     * instance that this module should use.

     * Default is AuthSessionSaveHandler which is provided by this module.

     * This class should implement Zend\Session\SaveHandler\SaveHandlerInterface

     * Note that, if above is false, this will be useless

     */

    //'saveHandler' => 'AuthSessionSaveHandler'

);



`Note`: Dont forget to import schema available in `data/mysql.sql` to use `session_set_save_handler`

#### Session Validators

You can set validators provided by Zend Framework 2 with ease.

Change the following as you wish in the config file:


$session_settings = array(

    /**

     * Session Validators

     *

     * Session validators provide various protection against session hijacking.

     * see http://framework.zend.com/manual/2.2/en/modules/zend.session.validator.html for more details

     */

    'validators' => array(

            'Zend\Session\Validator\RemoteAddr',

            'Zend\Session\Validator\HttpUserAgent',    

    ),

);



## Ending Thoughts

Dont forget to fork this module and send me pull request to make this module even better!