使用 Lithe 和 Eloquent 创建迷你博客 API

在本教程中，我们将使用简单灵活的 PHP 框架 Lithe 创建一个 迷你博客 API，以及 Eloquent ORM，方便与数据库的交互。 Lithe 已经自动配置了 Eloquent，所以我们需要做的工作很简单：调整环境变量并为我们的数据创建模型和迁移。

让我们按照简单的分步指南高效且轻松地构建此 API。

---

第 1 步：安装 Lithe

第一步是在您的项目中安装Lithe。如果您还没有这样做，只需在终端中运行以下命令：

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

此命令使用 Lithe 创建一个新项目。 Lithe 已经自动为您配置 Eloquent，但我们需要调整 .env 文件中的一些设置来连接数据库。

---

第 2 步：配置数据库

现在，让我们配置数据库。打开项目根目录中的 .env 文件并编辑数据库设置。要将 Eloquent ORM 与 MySQL 一起使用，设置应如下所示：

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

现在，由于 Lithe 已经自动配置 Eloquent，下一步是确保安装 Eloquent ORM。如果您还没有这样做，请运行以下命令来安装 Eloquent ORM:

composer require illuminate/database

安装后，Lithe 将准备好使用 Eloquent ORM 并与数据库交互。这样，我们的 迷你博客!

API 的数据库就正确配置了

---

第 3 步：创建模板并迁移到帖子

现在，让我们创建模型和迁移来定义数据库中的 posts 表。

首先，使用以下命令创建帖子模板：

php line make:model Post

然后，为 posts 表创建迁移：

php line make:migration create_posts_table

模型和迁移已经创建，现在让我们配置它们。

帖子模板

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

在此代码中，我们将标题和内容字段定义为可填写，这意味着当我们创建或更新帖子时可以自动填充它们。

帖子表迁移

生成的迁移将位于 src/database/migrations/{timestamp}_create_posts_table.php 中。编辑迁移以创建 posts 表结构：

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

在这里，我们正在创建帖子表，其中包含字段 id、标题、内容以及日期和时间字段created_at 和updated_at。

---

第 4 步：运行迁移

准备好迁移和模型后，让我们运行迁移以在数据库中创建 posts 表。运行以下命令：

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

此命令将使用我们在迁移中定义的字段在数据库中创建 posts 表。

---

第 5 步：为帖子创建控制器

现在，让我们创建一个控制器来管理API帖子。控制器将负责以有组织的方式处理 HTTP 请求并返回数据。

要创建控制器，请运行：

composer require illuminate/database

这将在 src/http/Controllers/PostController.php 生成一个文件。编辑此文件以包含帖子的 CRUD（创建、读取、更新和删除）方法。

以下是 PostController 的示例：

php line make:model Post

这里，我们有五种基本方法：

• 索引：列出所有帖子。
• show：显示特定帖子。
• 商店：创建一个新帖子。
• 更新：更新现有帖子。
• destroy：删除帖子。

---

第 6 步：定义 API 路由

现在，让我们定义帖子 API 的路由。打开 src/App.php 文件并添加以下代码：

php line make:migration create_posts_table

上面的代码创建了 Lithe 应用程序的一个实例。 $app->set('routes', __DIR__ . '/routes'); 行告诉 Lithe 在哪里可以找到路由文件。 Lithe 会自动将所有文件加载到 src/routes 文件夹中。每个路由文件将根据其名称映射到 URL。例如：

• cart.php 文件转到 /cart 路由。
• admin/dashboard.php 文件转到 /admin/dashboard 路由。

$app->listen();使 Lithe 开始“监听”请求，也就是说，它等待请求并将它们定向到定义的路由。

现在，在 src/routes/posts 文件夹中创建一个名为 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 步：测试 API

现在一切都已设置完毕，您可以使用 Postman 或 Insomnia 等工具测试您的 API。以下是您可以测试的端点：

• GET /posts：返回所有帖子。
• GET /posts/:id：返回特定帖子。
• POST /posts：创建新帖子。
• PUT /posts/:id：更新现有帖子。
• DELETE /posts/:id：删除帖子。

---

现在，您刚刚使用 Lithe 和 Eloquent ORM 创建了一个 迷你博客 API！ Lithe 自动为您配置了 Eloquent，我们只需对环境变量进行一些修改并创建必要的模型和控制器。现在您已经有了一个完整的 RESTful API 来管理博客文章。

有关如何使用 Lithe 和 Eloquent ORM 的更多信息和详细信息，请访问此处的 Lithe 官方文档：Lithe 文档。

以上是使用 Lithe 和 Eloquent 创建迷你博客 API的详细内容。更多信息请关注PHP中文网其他相关文章！