User_LoginController Klassenreferenz

Controller fuer die Anmeldung. Mehr ...

Klassendiagramm für User_LoginController:

Aufstellung aller Elemente

Öffentliche Methoden
	preDispatch ()
	Vor dem Dispatchen auszuführende Routinen.
	loginAction ()
	Zeigt Login-Seite an und prueft ggf.
	logoutAction ()
	Loggt den Benutzer aus und leitet auf Hauptseite um.
	passwordAction ()
	Generieren, Zusenden und ggf.

---

Ausführliche Beschreibung

Controller fuer die Anmeldung.

Die Klasse stellt die Moeglichkeit zur Verfuegung, sich beim System mit Benutzernamen und Passwort anzumelden.

Autor:

DSAo-Md

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

Version:

SVN: $Id: LoginController.php 512 2009-06-19 08:11:48Z saviola777 $ Controller für das Ein- und Ausloggen und das neu Generieren vergessener Passwörter.

Definiert in Zeile 17 der Datei LoginController.php.

---

Dokumentation der Elementfunktionen

User_LoginController::loginAction

(

)

Zeigt Login-Seite an und prueft ggf.

eingegebene Benutzerdaten.

Rückgabe:

bool

Definiert in Zeile 29 der Datei LoginController.php.

Benutzt Dsao_Controller_Action::_getModel(), Dsao_Controller_Action::_gotoSimple(), Dsao_Controller_Action::getLog(), Dsao_Controller_Action::getUri() und Dsao_Controller_Action::getView().

  {
    if ($this->getRequest()->isPost())
    {
      // Falls Benutzername leer, keine Fehlermeldung ausgeben.
      if (!$this->getRequest()->getPost('username'))
      {
        return false;
      }

      $username = $this->getRequest()->getPost('username');
      $password = $this->getRequest()->getPost('password');

      $validatorUsername = new Dsao_Validate_Username();
      $validatorPassword = new Dsao_Validate_Password();

      // Falls Benutzername und Passwort gueltig.
      if ($validatorUsername->isValid($username)
          && $validatorPassword->isValid($password))
      {
        // Benutzer anlegen.
        $user = new Dsao_User(array
          (
            'username' => $username,
            'password' => md5($password),
          ), false, true);

        // Falls Einloggen erfolgreich, auf vorherige Seite umleiten.
        if ($this->_getModel()->login($user, $this->getRequest()->getPost('autologin')))
        {
          $uriReturn = new Dsao_Uri_Http(str_replace('_', '/',
            $this->getUri()->getParameters('redirect', '_')));

          // Standardparameter setzen
          $uriReturn->setParameters(array(
            'action'      => 'show',
            'controller'  => 'index',
            'module'      => 'default'), false);

          // Weiterleiten
          $this->_gotoSimple($uriReturn->action, $uriReturn->controller,
            $uriReturn->module, $uriReturn->getParameters());

          return true;
        }
      }
      // Es wurden falsche Angaben gemacht.
      $this->getLog()->err('user_login_login_error_wrong_data');
    }

    // Link zum Umleiten zuweisen.
    $this->getView()->assign
      ('userLoginRedirect', $this->getUri()->redirect);

    return true;
  }

User_LoginController::logoutAction

(

)

Loggt den Benutzer aus und leitet auf Hauptseite um.

Rückgabe:

void

Definiert in Zeile 91 der Datei LoginController.php.

Benutzt Dsao_Controller_Action::_getModel(), Dsao_Controller_Action::_gotoSimple() und Dsao_Controller_Action::getHelper().

  {
    // Token
    if (!$this->getHelper('SessionToken')->hasValidToken())
    {
      return;
    }

    // Ausloggen
    $this->_getModel()->logout();

    // Auf Startseite umleiten
    $this->_gotoSimple('show', 'index', 'default');
  }

User_LoginController::passwordAction

(

)

Generieren, Zusenden und ggf.

Aktivieren eines neuen Passworts.

Die Methode gibt dem Benutzer die Moeglichkeit, sich ueber die Eingabe seines Benutzernames oder seiner E-Mail-Adresse ein neues Passwort zusenden zu lassen. Dies muss er dann jedoch durch den Aufruf eines Links bestaetigen, um den Missbrauch der Funktion zu verhindern.

Rückgabe:

bool

Definiert in Zeile 116 der Datei LoginController.php.

Benutzt Dsao_Controller_Action::_getModel(), Dsao_Hash_User::factory(), Dsao_Hash_Password::factory(), Dsao_Controller_Action::getHelper(), Dsao_Controller_Action::getLog() und Dsao_Controller_Action::getUri().

  {
    $this->getHelper('History')->setAddToHistory(true, false);

    // Falls Formular abgeschickt wurde
    if ($this->getRequest()->isPost())
    {
      // Falls weder Benutzername, noch E-Mail-Adresse angegeben wurden, abbrechen.
      if (!$this->getRequest()->getPost('username')
          && !$this->getRequest()->getPost('emailAddress'))
      {
        return false;
      }

      // Benutzerobjekt mit uebergebenen Daten erstellen.
      $user = new Dsao_User(array
        (
          'username'          => $this->getRequest()->getPost('username'),
          'emailAddress'     => $this->getRequest()->getPost('emailAddress'),
        ));

      // Falls kein gueltiger Benutzer gefunden werden konnte, abbrechen.
      if (!$user->isSynchronous(true))
      {
        // Fehlermeldung ausgeben.
        $this->getLog()->err('user_login_password_error_user_not_found');

        return false;
      }

      // neues Passwort erstellen
      $user->passwordNew = Dsao_Hash_Password::factory();

      // User-Hash erstellen
      $user->hash = Dsao_Hash_User::factory($user->passwordNew->getHash(),
        '/user/login/password', array('idUser'  => $user->getId()));

      // Hash in Tabelle einfügen
      $user->hash->insert();

      // Falls Verschicken der Mail mit neuem Passwort fehlschlug,
      // Fehlermeldung ausgeben.
      if (!$this->_getModel()->sendNewPasswordMail($user))
      {
        $this->getLog()->err('email_error_sent');

        return false;
      }

      // Bestaetigung anzeigen.
      $this->getLog()->affirm
        ('user_login_password_affirmation_email_sent');

      return true;
    }

    // Falls Parameter übergeben wurden
    // @todo Datenbankoperationen ins Modell auslagern
    if ($this->getUri()->hasParameters())
    {
      // User-Hash erstellen
      $hashUser = Dsao_Hash_User::factory(null, $this->getUri());

      // Falls Parameter ungültig sind, Fehlermeldung ausgeben
      if (!$hashUser->isValid())
      {
        $this->getLog()->err('user_login_password_error_invalid_link');

        return false;
      }

      // Benutzer erstellen.
      $user = new Dsao_User(array
        (
          'id'        => $hashUser->idUser,
          'password'  => $hashUser->hash,
        ));

      // Neues Passwort in der Datenbank setzen.
      $user->updateData('password');

      // Bestaetigung anzeigen.
      $this->getLog()->affirm
        ('user_login_password_affirmation_changed');

      return true;
    }

    // Hinweis fuer neues Passwort.
    $this->getLog()->info('user_login_password_info_new');

    return true;
  }

---

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

• /var/www/devel.dsao.eu/controllers/user/LoginController.php