PHPとAPI Platformで作る本格的なWeb APIアプリケーション（入門編） / phpcon 2024 Intro to API Platform

PHPカンファレンス2024 の発表資料です。

https://phpcon.php.gr.jp/2024/
https://phpcon.connpass.com/event/329839/
https://fortee.jp/phpcon-2024/proposal/8ec3f2ee-7187-4c79-b5a9-c92f032b1455
https://github.com/ttskch/phpcon-2024-api-platform-demo

Transcript

1. / 91 PHP API Platform Web API 2 024 / 12 / 2 2 PHP 2024 @ttskch  1 #track 4 入門 #phpcon
2. / 91 API Platform 十  2 ／
3. / 91  3 #phpcon 𝕏 🤝✨
4. / 91 PHP 13 Symfony 12 Kannade  4 @ttskch
5. / 91 PHP 13 Symfony 12 Kannade  5 @ttskch
6. / 91  6
7. / 91 PHP 13 Symfony 12 Kannade  7 @ttskch
8. / 91 PHP 13 Symfony 12 Kannade 2025 行 長  8 @ttskch
9. ॕʂॳ։࠵ʂ 🎉
10. ॕʂॳ։࠵ʂ 🎉 ・一 大
11. / 91 PHP API Platform Web API  11 入門
12. / 91  12 https://api-platform.com/docs/symfony/ API Platform 言 API Fabien Potencier (Symfony )
13. / 91 自己 2 API Platform 8 3 3 OpenAPI 3 1 5  13 🔖
14. / 91 一  14 https://github.com/ttskch/phpcon- 2024 -api-platform-demo 日 手 🙏
15. / 91 自己 2 API Platform 8 3 3 OpenAPI 3 1 5  15 🔖
16. / 91 Web API PHP 1 行 API API REST GraphQL Symfony API Platform ...  16
17. / 91 Web API PHP 1 行 API API REST GraphQL Symfony 201 5 / 09 2 024 / 0 8 Symfony Laravel ⾒ 20 24 / 09 API Platform ...  17
18. 2 0 24 / 09 / 27 API Platform 4 . 0 🎉
19. / 91 Web API PHP 1 行 API API REST GraphQL Symfony 201 5 / 09 2 024 / 0 8 Symfony Laravel ⾒ 20 24 / 09 API Platform ...  19
20. / 91 Web API PHP 1 行 API API REST GraphQL Symfony 201 5 / 09 2 024 / 0 8 Symfony Laravel ⾒ 20 24 / 09 API Platform ...  20
21. / 91 <?php namespace App\Models; use Illuminate\Database\Eloquent\Model; class Article extends Model { // }  21
22. / 91 <?php namespace App\Models; use ApiPlatform\Metadata\ApiResource; use Illuminate\Database\Eloquent\Model; #[ApiResource] class Article extends Model { // }  22
24. / 91  24 😳✨ ✨
25. / 91 Symfony 用 ⾒ Symfony API Platform Core Laravel 用 ⾒ Laravel API Platform Core 方  25 用 ⾒ https://api-platform.com/docs/core/bootstrap/
26. / 91 API Platform Core  26 https://github.com/api-platform/api-platform ⭐ 8 . 7 k https://github.com/api-platform/core ⭐ 2 . 5 k https://github.com/api-platform/admin ⭐ 4 87 https://github.com/api-platform/create-client ⭐ 374 https://github.com/api-platform/symfony ⭐ 8 https://github.com/api-platform/laravel ⭐ 49 _ …
27. / 91 API Platform Core  27 https://github.com/api-platform/api-platform ⭐ 8 . 7 k https://github.com/api-platform/core ⭐ 2 . 5 k https://github.com/api-platform/admin ⭐ 4 87 https://github.com/api-platform/create-client ⭐ 374 https://github.com/api-platform/symfony ⭐ 8 https://github.com/api-platform/laravel ⭐ 49 _ … API Platform Core API Platform
28. / 91 API Platform Core  28 https://github.com/api-platform/api-platform ⭐ 8 . 7 k https://github.com/api-platform/core ⭐ 2 . 5 k https://github.com/api-platform/admin ⭐ 4 87 https://github.com/api-platform/create-client ⭐ 374 https://github.com/api-platform/symfony ⭐ 8 https://github.com/api-platform/laravel ⭐ 49 _ … API Platform Core Subtree Split API Platform Core
29. / 91 API Platform Core  29 https://github.com/api-platform/api-platform ⭐ 8 . 7 k https://github.com/api-platform/core ⭐ 2 . 5 k https://github.com/api-platform/admin ⭐ 4 87 https://github.com/api-platform/create-client ⭐ 374 https://github.com/api-platform/symfony ⭐ 8 https://github.com/api-platform/laravel ⭐ 49 _ …
30. / 91 API Platform Core  30 https://github.com/api-platform/api-platform ⭐ 8 . 7 k https://github.com/api-platform/core ⭐ 2 . 5 k https://github.com/api-platform/admin ⭐ 4 87 https://github.com/api-platform/create-client ⭐ 374 https://github.com/api-platform/symfony ⭐ 8 https://github.com/api-platform/laravel ⭐ 49 _ … Core Symfony Admin Create Client 入
31. / 91 API Platform Core  31 https://github.com/api-platform/api-platform ⭐ 8 . 7 k https://github.com/api-platform/core ⭐ 2 . 5 k https://github.com/api-platform/admin ⭐ 4 87 https://github.com/api-platform/create-client ⭐ 374 https://github.com/api-platform/symfony ⭐ 8 https://github.com/api-platform/laravel ⭐ 49 _ …
32. / 91 API Platform Core  32 https://github.com/api-platform/api-platform ⭐ 8 . 7 k https://github.com/api-platform/core ⭐ 2 . 5 k https://github.com/api-platform/admin ⭐ 4 87 https://github.com/api-platform/create-client ⭐ 374 https://github.com/api-platform/symfony ⭐ 8 https://github.com/api-platform/laravel ⭐ 49 _ … Issue 子 🙆
33. is
34. is 色 入
35. / 91 色 入 身  35 API Platform Core 入 Symfony api-platform/ symphony React Admin 面 api-platform/ admin Next.js 自 生 api-platform/ create-client Mercure 用 - Docker - Kubernetes Helm -
36. / 91 色 入 身  36 API Platform Core 入 Symfony api-platform/ symphony React Admin 面 api-platform/ admin Next.js 自 生 api-platform/ create-client Mercure 用 - Docker - Kubernetes Helm - 色 入 🫠
37. / 91 Simple Easy  37 https://x.com/t_wada/status/ 13 771 47 20 307 71 1 18 14
38. / 91 Simple Easy  38 https://speakerdeck.com/takeru 0 757 /simple-is-not-easy?slide= 5 2
39. / 91 API Platform Easy  39 入 自 API Platform Core 1 行 API 生 Easy
40. / 91 API Platform Easy  40 入 自 API Platform Core 1 行 API 生 Easy
41. / 91  41
43. / 91 方 用 REST GraphQL 用  43
44. / 91 API Platform "Easy Simple "  44 Simple 1 小 士 目 Easy 用
45. / 91 API Platform "Easy Simple "  45 Simple 1 小 士 目 Easy 用 Symfony Kévin Dunglas Symfony
47. Easy
48. Simple
49. 日 🙆
50. / 91 自己 2 API Platform 8 3 3 OpenAPI 3 1 5  50 🔖 10 目
51. / 91 Laravel  51 $ composer create-project laravel/laravel my-app $ cd my-app
52. / 91 API Platform Core API Platform Core  52 $ composer require api-platform/laravel $ php artisan api-platform:install
53. / 91  53 $ php artisan serve
55. / 91 Article  55 $ php artisan make:model Article $ php artisan make:migration create_articles_table
56. / 91  56 public function up(): void { Schema::create('articles', function (Blueprint $table) { $table->id(); + $table->string('title'); + $table->text('content')->nullable(); + $table->boolean('published')->default(false); $table->timestamps(); }); }
57. / 91 行  57 $ php artisan migrate
58. / 91 API  58 <?php namespace App\Models; + use ApiPlatform\Metadata\ApiResource; use Illuminate\Database\Eloquent\Model; + #[ApiResource] class Article extends Model { // }
63. / 91  63 👏👏👏
64. / 91 自己 2 API Platform 8 3 3 OpenAPI 3 1 5  64 🔖 13 目
65. / 91 DB CRUD  65 一 一 一 一
66. / 91 ⾒  66 DB API DB API DB API CQRS etc …
67. / 91  67 State Provider / State Processor 自
68. / 91 State Provider / State Processor  68 State Provider State Processor 行
69. / 91 api-platform/laravel Eloquent 自 自 API State Provider / State Processor  69 State Provider State Processor 行
70. / 91 namespace App\State; use ApiPlatform\Metadata\Operation; use ApiPlatform\State\ProviderInterface; final class ArticleProvider implements ProviderInterface { public function provide(Operation $operation, array $uriVariables = [], array $context = []): object|array|null { $article = /* ͜͜ʹهࣄΛऔಘ͢ΔॲཧΛॻ͘ */; return $article; } }  70 State Provider 自
71. / 91 namespace App\State; use ApiPlatform\Metadata\Operation; use ApiPlatform\State\ProcessorInterface; class ArticleProcessor implements ProcessorInterface { public function process(mixed $data, Operation $operation, array $uriVariables = [], array $context = []): mixed { /* ͜͜ʹهࣄΛӬଓԽʢ$data Λߋ৽ͯ͠ $data->save() ͳͲʣ͢ΔॲཧΛॻ͘ */ return $data; } }  71 State Processor 自
72. / 91 namespace App\Providers; use ApiPlatform\State\ProcessorInterface; use App\State\ArticleProcessor; use App\State\ArticleProvider; use Illuminate\Support\ServiceProvider; class AppServiceProvider extends ServiceProvider { public function register(): void { $this->app->tag([ArticleProvider::class], ProviderInterface::class); $this->app->tag([ArticleProcessor::class], ProcessorInterface::class); } public function boot(): void { } }  72 Laravel ⾒
73. / 91 namespace App\Models; use ApiPlatform\Metadata\ApiResource; + use App\State\ArticleProcessor; + use App\State\ArticleProvider; use Illuminate\Database\Eloquent\Model; - #[ApiResource] + #[ApiResource( + provider: ArticleProvider::class, + processor: ArticleProcessor::class, + )] class Article extends Model { // }  73 API
74. / 91 自己 2 API Platform 8 3 3 OpenAPI 3 1 5  74 🔖 16 目
75. / 91 OpenAPI  75 Web API 言 OpenAPI OpenAPI JSON YAML OpenAPI Swagger UI API OpenAPI TypeScript 言 API 自 生
76. / 91 API Platform OpenAPI  76 API Platform OpenAPI 自 生 手 OpenAPI API 自 生 力
77. / 91  77 API Platform 自 OpenAPI 力 Laravel DB SQLite bool OpenAPI boolean string 🤦
78. / 91  78
79. / 91 boolean 力 手  79
80. / 91 namespace App\Models; + use ApiPlatform\Metadata\ApiProperty; use ApiPlatform\Metadata\ApiResource; use App\State\ArticleProcessor; use App\State\ArticleProvider; use Illuminate\Database\Eloquent\Model; #[ApiResource( provider: ArticleProvider::class, processor: ArticleProcessor::class, )] + #[ApiProperty(schema: ['type' => 'boolean'], property: 'published')] class Article extends Model { // }  80
81. / 91  81 ／
82. / 91 OpenAPI 生 OpenApiFactory 👌 API Platform OpenApiFactory  82
83. / 91 自己 2 API Platform 8 3 3 OpenAPI 3 1 5  83 🔖
84. / 91 Fabien 1 行 API API 3 行  84
85. / 91 Fabien 1 行 API API 3 行  85
86. / 91 Fabien 1 行 API API 3 行  86 😉
87. / 91  87
88. / 91 Symfony/Laravel API Platform OpenAPI/JSON Schema/JSON-LD/Hydra 自 PhpStorm ✍  88
89. / 91  89 ・ 🫰 @ttskch Thanks! ／
90. / 91 自己 2 API Platform 8 3 3 OpenAPI 3 1 5  90 🔖
91. / 91 API 子 OpenAPI JSON 力 TypeScript 自 生 用 子 見  91