SQLiteのファイル・画像フォルダー・配信URLの対応表
ローカルのEmDashで、記事の保存先、写真の保存先、ブラウザーから写真を開くURLを調べます。
目次
「週末ノート」では、記事と写真の登録情報を data.db に、写真のファイルを uploads フォルダーに保存します。写真をブラウザーで開くときは、EmDashが用意する配信用のURLを使います。
astro.config.mjs のどこを見る?
作業フォルダーにある astro.config.mjs を開き、emdash({...}) の中にある database と storage を探してください。次はローカルの教材で使っている値です。
| 設定する場所 | 教材の値 | 意味 |
|---|---|---|
sqlite() の url | file:./data.db | 起動したフォルダーにあるSQLiteファイル。記事や写真の登録情報が入る |
local() の directory | ./uploads | アップロードした写真のファイルを置くフォルダー |
local() の baseUrl | /_emdash/api/media/file | ブラウザーからファイルを開くURLの共通部分 |
たとえば、記事のタイトルが出るのに写真を開けないときは、記事を読む処理までは動いています。次に、写真のファイルがあるか、そのファイルを配信用のURLで開けるかを順番に確かめます。
保存先と配信URLを確かめる
写真付き一覧の実習で教材を用意し、「週末の記録 01」の写真に教材の sample.png を登録して公開してください。
weekend-note の中で、package.json と同じ場所に check-local-files.mjs を作ります。この例はファイルの有無を調べ、見つかったPNG画像1枚の配信パスを表示します。
import { existsSync, readdirSync, statSync } from 'node:fs';
const dbFile = './data.db';
const uploads = './uploads';
const hasDb = existsSync(dbFile) && statSync(dbFile).isFile();
const hasUploads = existsSync(uploads) && statSync(uploads).isDirectory();
const photo = hasUploads && readdirSync(uploads, { withFileTypes: true })
.find(file => file.isFile() && file.name.endsWith('.png'));
console.log('記事のDB:', hasDb ? 'あり' : 'なし');
console.log('画像フォルダー:', hasUploads ? 'あり' : 'なし');
console.log('PNGの配信パス:', photo
? '/_emdash/api/media/file/' + encodeURIComponent(photo.name)
: 'PNGなし');Macならターミナル、WindowsならPowerShellで、同じ weekend-note フォルダーから実行します。
node check-local-files.mjs「記事のDB」「画像フォルダー」がともに「あり」なら、指定した場所にファイルとフォルダーが見つかっています。画像未登録なら「PNGなし」と出ます。JPEGを使った場合も、この例の検索対象はPNGだけです。
サイトが起動している状態で、表示された配信パスをローカルサイトのアドレスに続けてブラウザーで開いてください。写真付き一覧の実習なら、http://127.0.0.1:4350 の後ろに貼ります。画像が表示されれば、手元のファイルをEmDash経由で読めています。
写真が表示されないとき
| 見えた結果 | 次に確認すること |
|---|---|
| 記事のDBが「なし」 | コマンドを実行したフォルダーと、実際の sqlite() の設定を確認する |
| DBは「あり」、画像フォルダーは「なし」 | directory の指定と、画像を登録したサイトが同じかを確認する |
| PNGはあるが配信URLを開けない | サイトの起動状態、ポート番号、baseUrl を確認する |
| 配信URLで開けるが記事には出ない | 記事の写真欄にその画像を選んだか、変更を公開したかを確認する |
この表はSQLiteとローカルストレージを組み合わせた場合の例です。CloudflareのD1・R2を使うサイトの保存先はCloudflare公開に必要な構成で確認できます。