ファイルを置く第09章 ・ 読むのにかかる時間 約10分

見せる​:配信と​公開範囲

倉庫は閉じたまま、受付が渡す

に​入れた​画像は、​そのままでは​誰にも​見えません。

倉庫は、​鍵が​かかっているのが​初期状態です。
この​章で​外に​出します。

ただし出し方が​3つ​あって、​選び方を​間違えると​事故に​なります。

この章でできるようになること

  • 3つの公開方法の違いと、選び方が分かる
  • Workerを通して画像を配れるようにする
  • 「全部見せる」と「選んで見せる」を自分で決められる
この章の内容(4節)
  1. 公開の方法は3つあります
  2. Worker経由で配る、という考え方
  3. 「全部見せる」か「選んで見せる」か
  4. この章のまとめ

公開の​方法は​3つあります

おすすめWorker経由
  • 倉庫は​閉じたまま
  • Workerが​取り出して​渡す
  • 見せる​相手を​選べる
  • 枚数制限なども​かけられる
  • この​教科書は​これ
開発用のみr2.dev
  • 1クリックで​全部​公開
  • お手軽だが​速度制限​あり
  • キャッシュも​使えない
  • 本番では​使わない
本番向け独自ドメイン
  • img.example.com など
  • キャッシュが​使える
  • 守りの機能も​使える
  • ドメインが必要
  • 大量配信なら​これ
迷ったら​Worker経由です。​あとから​他の​方法に​変えるのも​簡単です。

2つめの r2.dev に​ついて、​はっきり​書いて​おきます。

公式ドキュメントには、​こう​明記されています。

「r2.devサブドメイン経由の​公開アクセスには​速度制限が​あり、​開発目的にだけ​使ってください」。

管理画面の​ボタン1つで​有効に​できるので、​つい本番で​使いたくなりますが、​そこは​我慢する​所です。

Worker経由で​配る、と​いう​考え方

倉庫の​鍵は​閉めたままに​して、受付​(Worker)に​取りに​行かせます。

  1. 1見る人/file/ の​あとに​キーを​付けた​URLを​開く
  2. 2受付​(Worker)見せて​よいかを​判断して、​取りに​行く
  3. 3倉庫(R2)鍵は閉めたまま
人は​倉庫に​直接入れません。​「この​番号の​荷物を​ください」と​受付に​頼むと、​受付が​持ってきます。

この​形の​良い​ところは、​受付で​判断を​挟める​ことです。

「この​画像は​非公開だから​断る」​「この​人には​見せる」と​いった​制御が、​あとから​いくらでも​足せます。

倉庫を​開けっぱなしに​すると、​この​判断が​できません。

Claude Codeにこう頼みます

R2に保存した画像を、Worker経由で表示できるようにしてください。 ・/file/ のあとにキーを付けたURLで、その画像が表示されるようにする ・保存したときのContent-Typeをそのまま使って返す ・存在しないキーのときは、日本語のメッセージで404を返す ・R2バケットは公開設定にしないでください。Worker経由だけで配ります 作ったあと、動作確認用のURLを教えてください。

中心は​この​部分です。

const object = await env.BUCKET.get(key);
if (!object) return new Response("見つかりません", { status: 404 });

const headers = new Headers();
object.writeHttpMetadata(headers);   // 保存時の種類の札を貼り直す
return new Response(object.body, { headers });

writeHttpMetadata の​行が​大事です。

第8章で​一緒に​保存した種類の​札を、返すときに​貼り直しています。

これが​ないと、​ブラウザは​「何だか​分からない​ファイル」と​して​扱い、​画像を​表示せずに​ダウンロードを​始めます。

404(ヨンマルヨン)

「そんな​ものは​ありません」と​いう​返事です。
エラーではなく、​正しい​返事の​一種。

存在しない​キーを​頼まれた​ときに、​黙って​何も​返さないのではなく、はっきり404と​答えるのが​行儀の​よい​作りです。

「全部​見せる」か​「選んで​見せる」か

ここは、​あとで​揉めやすい​ところなので​先に​決めて​おきます。

いまの作りは、キーを​知っている​人は​誰でも​見られます。

キーは​で​たらめな​文字列なので、​当て​ずっぽうで​探し当てるのは​現実的では​ありません。

ただ、​URLを​人に​転送されたら、​その​人は​見られます。

全部見せるこのままで​いい​もの転送されても​困らない
  • 作品ギャラリー
  • 公開したい写真
選んで見せる受付で​判断を​足すもの決めた​人だけに​見せたい
  • 限定公開の資料
  • 個人の写真
URLを​転送されたら​困るか​どうか。​それで​決めます。
限定公開にしたくなったら

いまはキーを知っていれば誰でも画像を見られる状態です。これを、決められた人だけが見られる形に変えたいです。 初心者でも運用できる方法を、簡単な順に2つか3つ提案してください。それぞれの長所と短所も日本語で説明してください。まだ実装はしないでください。

まず提案だけ聞いて、​必要に​なってから​実装する。
この​頼み方は、​他の​場面でも​使えます。

キーが​合っている​とき画像が​そのまま​表示される/file/images/… のURLをブラウザで開き、アップロードした画像がそのまま表示されている実際の画面
存在しない​キーの​とき404の​日本語メッセージ存在しないキーを指定したときの実際の画面。「その画像は見つかりませんでした。URLのキーを確認してください。(404)」と表示されている
どちらも​Workerが​返しています。​倉庫は​閉じたままです。

うまくいったか確認する

  • /file/images/〜 の​URLを​ブラウザで​開くと、画像が​表示される(ダウンロードが​始まらない)
  • 存在しない​キーを​指定すると、​404の​メッセージが​出る
  • スマホでも​同じ​URLで​画像が​見える
  • R2の​管理画面で、が​公開設定に​なっていない​(閉じたままである)

よくあるつまずき

画像が表示されず、ダウンロードが始まる

種類の札()が​付いていません。

保存時に​付け忘れたか、​返すときに​貼り直していないかの​どちらかです。

「Content-Typeが​返せていないので​直してください」と​伝えてください。

いつも404になる

キーが​1文字でも​違うと​見つかりません。images/abc.png と image/abc.png は別物です。

一覧を​出して​もらって、​実際の​キーと​見比べてください。

日本語のファイル名で保存したら開けない
URLの​中で​日本語は​変換され、​扱いにくくなります。
キーは​英数字で​作るのが​安全です。
r2.devで公開したら、たまに表示されない

公式が​明記している​速度制限に​当たっています。
本番で​使う​想定の​窓口では​ありません。

Worker経由か​独自に​切り替えてください。

この章のまとめ

倉庫は​閉じたまま、​受付が​取り出して​渡す形に​しました。

種類の​札を​貼り直す​ことで、​ブラウザが​ちゃんと​画像と​して​表示してくれます。
そして、​公開範囲は​自分で​決められる​状態。

次の​章では、​増えていく​ファイルを​整理します。
消す、​並べる、​情報を​持たせる。

地味ですが、​ここが​できると​急に​実用的に​なります。

章末チェックリスト