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

置く​:アップロードの​しく​み

初心者が必ず踏む落とし穴つき

倉庫に​荷物を​入れます。

入れ方は​2つ​あって、手で​1枚だけ置く​方法と、フォームから​受け取って​自動で​置く​方法です。

順番に​やります。
そして、​この​章には​初心者が​100%踏む落とし穴が​1つあります。

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

  • 手元の画像を1枚、R2に置いて確認する
  • 「本物のR2に入ったのか、練習用の場所に入ったのか」を見分ける
  • フォームから送られた画像を、Workerが受け取ってR2に保存する
この章の内容(5節)
  1. まず、手で1枚置いてみる
  2. 落とし穴:黙っていると、本物には入りません
  3. 本命:フォームから受け取って保存する
  4. 動かして確かめる
  5. この章のまとめ

まず、​手で​1枚置いてみる

プロジェクトの​フォルダに、​適当な​画像を​1枚置いてください。
名前は sample.png にします。

そのうえで、​こう​頼みます。

Claude Codeにこう頼みます

フォルダにある sample.png を、my-photos バケットに images/sample.png というキーで保存してください。 必ず本物のR2(リモート)に保存してください。ローカルの模擬ストレージではありません。保存できたら、リモートから取得し直して、ちゃんと入っているか確認してから教えてください。

この​依頼文には、​わざと​同じ​ことを​2回書いてあります。
理由は​次の​とおりです。

落と​し穴:黙っていると、​本物には​入りません

に​ファイルを​入れる​操作は、何も​指定しないと、​あなたの​パソコンの​中の​「練習用の​模擬ストレージ」に​保存されます。

画面には​「保存しました」と​出ます。
エラーも​出ません。

それなのに、​Cloudflareの​管理画面を​見ると​空っぽです。

実際、​画面には​こう​表示されます。

練習用に​入った​とき管理画面は​空っぽのまま
Resource location: local
Use --remote if you want to access the remote instance.
本物に​入った​とき管理画面に​増える
Resource location: remote
local と​ remote。​見るのは​この​1語だけです。

local と​書いて​あったら、​本物では​ありません。

この​1行を​見落とすと、​「保存されているはずなのに​表示されない」と​いう​迷宮に​入ります。

僕は​ここで​時間を​溶かしました。

本物に​入れると、​同じ​場所の​表示が​ remote に​変わります。

ローカルの模擬ストレージ

練習用の、​パソコンの​中だけに​ある​偽の​R2です。

本物を​汚さずに​試せる、​便利な​仕組みでは​あります。

ただ、​初めての​人には​「保存できたのに​見えない」と​いう​混乱の​原因に​しかなりません。

この​教科書では、​依頼文に​必ず​「本物の​R2に」と​書く​ことで​避けます。

うまくいったか確認する

  • 実行結果に Resource location: remote と出ている
  • Cloudflareの​管理画面で​R2を​開き、my-photos の中に images/sample.png が見える
  • 管理画面で​ファイルサイズが​0バイトに​なっていない

本命:フォームから​受け取って​保存する

毎回​あなたが​作業の​画面から​頼んで​入れるのでは、​自分しか​使えません。

ブラウザから​選んだ​画像が、​そのまま​R2に​入るようにします。

第12章までは、手元だけで試します

この​章から​第11章までに​作る​「送る」​「消す」の​窓口には、​まだ合​言葉が​ありません。

この​状態で​公開すると、​URLを​知った​誰でも​写真を​送れて、​消すことも​できます。

第12章で​合言葉を​付けるまでは、​公開せずに​手元の​画面だけで​試してください。

公開してしまった​ときは、​こう​頼めば元に​戻せます。

「アップロードと​削除の​窓口を、​いったん外して​公開し直してください」

  1. 1ブラウザ画像を​選んで​送信
  2. 2Worker確認して、​重複しない​名前と​種類を​付ける
  3. 3R2(倉庫)images/ランダム文字-sample.png
Workerは、​ただ通すだけでは​ありません。​名前を​決めて、​種類を​覚えさせてから​預けます。
Claude Codeにこう頼みます

画像アップロードの仕組みを作ってください。 ・トップページに、画像を1枚選んで送信できるフォームを置く ・Workerが /upload でそれを受け取り、BUCKETバインディングを使ってR2に保存する ・キーは images/ で始め、重複しないようにランダムな文字列を混ぜる ・画像の種類(Content-Type)も一緒に保存する ・画像以外のファイルや、5MBを超えるファイルは断って、日本語のメッセージを返す ・保存できたら、保存したキーをJSONで返す 作り終わったら、それぞれの部分が何をしているかを日本語で説明してください。

できあがる​プログラムの​中心は、​この​3行です。

const key = `images/${crypto.randomUUID()}-${file.name}`;
await env.BUCKET.put(key, file.stream(), {
  httpMetadata: { contentType: file.type },
});

1​行ずつ​読むと、​こう​書いてあります。

  • 1行目:重複しない​名前を​作る。crypto.randomUUID() は、​毎回​違うで​たらめな​文字列を​作る​道具です
  • 2行目:env.BUCKET に put(置く)します。
    第7章で​決めた​呼び名が​ここに​出てきます
  • 3行目:ファイルの​種類を​一緒に​覚えさせる。
    これが​次の​章で​必要に​なります

Content-Type(コンテントタイプ)

「これは​PNG画像です」​「これは​PDFです」と​いう、​中身の​種類を​表す札です。

R2は​中身を​見ないので、​この​札を​貼っておかないと、​あとで​取り出した​ときに​ブラウザが​画像と​して​表示してくれません。

保存する​ときに​一緒に​持たせるのが​鉄則です。

忘れると、​次の​章で​「画像が​ダウンロードされてしまう」と​いう​症状に​なります。

アップロード前の確認(バリデーション)

送られてきた​ものが​本当に​画像か、​大きすぎないかを、​保存する​前に​調べる​ことです。

誰でも​送れる​窓口を​開ける以上、​ここは​必ず​入れます。

無制限に​受け取ると、​無料枠を​一晩で​食いつぶされる​ことも​あり得ます。

動かして​確かめる

Claude Codeにこう頼みます

アップロードを試したいです。本物のR2につながる形でローカル起動して、開くURLを教えてください。 起動できたら、私がブラウザで画像を送ったあとに、R2の中身を一覧して、本当に増えているかを確認してください。

  1. 表示された​URLを​ブラウザで​開く
  2. 画像を​1枚選んで​送信するimages/ で​始まる​長い​キーが​返ってきます
  3. 返ってきた​キーと、​R2の​一覧を​見比べるR2の​一覧にも、​同じ​キーが​増えています

よくあるつまずき

Resource location: local

この​章の​落とし穴です。
本物ではなく​練習用に​保存されています。

「本物のR2()に​保存し直してください」と​頼んでください。

TypeError: env.BUCKET is undefined

第7章のが​働いていません。

wrangler.jsonc に r2_buckets が​あるか、​呼び名が​ BUCKET に​なっているかを​確認して​もらってください。

アップロードは成功するのに、管理画面のファイルが0バイト

中​身が​空のまま​保存されています。

ファイルの​読み取り方に​問題が​あるので、​「保存した​ファイルの​サイズが​0に​なっています。

原因を​調べて​直してください」と​伝えてください。

同じ画像を2回上げたら、1個しか増えない

同じ​キーに​なっていて、​上書きされています。

ランダムな​文字列が​キーに​入っているか​確認してください。

大きな画像を送ると失敗する

制限に​当たっています。
まずは​自分で​決めた​上限​(5MBなど)を​確認してください。

それを​超えていないのに​失敗する​場合は、​エラーの​文面を​そのまま​Claude Codeに​貼って​聞くのが​最短です。

この章のまとめ

手で​1枚置き、​フォームからも​置けるようにしました。

キーは​自動で​重複しない​形に​して、​種類の​札も​貼ってあります。

そしてlocal と​ remote の​違いと​いう、​この​分野で​一番の​初見殺しを​覚えました。

ただ、​いま入れた​画像は、​まだ誰にも​見えません。
次の​章で​外に​出します。

章末チェックリスト