您好！在本教程中，我们将在
laravel
中构建一个完整的 rest api 来管理任务。我将指导您完成从设置项目到创建自动化测试的基本步骤。
第 1 步：项目设置
创建一个新的 laravel 项目：
配置数据库：
在 .env 文件中，设置数据库配置：
生成任务表：
运行命令为任务表创建新的迁移：
在迁移文件（database/migrations/xxxx_xx_xx_create_tasks_table.php）中，定义表结构：
运行迁移以创建表：
第 2 步：创建模型和控制器
为任务创建模型和控制器：
定义任务模型（app/models/task.php）：
第 3 步：定义 api 路由
在routes/api.php文件中，添加taskcontroller的路由：
第四步：在taskcontroller中实现crud
在taskcontroller中，我们将实现基本的crud方法。
步骤 5：测试端点（vs code）
现在我们将使用名为
rest client
的 vs code 扩展手动测试每个端点 (https://marketplace.visualstudio.com/items?itemname=humao.rest-client)。如果您愿意，您还可以使用
失眠
或
邮递员
！
安装扩展程序后，在项目文件夹中创建一个包含以下内容的 .http 文件：
Composer 2.9.6
Composer 2.9.6 是 PHP 生态中高效、稳定的依赖管理工具。此版本在性能与兼容性上进一步优化，改进了依赖解析算法，提升大型项目中的安装与更新速度。它支持并行下载任务，显著减少等待时间，并增强了与私有仓库及镜像源的交互稳定性。同时修复了多项命令行交互与内存使用相关的缺陷，确保在复杂依赖关系下依然可靠运行。无论是新项目初始化还是现有系统维护，Composer 2.9.6 都能为开发者提供流畅、精准的依赖管理体验。
下载
此文件可让您使用
rest 客户端
扩展直接从 vs code 发送请求，从而轻松测试 api 中的每个路由。
第 6 步：测试 api
接下来，让我们创建测试以确保每条路线按预期工作。
首先，为任务模型创建一个工厂：
phpunit 配置：
创建集成测试：
在tests/feature/taskapitest.php文件中，实现测试：
运行测试
：
*
谢谢！ *
composer create-project laravel/laravel task-api
cd task-api
code .
db_database=task_api
db_username=your_username
db_password=your_password
php artisan make:migration create_tasks_table --create=tasks
id();
$table->string('title');
$table->text('description')->nullable();
$table->boolean('completed')->default(false);
$table->timestamps();
});
}
public function down(): void
{
schema::dropifexists('tasks');
}
};
php artisan migrate
php artisan make:model task
php artisan make:controller taskcontroller --api
json($tasks, 200);
}
public function store(request $request)
{
$request->validate([
'title' => 'required|string|max:255',
'description' => 'nullable|string'
]);
$task = task::create($request->all());
return response()->json($task, 201);
}
public function show(task $task)
{
return response()->json($task, 200);
}
public function update(request $request, task $task)
{
$request->validate([
'title' => 'required|string|max:255',
'description' => 'nullable|string',
'completed' => 'boolean'
]);
$task->update($request->all());
return response()->json($task, 201);
}
public function destroy(task $task)
{
$task->delete();
return response()->json(null, 204);
}
}
### create new task
post http://127.0.0.1:8000/api/tasks http/1.1
content-type: application/json
accept: application/json
{
"title": "study laravel"
}
### show tasks
get http://127.0.0.1:8000/api/tasks http/1.1
content-type: application/json
accept: application/json
### show task
get http://127.0.0.1:8000/api/tasks/1 http/1.1
content-type: application/json
accept: application/json
### update task
put http://127.0.0.1:8000/api/tasks/1 http/1.1
content-type: application/json
accept: application/json
{
"title": "study laravel and docker",
"description": "we are studying!",
"completed": false
}
### delete task
delete http://127.0.0.1:8000/api/tasks/1 http/1.1
content-type: application/json
accept: application/json
php artisan make:factory taskfactory
fake()->sentence(),
'description' => fake()->paragraph(),
'completed' => false,
];
}
}
tests/unit
tests/feature
app
php artisan make:test taskapitest
postjson('/api/tasks', [
'title' => 'new task',
'description' => 'task description',
'completed' => false,
]);
$response->assertstatus(201);
$response->assertjson([
'title' => 'new task',
'description' => 'task description',
'completed' => false,
]);
}
public function test_can_list_tasks()
{
task::factory()->count(3)->create();
$response = $this->getjson('/api/tasks');
$response->assertstatus(200);
$response->assertjsoncount(3);
}
public function test_can_show_task()
{
$task = task::factory()->create();
$response = $this->getjson("/api/tasks/{$task->id}");
$response->assertstatus(200);
$response->assertjson([
'title' => $task->title,
'description' => $task->description,
'completed' => false,
]);
}
public function test_can_update_task()
{
$task = task::factory()->create();
$response = $this->putjson("/api/tasks/{$task->id}", [
'title' => 'update task',
'description' => 'update description',
'completed' => true,
]);
$response->assertstatus(201);
$response->assertjson([
'title' => 'update task',
'description' => 'update description',
'completed' => true,
]);
}
public function test_can_delete_task()
{
$task = task::factory()->create();
$response = $this->deletejson("/api/tasks/{$task->id}");
$response->assertstatus(204);
$this->assertdatabasemissing('tasks', ['id' => $task->id]);
}
}
php artisan test