Mencipta API Blog Mini dengan Lithe dan Fasih

Langkah 1: Pasang Lithe

Langkah pertama ialah memasang Lithe dalam projek anda. Jika anda belum melakukannya lagi, hanya jalankan arahan berikut dalam terminal:

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

Arahan ini mencipta projek baharu menggunakan Lithe. Lithe secara automatik mengkonfigurasi Eloquent untuk anda, tetapi kami perlu melaraskan beberapa tetapan dalam fail .env untuk menyambung ke pangkalan data.

---

Langkah 2: Konfigurasi Pangkalan Data

Sekarang, mari konfigurasikan pangkalan data. Buka fail .env pada akar projek anda dan edit tetapan pangkalan data. Untuk menggunakan Eloquent ORM dengan MySQL, tetapan sepatutnya kelihatan seperti ini:

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

Memandangkan Lithe secara automatik mengkonfigurasi Eloquent, langkah seterusnya ialah memastikan Eloquent ORM dipasang. Jika anda belum berbuat demikian, jalankan arahan berikut untuk memasang Eloquent ORM:

composer require illuminate/database

Selepas pemasangan, Lithe akan sedia untuk menggunakan Eloquent ORM dan berinteraksi dengan pangkalan data. Dengan itu, pangkalan data kini dikonfigurasikan dengan betul untuk API Mini Blog kami!

---

Langkah 3: Cipta Model dan Migrasi untuk Siaran

Sekarang, mari buat model dan migrasi untuk menentukan jadual siaran dalam pangkalan data kami.

Mula-mula, cipta model Post dengan arahan berikut:

php line make:model Post

Seterusnya, buat migrasi untuk jadual siaran:

php line make:migration create_posts_table

Model dan migrasi kini dicipta. Mari konfigurasikannya.

Model Pos

Model Post terletak di src/models/Post.php. Edit fail seperti ini:

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;
}

Dalam kod ini, kami mentakrifkan medan tajuk dan kandungan sebagai boleh diisi, bermakna ia boleh diisi secara automatik apabila membuat atau mengemas kini siaran.

Penghijrahan Jadual Catatan

Penghijrahan yang dijana akan ditempatkan dalam src/database/migrations/{timestamp}_create_posts_table.php. Edit migrasi untuk mencipta struktur jadual siaran:

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');
    }
};

Di sini, kami sedang mencipta jadual siaran dengan id medan, tajuk, kandungan dan medan tarikh-masa yang dibuat_pada dan dikemas kini_pada.

---

Langkah 4: Jalankan Migrasi

Dengan migrasi dan model sedia, mari jalankan migrasi untuk mencipta jadual siaran dalam pangkalan data. Jalankan arahan berikut:

php line migrate

Arahan ini akan mencipta jadual siaran dalam pangkalan data dengan medan yang kami takrifkan dalam penghijrahan.

---

Langkah 5: Buat Pengawal Pos

Sekarang, mari buat pengawal untuk mengurus siaran API. Pengawal akan bertanggungjawab untuk mengendalikan permintaan HTTP dan mengembalikan data dengan cara yang teratur.

Untuk mencipta pengawal, laksanakan:

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

Ini akan menjana fail dalam src/http/Controllers/PostController.php. Edit fail ini untuk memasukkan kaedah CRUD (buat, baca, kemas kini dan padam) untuk siaran.

Berikut ialah contoh bagaimana PostController mungkin kelihatan:

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

Di sini, kami mempunyai lima kaedah asas:

• indeks: Menyenaraikan semua siaran.
• tunjukkan: Memaparkan siaran tertentu.
• kedai: Mencipta siaran baharu.
• kemas kini: Mengemas kini siaran sedia ada.
• musnahkan: Memadamkan siaran.

---

Langkah 6: Tentukan Laluan API

Sekarang, mari kita tentukan laluan untuk API pos kami. Buka fail src/App.php dan tambah kod berikut:

composer require illuminate/database

Kod di atas mencipta contoh apl Lithe. Baris $app->set('routes', __DIR__ . '/routes'); memberitahu Lithe tempat untuk mencari fail laluan. Lithe akan memuatkan semua fail secara automatik di dalam folder src/routes. Setiap fail laluan akan dipetakan ke URL berdasarkan namanya. Contohnya:

• Fail cart.php akan pergi ke laluan /cart.
• Fail admin/dashboard.php akan pergi ke laluan /admin/dashboard.

Barisan $app->listen(); menjadikan Lithe "mendengar" untuk permintaan, iaitu, ia menunggu permintaan masuk dan mengarahkannya ke laluan yang ditentukan.

Sekarang, buat fail bernama posts.php di dalam folder src/routes/posts untuk mewakili laluan /posts dan tambah kod berikut:

php line make:model Post

Laluan ini menyambungkan kaedah dalam PostController ke URL API.

---

Langkah 7: Uji API

Sekarang semuanya telah disediakan, anda boleh menguji API anda dengan alatan seperti Posmen atau Insomnia. Berikut ialah titik akhir yang boleh anda uji:

• DAPATKAN /siaran: Mengembalikan semua siaran.
• DAPATKAN /posts/:id: Mengembalikan siaran tertentu.
• POST /siaran: Mencipta siaran baharu.
• PUT /posts/:id: Mengemas kini siaran sedia ada.
• PADAM /siaran/:id: Memadamkan siaran.

---

Kini, anda baru sahaja mencipta Mini Blog API dengan Lithe dan ORM Fasih! Lithe menyediakan Eloquent secara automatik untuk anda, dan kami hanya membuat beberapa pelarasan pada pembolehubah persekitaran dan mencipta model dan pengawal yang diperlukan. Kini anda mempunyai API RESTful yang lengkap untuk mengurus catatan blog.

Untuk mendapatkan maklumat lanjut dan butiran tentang cara menggunakan Lithe dan Eloquent ORM, lawati dokumentasi Lithe rasmi di sini: Lithe Documentation.

Atas ialah kandungan terperinci Mencipta API Blog Mini dengan Lithe dan Fasih. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!