Mencipta API Blog Mini dengan Lithe dan Fasih

Dalam tutorial ini, kami akan mencipta Mini Blog API menggunakan Lithe, rangka kerja PHP yang ringkas dan fleksibel serta ORM yang fasih, yang memudahkan interaksi dengan pangkalan data. Lithe sudah mengkonfigurasi Eloquent secara automatik, jadi kerja yang perlu kami lakukan adalah mudah: laraskan pembolehubah persekitaran dan cipta model serta migrasi untuk data kami.

Mari ikut panduan langkah demi langkah mudah untuk membina API ini dengan cekap dan tanpa komplikasi.

---

Langkah 1: Pasang Lithe

Langkah pertama ialah memasang Lithe dalam projek anda. Jika anda belum melakukan ini lagi, jalankan sahaja arahan berikut dalam terminal:

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

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

---

Langkah 2: Konfigurasi Pangkalan Data

Sekarang, mari kita konfigurasi pangkalan data. Buka fail .env dalam akar projek anda dan edit tetapan pangkalan data. Untuk menggunakan Eloquent ORM dengan MySQL, tetapan hendaklah 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

Kini, memandangkan Lithe sudah mengkonfigurasi Eloquent secara automatik, langkah seterusnya ialah memastikan Eloquent ORM dipasang. Jika anda belum berbuat demikian, jalankan arahan di bawah untuk memasang Eloquent ORM:

composer require illuminate/database

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

API

---

Langkah 3: Cipta Templat dan Berhijrah ke Siaran

Sekarang, mari buat model dan migrasi yang akan mentakrifkan jadual siaran dalam pangkalan data kami.

Mula-mula, buat templat Post dengan arahan:

php line make:model Post

Kemudian, buat migrasi untuk jadual siaran:

php line make:migration create_posts_table

Model dan migrasi telah pun dibuat, sekarang mari kita konfigurasikannya.

Templat Siar

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

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

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

Penghijrahan Jadual Catatan

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

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

Di sini, kami sedang mencipta jadual siaran dengan medan id, tajuk, kandungan dan medan tarikh dan masa 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:

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

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

---

Langkah 5: Cipta Pengawal untuk Siaran

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, jalankan:

composer require illuminate/database

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

Berikut ialah contoh rupa PostController:

php line make:model Post

Di sini, kami mempunyai lima kaedah asas:

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

---

Langkah 6: Tentukan Laluan API

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

php line make:migration create_posts_table

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

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

$app->listen(); menyebabkan Lithe mula "mendengar" permintaan, iaitu, ia menunggu permintaan 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:

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

Laluan ini menghubungkan kaedah 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.

---

Sekarang, anda baru sahaja mencipta Mini Blog API dengan Lithe dan ORM Fasih! Lithe mengkonfigurasi Eloquent secara automatik untuk anda, dan kami baru sahaja membuat beberapa pengubahsuaian 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!