在本教程中，我們將使用簡單靈活的 PHP 框架 Lithe 創(chuàng)建一個(gè) 迷你博客 API，以及 Eloquent ORM，方便與數(shù)據(jù)庫的交互。 Lithe 已經(jīng)自動(dòng)配置了 Eloquent，所以我們需要做的工作很簡單：調(diào)整環(huán)境變量并為我們的數(shù)據(jù)創(chuàng)建模型和遷移。

讓我們按照簡單的分步指南高效且輕松地構(gòu)建此 API。

---

第 1 步：安裝 Lithe

第一步是在您的項(xiàng)目中安裝Lithe。如果您還沒有這樣做，只需在終端中運(yùn)行以下命令：

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

此命令使用 Lithe 創(chuàng)建一個(gè)新項(xiàng)目。 Lithe 已經(jīng)自動(dòng)為您配置 Eloquent，但我們需要調(diào)整 .env 文件中的一些設(shè)置來連接數(shù)據(jù)庫。

---

第 2 步：配置數(shù)據(jù)庫

現(xiàn)在，讓我們配置數(shù)據(jù)庫。打開項(xiàng)目根目錄中的 .env 文件并編輯數(shù)據(jù)庫設(shè)置。要將 Eloquent ORM 與 MySQL 一起使用，設(shè)置應(yīng)如下所示：

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

現(xiàn)在，由于 Lithe 已經(jīng)自動(dòng)配置 Eloquent，下一步是確保安裝 Eloquent ORM。如果您還沒有這樣做，請(qǐng)運(yùn)行以下命令來安裝 Eloquent ORM:

composer require illuminate/database

安裝后，Lithe 將準(zhǔn)備好使用 Eloquent ORM 并與數(shù)據(jù)庫交互。這樣，我們的 迷你博客!

API 的數(shù)據(jù)庫就正確配置了

---

第 3 步：創(chuàng)建模板并遷移到帖子

現(xiàn)在，讓我們創(chuàng)建模型和遷移來定義數(shù)據(jù)庫中的 posts 表。

首先，使用以下命令創(chuàng)建帖子模板：

php line make:model Post

然后，為 posts 表創(chuàng)建遷移：

php line make:migration create_posts_table

模型和遷移已經(jīng)創(chuàng)建，現(xiàn)在讓我們配置它們。

帖子模板

Post 模型位于 src/models/Post.php。像這樣編輯文件：

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

在此代碼中，我們將標(biāo)題和內(nèi)容字段定義為可填寫，這意味著當(dāng)我們創(chuàng)建或更新帖子時(shí)可以自動(dòng)填充它們。

帖子表遷移

生成的遷移將位于 src/database/migrations/{timestamp}_create_posts_table.php 中。編輯遷移以創(chuàng)建 posts 表結(jié)構(gòu)：

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

在這里，我們正在創(chuàng)建帖子表，其中包含字段 id、標(biāo)題、內(nèi)容以及日期和時(shí)間字段created_at 和updated_at。

---

第 4 步：運(yùn)行遷移

準(zhǔn)備好遷移和模型后，讓我們運(yùn)行遷移以在數(shù)據(jù)庫中創(chuàng)建 posts 表。運(yùn)行以下命令：

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

此命令將使用我們?cè)谶w移中定義的字段在數(shù)據(jù)庫中創(chuàng)建 posts 表。

---

第 5 步：為帖子創(chuàng)建控制器

現(xiàn)在，讓我們創(chuàng)建一個(gè)控制器來管理API帖子。控制器將負(fù)責(zé)以有組織的方式處理 HTTP 請(qǐng)求并返回?cái)?shù)據(jù)。

要?jiǎng)?chuàng)建控制器，請(qǐng)運(yùn)行：

composer require illuminate/database

這將在 src/http/Controllers/PostController.php 生成一個(gè)文件。編輯此文件以包含帖子的 CRUD（創(chuàng)建、讀取、更新和刪除）方法。

以下是 PostController 的示例：

php line make:model Post

這里，我們有五種基本方法：

• 索引：列出所有帖子。
• show：顯示特定帖子。
• 商店：創(chuàng)建一個(gè)新帖子。
• 更新：更新現(xiàn)有帖子。
• destroy：刪除帖子。

---

第 6 步：定義 API 路由

現(xiàn)在，讓我們定義帖子 API 的路由。打開 src/App.php 文件并添加以下代碼：

php line make:migration create_posts_table

上面的代碼創(chuàng)建了 Lithe 應(yīng)用程序的一個(gè)實(shí)例。 $app->set('routes', __DIR__ . '/routes'); 行告訴 Lithe 在哪里可以找到路由文件。 Lithe 會(huì)自動(dòng)將所有文件加載到 src/routes 文件夾中。每個(gè)路由文件將根據(jù)其名稱映射到 URL。例如：

• cart.php 文件轉(zhuǎn)到 /cart 路由。
• admin/dashboard.php 文件轉(zhuǎn)到 /admin/dashboard 路由。

$app->listen();使 Lithe 開始“監(jiān)聽”請(qǐng)求，也就是說，它等待請(qǐng)求并將它們定向到定義的路由。

現(xiàn)在，在 src/routes/posts 文件夾中創(chuàng)建一個(gè)名為 posts.php 的文件來表示 /posts 路由，并添加以下代碼：

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

這些路由將 PostController 方法連接到 API URL。

---

第 7 步：測(cè)試 API

現(xiàn)在一切都已設(shè)置完畢，您可以使用 Postman 或 Insomnia 等工具測(cè)試您的 API。以下是您可以測(cè)試的端點(diǎn)：

• GET /posts：返回所有帖子。
• GET /posts/:id：返回特定帖子。
• POST /posts：創(chuàng)建新帖子。
• PUT /posts/:id：更新現(xiàn)有帖子。
• DELETE /posts/:id：刪除帖子。

---

現(xiàn)在，您剛剛使用 Lithe 和 Eloquent ORM 創(chuàng)建了一個(gè) 迷你博客 API！ Lithe 自動(dòng)為您配置了 Eloquent，我們只需對(duì)環(huán)境變量進(jìn)行一些修改并創(chuàng)建必要的模型和控制器?，F(xiàn)在您已經(jīng)有了一個(gè)完整的 RESTful API 來管理博客文章。

有關(guān)如何使用 Lithe 和 Eloquent ORM 的更多信息和詳細(xì)信息，請(qǐng)?jiān)L問此處的 Lithe 官方文檔：Lithe 文檔。

以上是使用 Lithe 和 Eloquent 創(chuàng)建迷你博客 API的詳細(xì)內(nèi)容。更多信息請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！