$this->put()

ディスプット（テスト）

意味 PUTリクエストのテスト

$this->put()とは？

$this->put() は、Laravelのテストクラス内で使用するメソッドです。このメソッドは、指定したURLにPUTリクエストを送信してその応答をテストします。既存のデータの更新をテストする際に使用します。

$this->put()の具体的な使い方

PUTリクエストでユーザー情報の更新をテスト

class UserTest extends TestCase
{
    public function testUpdateUser()
    {
        // テスト用のユーザーを作成
        $user = User::factory()->create([
            'name' => '佐藤花子',
            'email' => '[email protected]'
        ]);

        $response = $this->put('/users/' . $user->id, [
            'name' => '佐藤春子',
            'email' => '[email protected]'
        ]);

        $response->assertStatus(200)
                 ->assertJson([
                     'message' => 'ユーザー情報が正常に更新されました',
                     'user' => [
                         'name' => '佐藤春子',
                         'email' => '[email protected]'
                     ]
                 ]);

        $this->assertDatabaseHas('users', [
            'id' => $user->id,
            'name' => '佐藤春子',
            'email' => '[email protected]'
        ]);
    }
}

👇出力結果

ユーザー情報が正常に更新されました
{
    "message": "ユーザー情報が正常に更新されました",
    "user": {
        "name": "佐藤春子",
        "email": "[email protected]"
    }
}

この例では、UserTestクラス内のtestUpdateUserメソッドで、既存のユーザー情報を更新するテストを行っています。まず、テスト用のユーザーをデータベースに作成し、そのユーザーのIDを使用してPUTリクエストを送信します。リクエストには更新する名前とメールアドレスのデータが含まれます。テストでは、レスポンスのステータスコードが200（成功）であることを確認し、JSONレスポンスの内容を検証しています。さらに、データベース内のユーザー情報が正しく更新されたことも確認しています。

$this->put()に関するよくある質問

Q. PUTとPATCHの違いは？

A. PUTは通常、リソース全体の置き換えに使用され、指定されていないフィールドはnullや初期値に設定されます。一方、PATCHは部分的な更新に使用され、指定されたフィールドのみが更新されます。

Q. URLのIDはどう指定するの？

A. URLの中で直接IDを指定します（例：'/users/1'）。実際のアプリケーションでは、このIDは動的に生成されたり、テストデータから取得したりすることが多いです。

Q. 更新が失敗した場合のテストは？

A. assertStatus()で適切なエラーステータスコード（例：422 Unprocessable Entity）を確認したり、assertJson()でエラーメッセージを検証したりします。また、データベースの状態が変更されていないことを確認するテストも有効です。

$this->put()が学べる書籍の紹介

「プログラミング単語帳」を使って、プログラミングの単語を英単語のように学習してみませんか？
プログラミング単語帳には、Laravelの$this->put()や$this->json()、$this->patch()、$this->post()、などのような実務でよく使われる単語が数百以上収録されています。
この書籍には、プログラミングの単語の意味や読み方、単語の使い方がわかる例文などが掲載されており、いつでもどこでもプログラミングの学習ができます。

よく使われる単語にだけ絞って学習することができるので、効率的にプログラミングが学習できます。