MAMP環境下での日本語名ファイルのパス切れ現象と復元検証

このエントリーは、a-blog cms Advent Calendar 2025 の10日目の記事です。

a-blog cmsの仮想環境構築にMAMPをご利用の方は多くいらっしゃるのではないでしょうか。Dockerと比較して、インストールするだけで簡単に開発を始められるので、大変便利なツールですが、不具合が発生することもあるため、注意が必要です。

私が経験した不具合について、皆様にご報告させていただきます。

ある日、a-blog cmsで制作したホームページをMAMP環境へ移行した際、写真データが欠落した状態でリストアされました。当初、リストア作業中に不具合が発生したと考えていましたが、アップルップルの宇井さんより「MAMP環境下では日本語名のファイルがパス切れする現象が発生している」とのご指摘を受け、納得できました。

MAMP環境において、テストエントリーとして日本語名の写真ファイルと英語名の写真ファイルをアップロードして保存すると、表側（出力側）では日本語名の写真ファイルはリンクが外れて反映されていませんでした。作成時においては、アップロードした日本語名ファイルの図柄は小さく、英語名ファイルの図柄は大きく表示されていました。

試しに18,278 バイト（ディスク上の20 KB）の鳥のイラストを日本語名と英語名でそれぞれアップロードしてみると、リンク切れを起こさずに正しく反映されたため、イラストではリンク切れを起こさず、写真ではリンク切れを起こすのかとも考えましたが、アップロードするファイルサイズにも影響があるかも知れません。

MAMP環境下でリンク切れが発生している状態でリストアされたサイトのmediaフォルダーとarchivesフォルダーには、写真とイラストデータが適切に保存されていましたが、その環境下でのサイトをバックアップして、それをレンタルサーバーに構築したa-blog cmsのサイトにリストアすると、果たして正しく反映されるだろうか？　そのことを検証してみました。

実際にレンタルサーバー上で構築した新たなサイトに、MAMP環境下でリンク切れを起こしているサイトのバックアップしたファイルでリストアしたところ、リンク切れを起こさずに正しくリストアできていることを確認しました。

したがって、MAMP環境下でリンク切れが発生した状態で復元されたサイトであっても、本番環境では正しく復元できるため、リンク切れが発生したファイルについては特に気にしなくても、そのまま復元した仮想環境下で作業を進めても問題ないことが確認されました。

以上、簡単ではございますが、参考にして頂けたら幸いです。

※ MAMP環境下で構築したサイトのa-blog cmsのバージョンは3.1.61です。
※ MAMPのバージョンは7.2で、PHPは8.3.14で設定した状態での検証結果です。

明日の「a-blog cms Advent Calendar 2025」11日目は、三ツ石皓太郎さんです。

////////////////////////////////////////////////////////////////
MAMPに関する他の不具合に関しては

こちら

////////////////////////////////////////////////////////////////

投稿：2025年12月10日
安藤秀樹