ファイルを選択してZIPダウンロードする機能ってどうやって作るの？ / phpcondo 2023

https://fortee.jp/phpcon-hokkaido-2024/proposal/569f0b56-276e-4aad-822f-29ccb72e86a8

Transcript

1. ファイルを選択して ZIPダウンロードする機能って どうやって作るの？ PHPカンファレンス北海道2024 1
2. meihei / 江間 洋平 株式会社PR TIMES Backend Engineer (PHP/Python/Go) X: @app1e_s GitHub: @meihei3 Bluesky: @meihei.bsky.social 直近の登壇 自己紹介 ＼推しカラーはホワイトです！／ 2
3. （宣伝）Run on PHP Playground 作りました • php.net 上のサンプルコードを php-play.dev で実行 できるボタンが追加される Chrome 拡張機能です 3
4. 今日話すこと • 「Zipダウンロード機能」を題材に、AWSの 構成を考える話 • コードの話は出てきません 4
5. こんな機能です • 企業がアップロード したファイルを • ユーザーが複数選択 して • Zip圧縮してダウンロー ドできる機能 5
6. 仕様を聞く 設計を考える 6
8. PdM ※実際のPdMは猫ではなく人間です。架空の人物という体なので見た目が猫になっています。 8
9. PdM Zipファイルのダウンロード 機能を作ります 9
10. 仕様から考える１ Zipファイルをダウンロードできるようにする。 • ファイルが（ほぼ）変更が無いのであれば、S3に 置くだけでよい ◦ （例えば、管理者が用意したZipファイルを ダウンロードする） 10
11. 設計イメージ１ 11
12. PdM Zip圧縮する中身のファイル は、企業がアップロードした ものです Zipファイルのダウンロード 機能を作ります 12
13. 仕様から考える２ Zip圧縮する中身のファイルは、企業がアップロードし たものです。 • 中身のファイルが更新されたら、生成し直す ◦ 動的に生成か、静的に生成か 13
14. 仕様から考える２ Zip圧縮する中身のファイルは、企業がアップロードし たものです。 • 中身のファイルが更新されたら、生成し直す ◦ 動的に生成か、静的に生成か →サービス・機能の特徴に合わせる 14
15. アップロードからダウンロードまでの時間軸 15
16. 静的になるようにZipファイルを事前に生成 16
17. 静的になるようにZipファイルを事前に生成 →ダウンロード時に待ち時間が発生しない 17
18. 動的にZipファイルを生成 18
19. 動的にZipファイルを生成 →ダウンロード時に待ち時間が発生する 19
20. 事前生成 vs 動的生成 メリット デメリット 事前生成 （静的ファイル） • サーバーの負荷が 少ない • 高速なレスポンス • ストレージの上限 • 柔軟性に制限あり 動的生成 • 柔軟性がある • 内容が最新 • サーバーへの負荷 • レスポンス時間の 遅延 20
21. 事前生成 vs 動的生成 メリット デメリット 事前生成 （静的ファイル） • サーバーの負荷が 少ない • 高速なレスポンス • ストレージの上限 • 柔軟性に制限あり 動的生成 • 柔軟性がある • 内容が最新 • サーバーへの負荷 • レスポンス時間の 遅延 実際にそれがサービスに求められているか？ 21
22. 事前生成 vs 動的生成 メリット デメリット 事前生成 （静的ファイル） • サーバーの負荷が 少ない • 高速なレスポンス • ストレージの上限 • 柔軟性に制限あり 動的生成 • 柔軟性がある • 内容が最新 • サーバーへの負荷 • レスポンス時間の 遅延 サービスにとって致命的になるか？ 22
23. 仕様から考える２ Zip圧縮する中身のファイルは、企業がアップロードし たものです。 • 中身のファイルが更新されたら、生成し直す ◦ 動的に生成か、静的に生成か • 検討事項 ◦ 内容の変更頻度が多いか？ ◦ その機能のアクセス数は多いか？ 23
24. 仕様から考える２ Zip圧縮する中身のファイルは、企業がアップロードし たものです。 • 中身のファイルが更新されたら、生成し直す ◦ 動的に生成か、静的に生成か • 検討事項 ◦ 内容の変更頻度が多いか？　→少ない ◦ その機能のアクセス数は多いか？　→少ない 静的ファイルを作る方針 24
25. 設計イメージ２ 25
26. PdM 26
27. PdM Zip圧縮する中身のファイル は、企業がアップロードした ものです Zipファイルのダウンロード 機能を作ります 選択したファイルをZip圧縮 してダウンロード出来ます 27
28. 仕様から考える３ 選択したファイルをZip圧縮してダウンロード出来る。 • 静的ファイルを作るのは難しい ◦ 組み合わせ数が増大 • 動的に生成 ◦ 動的生成のデメリットを解消するか 28
29. 仕様から考える３ 選択したファイルをZip圧縮してダウンロード出来る。 • 静的ファイルを作るのは難しい ◦ 組み合わせ数が増大 • 動的に生成 ◦ 動的生成のデメリットを解消するか →サービス・機能の特徴に合わせる 29
30. 事前生成 vs 動的生成 メリット デメリット 事前生成 （静的ファイル） • サーバーの負荷が 少ない • 高速なレスポンス • ストレージの上限 • 柔軟性に制限あり 動的生成 • 柔軟性がある • 内容が最新 • サーバーへの負荷 • レスポンス時間の 遅延 30
31. 仕様から考える３ 選択したファイルをZip圧縮してダウンロード出来る。 • 静的ファイルを作るのは難しい ◦ 組み合わせ数が増大 • 動的に生成 ◦ 動的生成のデメリットを解消するか • 検討項目 ◦ サーバーへの負荷 ◦ パフォーマンス 31
32. 仕様から考える３ 選択したファイルをZip圧縮してダウンロード出来る。 • 静的ファイルを作るのは難しい ◦ 組み合わせ数が増大 • 動的に生成 ◦ 動的生成のデメリットを解消するか • 検討項目 ◦ サーバーへの負荷　→どちらかというと重要 ◦ パフォーマンス　→そこまで重要ではない 32
33. サーバーへの負荷を減らす • リクエストを受けるWebサーバーと、Zipファイルを 生成するBatchサーバーで分ける　→非同期処理 • ２回目以降は生成処理を実行しないようにする ファイルキャッシュの仕組み ◦ 現段階では不要 • （機能が独立しているならLambdaが便利） 33
34. 設計イメージ３ 34
35. 設計イメージ３ Zipファイルの ダウンロード開始 35
36. 36 非同期処理なのでファイルが 生成されているかわからない
37. 非同期処理なのでファイルが 生成されているかわからない 37 ステータスを確認するために、ポーリング用のAPIを用意。
38. 同期的なリクエストの場合 38
39. 非同期的なリクエストの場合 39
40. 設計イメージ４ 40
41. 設計イメージ４ ポーリング用のエンドポイント 41
42. 「実行中の状態」と 「ファイルが見つからない状態」の 判別ができない 42
43. 43 生成開始時に「実行中」の状態をINSERT 生成完了時に「完了」の状態へUPDATE 「実行中の状態」と 「ファイルが見つからない状態」の 判別ができない
44. 設計イメージ５ 44
45. 設計イメージ５ 生成開始とメイン の処理で分ける 45
46. PdM 46
47. まとめ • Zipファイルをダウンロードする機能のAWS構成につ いて一例を話しました ◦ サービス・機能の特徴を限定しないと、やり方はもっ とあります。 • 以下を繰り返す ◦ 要件・仕様を聞く ◦ 出来る方法・Pros/Consを考える ◦ 作ってみて発生した問題を解消する 47
48. 付録：ブログでも公開しています https://developers.prtimes.jp/2023/12/25/use_go_and_aws_to_build_press_kit_batch_download/ 48