Erstellen einer Mini-Blog-API mit Lithe and Eloquent

In diesem Tutorial erstellen wir eine Mini-Blog-API mit Lithe, einem PHP-Framework, das einfach und flexibel ist, und Eloquentes ORM, das die Interaktion mit der Datenbank erleichtert. Lithe konfiguriert Eloquent bereits automatisch, daher ist die Arbeit, die wir erledigen müssen, einfach: Passen Sie die Umgebungsvariablen an und erstellen Sie das Modell und die Migration für unsere Daten.

Befolgen wir eine einfache Schritt-für-Schritt-Anleitung, um diese API effizient und ohne Komplikationen zu erstellen.

Schritt 1: Lithe installieren

Der erste Schritt besteht darin, Lithe in Ihrem Projekt zu installieren. Wenn Sie dies 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 bereits 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 bereits 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 korrekt für unsere Mini-Blog!

Schritt 3: Vorlage erstellen und zu Beiträgen migrieren

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

Erstellen Sie zunächst die Beitragsvorlage mit dem Befehl:

php line make:model Post

Erstellen Sie dann die Migration für die Beitragstabelle:

php line make:migration create_posts_table

Das Modell und die Migration wurden bereits erstellt, jetzt konfigurieren wir sie.

Beitragsvorlage

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
{
    // A tabela associada ao modelo
    protected $table = 'posts';

    // Campos que podem ser preenchidos via mass-assignment
    protected $fillable = ['title', 'content'];

    // Usar timestamps para created_at e updated_at
    public $timestamps = true;
}

In diesem Code definieren wir die Titel- und Inhaltsfelder als ausfüllbar, was bedeutet, dass sie automatisch ausgefüllt werden können, wenn wir einen Beitrag erstellen oder aktualisieren.

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:

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

Hier erstellen wir die Beitragstabelle mit den Feldern ID, Titel, Inhalt und den Datums- und Uhrzeitfeldern „created_at“ und „update_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:

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

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

Schritt 5: Erstellen Sie den Controller für Beiträge

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

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

composer require illuminate/database

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

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

php line make:model Post

Hier haben wir fünf grundlegende Methoden:

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

Schritt 6: API-Routen definieren

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

php line make:migration create_posts_table

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

• Die Datei „cart.php“ geht an die Route /cart.
• Die Datei admin/dashboard.php geht an die Route /admin/dashboard.

Das $app->listen(); bewirkt, dass Lithe beginnt, auf Anfragen zu „lauschen“, das heißt, es wartet auf 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:

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Post extends Model
{
    // A tabela associada ao modelo
    protected $table = 'posts';

    // Campos que podem ser preenchidos via mass-assignment
    protected $fillable = ['title', 'content'];

    // Usar timestamps para created_at e updated_at
    public $timestamps = true;
}

Diese Routen verbinden PostController-Methoden mit 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 konfiguriert, und wir haben lediglich einige Änderungen 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!