基于 TDD 模式在 Laravel 项目中开发后端评论接口

<?php

​

namespace Tests\Feature;

​

use Illuminate\Foundation\Testing\RefreshDatabase;

use Illuminate\Foundation\Testing\WithFaker;

use Tests\TestCase;

​

class CommentTest extends TestCase

{

    use RefreshDatabase;  // 测试用例在执行完毕后回滚数据库更新

    use WithFaker;  // 引入 Faker 伪造评论内容

​

    protected function setUp(): void

    {

        parent::setUp();

        $this->faker = $this->makeFaker('zh_CN');  // 本地化 Faker

    }

​

    /**

     * @test

     */

    public function submit_comment_add_then_display()

    {

        // Given

        $content = $this->faker->sentence;

        // When

        $response = $this->post('/comments', ['content' => $content]);

        // Then

        $response->assertStatus(200);

​

        $response = $this->get('/comments');

        $response->assertSeeText($content);

    }

}

use App\Http\Controllers\CommentController;

Route::group(['prefix' => '/comments'], function () {

    Route::get('/', [CommentController::class, 'all']);

    Route::post('/', [CommentController::class, 'store']);

});

<?php

​

namespace App\Http\Controllers;

​

use App\Models\Comment;

use Illuminate\Http\Request;

​

class CommentController extends Controller

{

    public function all()

    {

        return Comment::orderByDesc('created_at')->simplePaginate(10);

    }

    public function store(Request $request)

    {

        $data = $request->validate([

            'content' => 'required'

        ]);

        $comment = new Comment($data);

        return $comment->save();

    }

}

php artisan make:model Comment -m

<?php

​

namespace App\Models;

​

use Illuminate\Database\Eloquent\Factories\HasFactory;

use Illuminate\Database\Eloquent\Model;

​

class Comment extends Model

{

    use HasFactory;

​

    protected $fillable = ['content'];

​

    public function user()

    {

        $this->belongsTo(User::class);

    }

}

DB_CONNECTION=mysql

DB_HOST=127.0.0.1

DB_PORT=3306

DB_DATABASE=component_test

DB_USERNAME=root

DB_PASSWORD=root

<?php

​

use Illuminate\Database\Migrations\Migration;

use Illuminate\Database\Schema\Blueprint;

use Illuminate\Support\Facades\Schema;

​

class CreateCommentsTable extends Migration

{

    /**

     * Run the migrations.

     *

     * @return void

     */

    public function up()

    {

        Schema::create('comments', function (Blueprint $table) {

            $table->id();

            $table->bigInteger('user_id')->unsigned()->default(0);

            $table->string('content');

            $table->timestamps();

        });

    }

​

    /**

     * Reverse the migrations.

     *

     * @return void

     */

    public function down()

    {

        Schema::dropIfExists('comments');

    }

}