All posts

WordPress にアップロードしたテキストファイルが文字化けしたときの対処

WordPress で運用しているサイトにテキストファイルをアップロードし、リンクから開いたところ、日本語が文字化けして表示されました。

リンクの HTML を変更すると、Windows の Chrome では文字化けが解消しました。しかし、iPhone では引き続き文字化けします。調べてみると、テキストファイルを返す際の HTTP ヘッダーに原因がありました。

a タグを変更してみた

最初は、リンクの設定で対処できないかと考え、次のように書き換えました。

<a href="xxxxxxxx" download="●●.txt" charset="utf-8" hreflang="ja">ダウンロード</a>

この変更後、Windows の Chrome では文字化けが解消しました。ただ、iPhone では同じファイルを開くと文字化けしたままです。

hreflang はリンク先の言語を示す属性です。リンク先ファイルの文字コードは、ファイルを返すときの HTTP ヘッダーも確認する必要がありそうです。[MDN の hreflang の説明]

レスポンスヘッダーを確認する

Chrome のデベロッパーツールでテキストファイルのレスポンスを確認したところ、Content-Type ヘッダーに次の指定がありました。

charset=iso-8859-1

テキストファイルは UTF-8 で保存していたため、実際の文字コードとヘッダーの指定が一致していません。これが文字化けの原因だと考えました。

Apache の設定を変更する

今回のサーバーは Apache を使用しており、.htaccess を編集できる環境でした。そこで、次の設定を追記しました。

<Files ~ "\.txt$">
    AddType "text/plain; charset=utf-8" .txt
</Files>

この設定で、対象の .txt ファイルに対して、レスポンスの文字コードを UTF-8 として指定します。

設定後にテキストファイルを開いて確認したところ、文字化けが解消しました。

.htaccess が適用されるかどうかは Apache 側の設定によって変わります。また、この設定はファイル自体の文字コードを変換するものではないため、対象のテキストファイルも UTF-8 で保存しておく必要があります。[Apache の mod_mime ドキュメント]

Discussion