Erstellen und Ausführen eines CakePHP-Projekts

Was ist CakePHP?

CakePHP ist ein Open-Source-PHP-Web-Framework, das Entwicklern hilft, Webanwendungen schnell zu erstellen. Es basiert auf dem MVC (Model-View-Controller)-Architektur und bietet eine leistungsstarke Werkzeugpalette, die häufige Aufgaben wie Datenbankinteraktionen, Formularverarbeitung, Authentifizierung und Sitzungsverwaltung vereinfacht.

Hauptmerkmale und Vorteile von CakePHP

• Schnelle Entwicklung: Bietet eine Vielzahl von Code-Generierungstools, die Entwicklern helfen, häufig verwendete Code-Strukturen schnell zu erstellen.
• Flexibles und leistungsstarkes ORM: Das eingebaute ORM (Object-Relational Mapping) erleichtert Datenbankoperationen.
• Sicherheit: Bietet verschiedene Sicherheitsfunktionen wie Eingabevalidierung, CSRF-Schutz und SQL-Injection-Verhinderung.
• Community-Support: Hat eine aktive Community und ein reichhaltiges Plugin-Ökosystem.
• Gute Dokumentation: Bietet ausführliche Dokumentation und Tutorials, die Entwicklern helfen, schnell loszulegen.

CakePHP eignet sich für Projekte aller Größen, von kleinen Anwendungen bis hin zu großen Unternehmenssystemen, und hilft Entwicklern, qualitativ hochwertige Webanwendungen schnell zu erstellen.

Erstellen und Ausführen eines CakePHP-Projekts mit ServBay

In diesem Artikel verwenden wir die von ServBay bereitgestellte PHP-Umgebung, um ein CakePHP-Projekt zu erstellen und auszuführen. Wir nutzen die Host-Funktion von ServBay, um den Webserver einzurichten und das Projekt zugänglich zu machen.

Achtung: Wenn du zuvor NGINX oder Apache verwendet hast

ServBay verwendet standardmäßig Caddy als Webserver. Für Benutzer, die von NGINX und Apache zu ServBay wechseln, gibt es einige wichtige Änderungen zu beachten:

1. Caddy-Konfiguration

   ServBay enthält bereits eine optimierte und getestete Caddy-Konfiguration. Entwickler müssen die Caddy-Konfigurationsdatei nicht manuell ändern, sondern können die Host-Funktion von ServBay verwenden, um Websites zu verwalten.

2. Rewrite-Regeln und .htaccess

   In NGINX und Apache mussten Entwickler normalerweise eigene Rewrite-Regeln und .htaccess-Dateien schreiben, um URL-Umschreibungen und andere Konfigurationen zu verwalten. ServBay ist jedoch mit vorkonfigurierten Caddy-Regeln ausgestattet, sodass Entwickler diese Regeln nur bei speziellen Anforderungen selbst schreiben müssen.

3. Mehr erfahren

   Weitere Informationen findest du unter Rewrite und .htaccess, Migrating Apache Websites to ServBay und Migrating NGINX Websites to ServBay.

Erstellen eines CakePHP-Projekts

TIP

ServBay empfiehlt Entwicklern, Websites im Verzeichnis/Applications/ServBay/www zu platzieren, um die Verwaltung zu erleichtern.

1. Composer installieren

   ServBay enthält bereits Composer, sodass keine separate Installation erforderlich ist.

2. CakePHP-Projekt erstellen

   Ein neues CakePHP-Projekt mit Composer erstellen:

   cd /Applications/ServBay/www
   mkdir servbay-cakephp-app
   cd servbay-cakephp-app
   composer create-project --prefer-dist cakephp/app .

3. In das Projektverzeichnis wechseln

   In das neu erstellte CakePHP-Projektverzeichnis wechseln:

   cd /Applications/ServBay/www/servbay-cakephp-app

Initialkonfiguration

1. Umgebungsvariablen konfigurieren

   Die Datenbankverbindungsinformationen und andere Umgebungsvariablen in der config/app_local.php-Datei konfigurieren. Sicherstellen, dass die folgenden Konfigurationen korrekt eingestellt sind:

   'Datasources' => [
       'default' => [
           'host' => '127.0.0.1',
           'username' => 'root',
           'password' => 'password',
           'database' => 'servbay_cakephp_app',
           'url' => env('DATABASE_URL', null),
       ],
   ],

Webserver konfigurieren

Mit der Host-Funktion von ServBay auf das CakePHP-Projekt zugreifen. In den Host-Einstellungen von ServBay einen neuen Host hinzufügen:

• Name: My First CakePHP Dev Site
• Domain: servbay-cakephp-test.local
• Website-Typ: PHP
• PHP-Version: 8.3
• Stammverzeichnis der Website: /Applications/ServBay/www/servbay-cakephp-app/webroot

Detaillierte Anweisungen dazu findest du unter Add a New Website.

Beispielcode hinzufügen

In der config/routes.php-Datei den folgenden Code hinzufügen, um "Hello ServBay!" auszugeben:

$routes->connect('/', ['controller' => 'Pages', 'action' => 'display', 'home']);

In der src/Controller/PagesController.php-Datei den folgenden Code hinzufügen:

namespace App\Controller;

use Cake\Http\Response;

class PagesController extends AppController
{
    public function display()
    {
        return new Response(['body' => 'Hello ServBay!']);
    }
}

Website aufrufen

Öffne den Browser und rufe https://servbay-cakephp-test.local auf, um die Ausgabe Hello ServBay! zu sehen.

NoSQL-Datenbankbeispiele

Memcached-Beispiel

1. Memcached-Erweiterung installieren

   In ServBay ist die Memcached-Erweiterung bereits vorinstalliert, sodass keine zusätzliche Installation erforderlich ist.

2. Memcached konfigurieren

   In der config/app_local.php-Datei die Memcached-Verbindungsinformationen eintragen:

   'Cache' => [
       'default' => [
           'className' => 'Cake\Cache\Engine\MemcachedEngine',
           'servers' => ['127.0.0.1'],
       ],
   ],

3. Route konfigurieren

   In der config/routes.php-Datei den folgenden Code hinzufügen:

   $routes->connect('/memcached', ['controller' => 'Pages', 'action' => 'memcached']);

4. Memcached verwenden

   Im Controller Cache verwenden:

   use Cake\Cache\Cache;
   
   class PagesController extends AppController
   {
       public function memcached()
       {
           $cacheKey = 'my_cache_key';
           $cachedData = Cache::read($cacheKey);
   
           if (!$cachedData) {
               $cachedData = 'Hello Memcached!';
               Cache::write($cacheKey, $cachedData);
           }
   
           return new Response(['body' => $cachedData]);
       }
   }

   Öffne den Browser und rufe https://servbay-cakephp-test.local/memcached auf.

Redis-Beispiel

1. Redis-Erweiterung installieren

   In ServBay ist die Redis-Erweiterung bereits vorinstalliert, sodass keine zusätzliche Installation erforderlich ist.

2. Redis konfigurieren

   In der config/app_local.php-Datei die Redis-Verbindungsinformationen eintragen:

   'Cache' => [
       'default' => [
           'className' => 'Cake\Cache\Engine\RedisEngine',
           'server' => '127.0.0.1',
           'port' => 6379,
       ],
   ],

3. Route konfigurieren

   In der config/routes.php-Datei den folgenden Code hinzufügen:

   $routes->connect('/redis', ['controller' => 'Pages', 'action' => 'redis']);

4. Redis verwenden

   Im Controller Cache verwenden:

   use Cake\Cache\Cache;
   
   class PagesController extends AppController
   {
       public function redis()
       {
           $cacheKey = 'my_cache_key';
           $cachedData = Cache::read($cacheKey);
   
           if (!$cachedData) {
               $cachedData = 'Hello Redis!';
               Cache::write($cacheKey, $cachedData);
           }
   
           return new Response(['body' => $cachedData]);
       }
   }

   Öffne den Browser und rufe https://servbay-cakephp-test.local/redis auf.

Relationale Datenbankbeispiele

Datenbankstruktur und Migrationsdatei erstellen

1. Migrationsdatei erstellen

   Mit dem Bake-Tool von CakePHP eine Migrationsdatei erstellen:

   bin/cake bake migration CreateUsers name:string email:string:unique

2. Migration ausführen

   Mit dem CakePHP-Befehl die Migration ausführen, um die Datenbanktabelle zu erstellen:

   bin/cake migrations migrate

MySQL-Beispiel

1. MySQL konfigurieren

   In der config/app_local.php-Datei die MySQL-Verbindungsinformationen eintragen:

   'Datasources' => [
       'default' => [
           'host' => '127.0.0.1',
           'username' => 'root',
           'password' => 'password',
           'database' => 'servbay_cakephp_app',
           'url' => env('DATABASE_URL', null),
       ],
   ],

2. Route konfigurieren

   In der config/routes.php-Datei den folgenden Code hinzufügen:

   $routes->connect('/mysql-add', ['controller' => 'Pages', 'action' => 'mysqlAdd']);
   $routes->connect('/mysql', ['controller' => 'Pages', 'action' => 'mysql']);

3. User-Tabelle hinzufügen

   Den folgenden Code in der Datei src/Model/Table/UsersTable.php speichern:

   <?php
   namespace App\Model\Table;
   
   use Cake\ORM\Table;
   
   class UsersTable extends Table
   {
   }

4. Benutzerdaten schreiben

   Im Controller Benutzerdaten schreiben:

   use App\Model\Entity\User;
   use Cake\ORM\TableRegistry;
   
   class PagesController extends AppController
   {
       public function mysqlAdd()
       {
           $usersTable = TableRegistry::getTableLocator()->get('Users');
           $user = $usersTable->newEntity(['name' => 'ServBay', 'email' => '[email protected]']);
   
           if ($usersTable->save($user)) {
               return new Response(['body' => 'User added']);
           }
   
           return new Response(['body' => 'Failed to add user']);
       }
   
       public function mysql()
       {
           $usersTable = TableRegistry::getTableLocator()->get('Users');
           $users = $usersTable->find()->all();
   
           return new Response(['body' => json_encode($users)]);
       }
   }

   Öffne den Browser und rufe https://servbay-cakephp-test.local/mysql-add und https://servbay-cakephp-test.local/mysql auf.

PostgreSQL-Beispiel

1. PostgreSQL konfigurieren

   In der config/app_local.php-Datei die PostgreSQL-Verbindungsinformationen eintragen:

   'Datasources' => [
       'default' => [
           'host' => '127.0.0.1',
           'driver' => Postgres::Class,
           'username' => 'root',
           'password' => 'password',
           'database' => 'servbay_cakephp_app',
           'url' => env('DATABASE_URL', null),
       ],
   ],

2. Route konfigurieren

   In der config/routes.php-Datei den folgenden Code hinzufügen:

   $routes->connect('/pgsql-add', ['controller' => 'Pages', 'action' => 'pgsqlAdd']);
   $routes->connect('/pgsql', ['controller' => 'Pages', 'action' => 'pgsql']);

3. User-Tabelle hinzufügen

   Den folgenden Code in der Datei src/Model/Table/UsersTable.php speichern:

   <?php
   namespace App\Model\Table;
   
   use Cake\ORM\Table;
   
   class UsersTable extends Table
   {
   }

4. Benutzerdaten schreiben

   Im Controller Benutzerdaten schreiben:

   use App\Model\Entity\User;
   use Cake\ORM\TableRegistry;
   
   class PagesController extends AppController
   {
       public function pgsqlAdd()
       {
           $usersTable = TableRegistry::getTableLocator()->get('Users');
           $user = $usersTable->newEntity(['name' => 'ServBay', 'email' => '[email protected]']);
   
           if ($usersTable->save($user)) {
               return new Response(['body' => 'User added']);
           }
   
           return new Response(['body' => 'Failed to add user']);
       }
   
       public function pgsql()
       {
           $usersTable = TableRegistry::getTableLocator()->get('Users');
           $users = $usersTable->find()->all();
   
           return new Response(['body' => json_encode($users)]);
       }
   }

   Öffne den Browser und rufe https://servbay-cakephp-test.local/pgsql-add und https://servbay-cakephp-test.local/pgsql auf.

Durch die obigen Schritte hast du erfolgreich ein CakePHP-Projekt erstellt und ausgeführt sowie die von ServBay bereitgestellten Funktionen verwendet, um dein Projekt zu verwalten und zugänglich zu machen, während du gleichzeitig mehrere Datenbanken verbunden und Daten abgerufen hast.