最近は久々にガッツリPHPのコードを書いているわたなべです。 このところ、仕事でもプライベートでもPHPでAPIを書いて、Next.jsでフロントのWebアプリを書くことがほとんどです。 この場合API仕様は以前ブログにも書きましたが、swagger-phpのアノテーションで記述して、Swagger-UIで参照できる様にしています。 kaz29.hatenablog.com Swagger-UI と swagger-php 最近は使われている方も多いと思いますが、簡単に説明すると、EntityとControllerに以下の様なアノテーションを記述します。 Entity/Article.php /** * Article Entity * * @OA\Schema( * schema="Article", * title="", * description="Article entity",