Erstellen einer Mini-Blog-API mit Lithe and Eloquent

Schritt 1: Lithe installieren

Der erste Schritt besteht darin, Lithe in Ihrem Projekt zu installieren. Wenn Sie das noch nicht getan haben, führen Sie einfach den folgenden Befehl im Terminal aus:

composer create-project lithephp/lithephp mini-blog-api

Dieser Befehl erstellt ein neues Projekt mit Lithe. Lithe konfiguriert Eloquent automatisch für Sie, wir müssen jedoch einige Einstellungen in der .env-Datei anpassen, um eine Verbindung zur Datenbank herzustellen.

---

Schritt 2: Konfigurieren Sie die Datenbank

Jetzt konfigurieren wir die Datenbank. Öffnen Sie die .env-Datei im Stammverzeichnis Ihres Projekts und bearbeiten Sie die Datenbankeinstellungen. Um Eloquent ORM mit MySQL zu verwenden, sollten die Einstellungen wie folgt aussehen:

DB_CONNECTION_METHOD=eloquent
DB_CONNECTION=mysql
DB_HOST=localhost
DB_NAME=lithe_eloquent
DB_USERNAME=root
DB_PASSWORD=
DB_SHOULD_INITIATE=true

Da Lithe Eloquent automatisch konfiguriert, besteht der nächste Schritt darin, sicherzustellen, dass Eloquent ORM installiert ist. Wenn Sie dies noch nicht getan haben, führen Sie den folgenden Befehl aus, um Eloquent ORM zu installieren:

composer require illuminate/database

Nach der Installation ist Lithe bereit, Eloquent ORM zu verwenden und mit der Datenbank zu interagieren. Damit ist die Datenbank nun korrekt für unsere Mini Blog API konfiguriert!

---

Schritt 3: Erstellen Sie das Modell und die Migration für Beiträge

Jetzt erstellen wir das Modell und die Migration, um die Tabelle Beiträge in unserer Datenbank zu definieren.

Erstellen Sie zunächst das Post-Modell mit dem folgenden Befehl:

php line make:model Post

Als nächstes erstellen Sie die Migration für die Beitragstabelle:

php line make:migration create_posts_table

Das Modell und die Migration sind nun erstellt. Lassen Sie uns sie konfigurieren.

Beitragsmodell

Das Post-Modell befindet sich in src/models/Post.php. Bearbeiten Sie die Datei wie folgt:

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Post extends Model
{
    // The table associated with the model
    protected $table = 'posts';

    // Fields that can be filled via mass-assignment
    protected $fillable = ['title', 'content'];

    // Use timestamps for created_at and updated_at
    public $timestamps = true;
}

In diesem Code definieren wir die Titel- und Inhaltsfelder als ausfüllbar, was bedeutet, dass sie beim Erstellen oder Aktualisieren eines Beitrags automatisch ausgefüllt werden können.

Beitragstabellenmigration

Die generierte Migration befindet sich in src/database/migrations/{timestamp}_create_posts_table.php. Bearbeiten Sie die Migration, um die Struktur der Beitragstabelle zu erstellen:

use Illuminate\Database\Schema\Blueprint;
use Illuminate\Database\Capsule\Manager as Capsule;

return new class
{
    public function up(): void
    {
         Capsule::schema()->create('posts', function (Blueprint $table) {
            $table->id(); // Creates the auto-incrementing id field
            $table->string('title'); // Creates the title field
            $table->text('content'); // Creates the content field
            $table->timestamps(); // Creates created_at and updated_at fields
        });
    }

    public function down(): void
    {
         Capsule::schema()->dropIfExists('posts');
    }
};

Hier erstellen wir die Beitragstabelle mit den Feldern ID, Titel, Inhalt und den Datums-/Uhrzeitfeldern „erstellt_at“ und „aktualisiert_at“.

---

Schritt 4: Führen Sie die Migration aus

Wenn die Migration und das Modell bereit sind, führen wir die Migration aus, um die Beitragstabelle in der Datenbank zu erstellen. Führen Sie den folgenden Befehl aus:

php line migrate

Dieser Befehl erstellt die Beitragstabelle in der Datenbank mit den Feldern, die wir bei der Migration definiert haben.

---

Schritt 5: Erstellen Sie den Post-Controller

Jetzt erstellen wir einen Controller, um die Beiträge der API zu verwalten. Der Verantwortliche ist für die Bearbeitung von HTTP-Anfragen und die organisierte Rückgabe der Daten verantwortlich.

Um den Controller zu erstellen, führen Sie Folgendes aus:

composer create-project lithephp/lithephp mini-blog-api

Dadurch wird eine Datei in src/http/Controllers/PostController.php generiert. Bearbeiten Sie diese Datei, um die CRUD-Methoden (Erstellen, Lesen, Aktualisieren und Löschen) für die Beiträge einzuschließen.

Hier ist ein Beispiel, wie der PostController aussehen könnte:

DB_CONNECTION_METHOD=eloquent
DB_CONNECTION=mysql
DB_HOST=localhost
DB_NAME=lithe_eloquent
DB_USERNAME=root
DB_PASSWORD=
DB_SHOULD_INITIATE=true

Hier haben wir fünf grundlegende Methoden:

• index: Listet alle Beiträge auf.
• show: Zeigt einen bestimmten Beitrag an.
• Store: Erstellt einen neuen Beitrag.
• update: Aktualisiert einen vorhandenen Beitrag.
• zerstören: Löscht einen Beitrag.

---

Schritt 6: Definieren Sie die API-Routen

Jetzt definieren wir die Routen für unsere Post-API. Öffnen Sie die Datei src/App.php und fügen Sie den folgenden Code hinzu:

composer require illuminate/database

Der obige Code erstellt eine Instanz der Lithe-App. Die Zeile $app->set('routes', __DIR__ . '/routes'); teilt Lithe mit, wo die Routendateien zu finden sind. Lithe lädt automatisch alle Dateien im Ordner src/routes. Jede Routendatei wird anhand ihres Namens der URL zugeordnet. Zum Beispiel:

• Die Datei cart.php wird zur /cart-Route weitergeleitet.
• Die Datei admin/dashboard.php wird zur Route /admin/dashboard verschoben.

Die Zeile $app->listen(); lässt Lithe auf Anfragen „lauschen“, d. h. es wartet auf eingehende Anfragen und leitet sie an die definierten Routen weiter.

Erstellen Sie nun eine Datei namens posts.php im Ordner src/routes/posts, um die Route /posts darzustellen, und fügen Sie den folgenden Code hinzu:

php line make:model Post

Diese Routen verbinden die Methoden in PostController mit den API-URLs.

---

Schritt 7: Testen Sie die API

Da nun alles eingerichtet ist, können Sie Ihre API mit Tools wie Postman oder Insomnia testen. Hier sind die Endpunkte, die Sie testen können:

• GET /posts: Gibt alle Beiträge zurück.
• GET /posts/:id: Gibt einen bestimmten Beitrag zurück.
• POST /posts: Erstellt einen neuen Beitrag.
• PUT /posts/:id: Aktualisiert einen vorhandenen Beitrag.
• DELETE /posts/:id: Löscht einen Beitrag.

---

Jetzt haben Sie gerade eine Mini-Blog-API mit Lithe und Eloquent ORM erstellt! Lithe hat Eloquent automatisch für Sie eingerichtet und wir haben lediglich ein paar Anpassungen an den Umgebungsvariablen vorgenommen und die erforderlichen Modelle und Controller erstellt. Jetzt verfügen Sie über eine vollständige RESTful-API zum Verwalten von Blogbeiträgen.

Weitere Informationen und Details zur Verwendung von Lithe und Eloquent ORM finden Sie in der offiziellen Lithe-Dokumentation hier: Lithe-Dokumentation.

Das obige ist der detaillierte Inhalt vonErstellen einer Mini-Blog-API mit Lithe and Eloquent. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!