<?php
/**
 * 
 * Authenticate against .ini style files.
 * 
 * Each group is a user handle, with keys for 'passwd', 'moniker', 'email',
 * and 'uri'.  For example ...
 * 
 *     [pmjones]
 *     passwd = plaintextpass
 *     email = hide@address.com
 *     moniker = Paul M. Jones
 *     uri = http://paul-m-jones.com/
 * 
 * @category Solar
 * 
 * @package Solar_Auth
 * 
 * @author Paul M. Jones <hide@address.com>
 * 
 * @license http://opensource.org/licenses/bsd-license.php BSD
 * 
 * @version $Id: Ini.php 4405 2010-02-18 04:27:25Z pmjones $
 * 
 */
class Solar_Auth_Adapter_Ini extends Solar_Auth_Adapter
{
    /**
     * 
     * Default configuration values.
     * 
     * @config string file Path to .ini file.
     * 
     * @var array
     * 
     */
    protected $_Solar_Auth_Adapter_Ini = array(
        'file' => null,
    );
    
    
    /**
     * 
     * Verifies a username handle and password.
     * 
     * @return mixed An array of verified user information, or boolean false
     * if verification failed.
     * 
     */
    protected function _processLogin()
    {
        // force the full, real path to the .ini file
        $file = realpath($this->_config['file']);
        
        // does the file exist?
        if (! file_exists($file) || ! is_readable($file)) {
            throw $this->_exception('ERR_FILE_NOT_READABLE', array(
                'file' => $file,
            ));
        }
        
        // parse the file into an array
        $data = parse_ini_file($file, true);
        
        // get user info for the handle
        $user = (! empty($data[$this->_handle])) ? $data[$this->_handle] : array();
        
        // there must be an entry for the username,
        // and the plain-text password must match.
        if (! empty($user['passwd']) && $user['passwd'] == $this->_passwd) {
            $user['handle'] = $this->_handle;
            return $user;
        } else {
            return false;
        }
    }
}