Dsao_Model_User_Login Klassenreferenz

Model-Klasse fuer Login-Controller. Mehr ...

Klassendiagramm für Dsao_Model_User_Login:

Aufstellung aller Elemente

Öffentliche Methoden
	cookieLogin ()
	Versucht, den Benutzer mit den übergebenen Cookie-Daten einzuloggen.
	login (Dsao_User $user, $autologin=false)
	Authentifiziert Benutzer durch uebergebenen Benutzernamen und Passwort.
	logout ()
	Loescht Sessiondaten und -cookie.
	sendNewPasswordMail (Dsao_User $user)
	Versendet Mail mit neuem Passwort.
Geschützte Methoden
	_cookieRegenerate ()
	Regneriert den Hash des Autologin-Cookies oder erstellt einen neuen.
	_init ()
	Initialisiert Auth-Objekt.
	_writeUserToSession ()
	Lädt Benutzerdaten neu und schreibt den Benutzer dann in die Session.
Geschützte Attribute
	$_auth = null
	Zend_Auth, Auth-Objekt.
	$_user = null
	stdClass, Sessiondaten

---

Ausführliche Beschreibung

Model-Klasse fuer Login-Controller.

Die Klasse enthaelt Methoden, um dem Login-Controller die noetige Funktionalitaet zur Verfuegung zu stellen.

Autor:

DSAo-Md

http://www.gnu.org/licenses/gpl-3.0.html GNU Public License

Version:

SVN: $Id: Login.php 512 2009-06-19 08:11:48Z saviola777 $

Definiert in Zeile 12 der Datei Login.php.

---

Dokumentation der Elementfunktionen

Dsao_Model_User_Login::_cookieRegenerate

(

)

[protected]

Regneriert den Hash des Autologin-Cookies oder erstellt einen neuen.

Rückgabe:

void

Definiert in Zeile 29 der Datei Login.php.

Benutzt Dsao_Hash_User::factory().

Wird benutzt von cookieLogin() und login().

  {
    // Hash erstellen und Duplikate löschen
    $hashAutologin = Dsao_Hash_User::factory(null, '/user/login/autologin',
      array('idUser' => $this->_user->getId()))->insert()->deleteDuplicates();

    // Cookie erstellen, in den ein relativer URI geschrieben wird
    setrawcookie('autologin',
      $hashAutologin->getUri()->getUriString(),
      time()+(60*60*24*30), // einen Monat gueltig
      '/', // Gueltig auf dem ganzen Server
      $_SERVER['SERVER_NAME'], // Gueltig fuer alle Subdomains
      false, // Auch ohne https uebertragen
      true); // Nur ueber HTTP auslesbar (nicht ueber JS o.ae.)
  }

Dsao_Model_User_Login::_init

(

)

[protected]

Initialisiert Auth-Objekt.

Rückgabe:

void

Erneute Implementation von Dsao_Model_Abstract.

Definiert in Zeile 50 der Datei Login.php.

  {
    $this->_auth = Zend_Auth::getInstance();
  }

Dsao_Model_User_Login::_writeUserToSession

(

)

[protected]

Lädt Benutzerdaten neu und schreibt den Benutzer dann in die Session.

Rückgabe:

void

Definiert in Zeile 60 der Datei Login.php.

Wird benutzt von cookieLogin() und login().

  {
    // Benutzerdaten laden
    $this->_user->refresh();

    // Benutzer als gültig und schreibgeschützt markieren
    $this->_user->setValid()->setReadOnly();

    // Sessiondaten speichern
    $this->_auth->getStorage()->write(serialize($this->_user));

    // Session Fixierung
    $defaultNamespace = new Zend_Session_Namespace();

    // Falls Session noch nicht initialisiert
    if (!isset($defaultNamespace->initialized))
    {
        Zend_Session::regenerateId();
        $defaultNamespace->initialized = true;
    }
  }

Dsao_Model_User_Login::cookieLogin

(

)

Versucht, den Benutzer mit den übergebenen Cookie-Daten einzuloggen.

Rückgabe:

bool, ob Einloggen erfolgreich war

Definiert in Zeile 87 der Datei Login.php.

Benutzt _cookieRegenerate(), _writeUserToSession() und Dsao_Hash_User::factory().

  {
    // Falls kein Cookie vorhanden
    if (!isset($_COOKIE['autologin']))
    {
      return false;
    }

    // Hash aus Cookie erstellen
    $hashAutologin = Dsao_Hash_User::factory(null, $_COOKIE['autologin']);

    // Falls Cookie gültig ist
    if ($hashAutologin->isValid())
    {
      $this->_user = new Dsao_User(array('id' => $hashAutologin->idUser));

      $this->_writeUserToSession();

      $this->_cookieRegenerate();

      return true;
    }

    return false;
  }

Dsao_Model_User_Login::login	(	Dsao_User $	user,
		$	autologin = false
	)

Authentifiziert Benutzer durch uebergebenen Benutzernamen und Passwort.

Parameter:

	$user	Dsao_User, Benutzer
	$autologin	bool, ob Autologin-Cookie gesetzt werden soll

Rückgabe:

bool, ob Login erfolgreich war

Definiert in Zeile 120 der Datei Login.php.

Benutzt _cookieRegenerate() und _writeUserToSession().

  {
    // Auth-Adapter für die DB vorbereiten
    $authAdapter = new Zend_Auth_Adapter_DbTable(Zend_Registry::get('db'));
    $authAdapter->setTableName('user_data')
                ->setIdentityColumn('username')
                ->setCredentialColumn('password')
                ->setIdentity($user->username)
                ->setCredential($user->password);

    // Zend_Auth_Result, Resultat der Authentifizierung
    $result = $this->_auth->authenticate($authAdapter);

    // Falls Authentifizierung erfolgreich
    if ($result->isValid())
    {
      // Benutzer-ID auslesen und Benutzerobjekt erstellen
      $this->_user = new Dsao_User(array(
        'id' => $authAdapter->getResultRowObject('id')->id));

      $this->_writeUserToSession();

      // Falls Autologin-Cookie gesetzt werden soll
      if ($autologin)
      {
        $this->_cookieRegenerate();
      }

      return true;
    }

    return false;
  }

Dsao_Model_User_Login::logout

(

)

Loescht Sessiondaten und -cookie.

Rückgabe:

void

Definiert in Zeile 159 der Datei Login.php.

  {
    // Autologin Cookie zuruecksetzen
    if (isset($_COOKIE['autologin']))
    {
      setrawcookie('autologin',
        '', // leerer Inhalt
        time()-3600, // Ist schon abgelaufen -> Browser soll Cookie loeschen
        '/',
        '.'.$_SERVER['SERVER_NAME'],
        false,
        true);
    }

    // Benutzerdaten aus Session loeschen
    Zend_Auth::getInstance()->clearIdentity();

    // Session komplett loeschen
    Zend_Session::destroy(true);
  }

Dsao_Model_User_Login::sendNewPasswordMail

(

Dsao_User $

user

)

Versendet Mail mit neuem Passwort.

Parameter:

$user

Dsao_User, Objekt mit Benutzerdaten

Rückgabe:

bool, ob Verschicken der Mail erfolgreich war

Definiert in Zeile 186 der Datei Login.php.

Benutzt Dsao_View_Smarty::sprintf().

  {
    // E-Mail vorbereiten
    $content = Dsao_View_Smarty::sprintf
      ('user_login_password_email_content',
      array
        (
          'password'      => $user->passwordNew->getPassword(),
          'uri'           => $user->hash->getUri()
            ->getUriString(true, false, true),
        ));

    // string, Betreff
    $subject  = Zend_Registry::get('translate')->
                  _('user_login_password_email_subject');

    $mail = new Dsao_Mail($user, $subject, $content);

    // E-Mail versenden
    return $mail->send();
  }

---

Die Dokumentation für diese Klasse wurde erzeugt aufgrund der Datei:

• /var/www/devel.dsao.eu/library/Dsao/Model/User/Login.php