WordPressからの移行 Astro EmDash TypeScript リダイレクト

WordPressからEmDashへ移すと、画像のURLは/wp-content/uploads/2026/07/foo.pngから/_emdash/api/media/file/〜に変わります。Google画像検索・SNSのOGP・ほかのサイトからの直リンクがリンク切れにならないように、旧URLから新URLへ301で転送するページを、Astro側に1つ追加します。

本文の画像は置き換わるが、外からの参照は残る

WXRの取り込みでは、EmDashが元のサイトから画像をダウンロードし、本文中の画像URLも新しいURLに置き換えます。サイト内の画像は、取り込むだけで正しく表示されます。

困るのは、サイトの外に残っている旧URLです。EmDashにもリダイレクトを登録する機能がありますが、.pngのような拡張子付きのパスは処理の対象から外しています(ソースコードのコメントにそう書かれています)。そのため、Astroのページで転送します。

ファイル名で画像を探して転送する

取り込んだ画像は保存時のファイル名が付け直されますが、元のファイル名はmediaテーブルのfilenameに残ります。src/pages/wp-content/uploads/[...path].tsを作り、ファイル名で画像を探して転送します。

import type { APIRoute } from "astro";
import { MediaRepository } from "emdash";
import { getDb } from "emdash/runtime";

export const GET: APIRoute = async ({ params, redirect }) => {
	const filename = params.path?.split("/").pop();
	if (!filename) return new Response("Not found", { status: 404 });

	const media = new MediaRepository(await getDb());

	// 完全一致 → サイズ違いの接尾辞を外した名前、の順に探す
	const original = filename.replace(/-(\d+x\d+|scaled)(?=\.[a-z0-9]+$)/i, "");
	for (const name of new Set([filename, original])) {
		const item = await media.findByFilename(name);
		if (item?.storageKey) {
			return redirect(`/_emdash/api/media/file/${item.storageKey}`, 301);
		}
	}

	return new Response("Not found", { status: 404 });
};

WordPressが自動で作るサイズ違いの画像(foo-300x158.pngやfoo-scaled.png)はEmDashに取り込まれないので、接尾辞を外して元の画像へ転送します。

Astro.locals.emdash.dbは使わない

最初はAstro.locals.emdash.dbから画像を探しましたが、すべて404になりました。EmDashは、ログインしていない公開アクセスにはlocals.emdash.dbを渡しません。画像の旧URLを開くのはログインしていない人なので、emdash/runtimeのgetDb()を使います。

ソースコードを読むと、ログインしている時はlocals.emdashに多くの機能が渡される作りになっていて、公開アクセスとは中身が違います。動作の確認は、管理画面にログインしていないブラウザかcurlで行います。

同じファイル名の画像がある時は使えない

この方法は、年月のフォルダを見ずにファイル名だけで探します。WordPressでは別の月に同じファイル名の画像をアップロードできるので、取り込む前に、ファイル名の重複がないか確かめておきます。試したサイトでは66枚すべてファイル名が別々だったので、このまま使えました。