Category: CakePHP

CakePHP 3: Kurzfassung zum Verwenden von Migrations

CakePHP bietet mit Migrations die Möglichkeit, Änderungen an der Datenbankstruktur einzuspielen oder rückgängig zu machen. Der typische Ablauf zur Migration ist folgender:

Generating migrations from an existing database

If you are dealing with a pre-existing database and want to start using migrations, or to version control the initial schema of your application’s database, you can run the migration_snapshot command:

bin/cake bake migration_snapshot Initial

Generating a diff between two database states

You can generate a migrations file that will group all the differences between two database states using the migration_diff bake template. To do so, you can use the following command:

bin/cake bake migration_diff NameOfTheMigrations

Applying Migrations

Once you have generated or written your migration file, you need to execute the following command to apply the changes to your database:

bin/cake migrations migrate

Migrations Status

The Status command prints a list of all migrations, along with their current status. You can use this command to determine which migrations have been run:

bin/cake migrations status

 

CakePHP 3: Benutzername oder Email zum Anmelden mit AuthComponent verwenden

In den Einstellungen der AuthComponent lässt sich festlegen, welches Feld der Datenbank für das Login verwendet werden soll. Hier kann allerdings nur ein einzelner Wert angegeben werden (bspw. username oder email). Um jedoch bei der Eingabe des Logins sowohl Benutzername, als auch Email zu erlauben, kann man die Einstellung zur Laufzeit (also beim Aufruf des Controllers) anpassen und das entsprechende Feld setzen. Und zwar wie folgt:

src/Controller/AppController.php

use Cake\Controller\Controller;

class AppController extends Controller
{
    public function initialize()
    {
        parent::initialize();
        $this->loadComponent('Flash');
        $this->loadComponent('Auth', [
            'authenticate' => [
                'Form' => [
                    'fields' => ['username' => 'username', 'password' => 'password'],
                ]
            ],
        ]);
    }
}

src/Controller/UsersController.php

use App\Controller\AppController;
use Cake\Validation\Validation;

class UsersController extends AppController
{
    public function login()
    {
        if ($this->request->is('post')) {

            if (Validation::email($this->request->getData('username'))) {
                $this->Auth->config('authenticate', [
                    'Form' => [
                        'fields' => ['username' => 'email']
                    ]
                ]);
                $this->Auth->constructAuthenticate();
                $this->request->data['email'] = $this->request->getData('username');
            }

            $user = $this->Auth->identify();

            if ($user) {
                $this->Auth->setUser($user);
                return $this->redirect($this->Auth->redirectUrl());
            }

            $this->Flash->error(__('Invalid combination of username/email and password.'));
        }
    }
}

src/Template/Users/login.ctp

<php
echo $this->Flash->render('auth');
echo $this->Form->create();

echo $this->Form->input('username');
echo $this->Form->input('password');

echo $this->Form->button(__('Login'));
echo $this->Form->end();
?>

 

CakePHP 2 Media Plugin: Media Dateien (Grafiken, …) mit verschiedenen Models nutzen

Unter http://grafikart.github.io/CakePHP-Media/index_en.html gibt es ein klasse CakePHP Plugin, mit dem sich Dateien verschiedenster Art (vorzüglich Grafiken, aber auch: png, jpg, pdf, mov, …) mit den Datensätzen anderer Models verknüpfen lassen. Im Video-Tutorial der Webseite wird ausführlichst beschrieben, wie dieses Plugin verwendet wird. Sehr zu empfehlen!

CakePHP 2: versenden von Emails (CakeEmail) debuggen

Möglichkeit 1: Debug-Einstellung setzen

Eine einfache Möglichkeit, um das Versenden von Emails in CakePHP 2.x zu testen, ist die Debug-Einstellung der Email Konfiguration. Dabei genügt das Setzen der Transport-Einstellung auf ‘Debug’ und schon wird der Inhalt der Email an der entsprechenden Stelle angezeigt:

<?php
// app/Config/email.php
class EmailConfig {
   public $default = array(
      'transport' => 'Debug',
      // ...

Dies funktioniert allerdings nur, wenn man sich die Ausgabe des aufgerufenen Scripts anzeigen lassen kann. Bei Cronjobs beispielsweise wird dies schon schwieriger.

CakePHP: Warum funktionieren Shells (bei gleichem Aufruf) nicht als Cronjob?

Shells lassen sich in CakePHP auch für den Aufruf aus Cronjobs verwenden. Dabei kann es jedoch vorkommen, dass der Aufruf einer Shell über das Terminal ohne Probleme funktioniert, aber im späteren Einsatz beim Aufruf über einen Cronjob nicht mehr so richtig will. Es hatte mich einiges an Zeit gekostet, herauszufinden warum dies passieren kann:

CakePHP: $virtualFields in $conditions einer Abfrage verwenden

Ein virtuelles Feld einer Datenbank, welches mit $virtualFields definiert wurde, ließ sich bis zur Version 1.3.0 von CakePHP nur zur Ausgabe verwenden. Ab Version 1.3.0 ist dies nun auch für Abfragen möglich (siehe Changelog).
Man sollte aber folgendes beachten: die Bedingungen in $conditions müssen als Array angegeben werden, ein String in $conditions funktioniert hier nicht!

CakePHP 1: das Versenden von Emails prüfen

Über die Email-Komponente von CakePHP lassen sich ziemlich komfortabel Emails versenden. Ob diese Emails dann auch ankommen kann man (im Entwicklerstatus) beispielsweise durch die Angabe der eigenen Email-Adresse als Empfänger realisieren, was allerdings nicht gerade vorteilhaft und manchmal auch etwas zeitintensiv ist. Angenehmer ist hier die eingebaute Debug-Möglichkeit der Email-Komponente.