メモ用紙

Content-Disposition ヘッダを使って日本語のファイル名でダウンロードさせる

ブラウザに次のような HTTP レスポンスヘッダを出力すると、任意のファイル名で出力内容をダウンロードさせることができる。

Accept-Ranges: bytes
Content-Type: application/octet-stream
Content-Disposition: attachment; filename=ファイル名
Content-Length: ファイルサイズ

問題はファイル名が日本語の文字など、ASCII 以外の文字を含む場合である。ASCII 以外の文字をエンコードする方法はさまざまあり、ブラウザによって対応がまちまちである。

そこで次の PHP コードを用いてテストを行った。

• download_test.php

手元の環境でテストした結果はこちら。

比較的最近のブラウザでは RFC 2231 形式に対応しているので、通常はこの形式を使えば問題は少ないだろう。

また古いブラウザでは、Shift_JIS で表現できる文字列の場合、Shift_JIS 文字列をそのまま記述すれば正しい結果が得られる。

PHP でのコード例

以上を踏まえてコードを記述すると、次のようになる。

<?php
header('Accept-Ranges: bytes');
header('Content-Type: application/octet-stream');
if (preg_match('/\bMSIE\b|\bSafari [12345]\b/', getenv('HTTP_USER_AGENT'))) {
	header('Content-Disposition: attachment; filename="' .
		mb_convert_encoding($filename, 'Shift_JIS', 'UTF-8') . '"');
}
else {
	header('Content-Disposition: attachment; filename*=UTF-8\'\'' . rawurlencode($filename));
}
header('Content-Length: ' . filesize($file));
readfile($file);

注意点

ユーザの環境においてファイル名として使えない文字を指定したとき、その動作はブラウザによって異なる。次のページに書かれているようにエスケープするとよい。

• はっぴぃ・りなっくす - 日本語ファイル名でダウンロードする (コード) - Tools > PHP - SmartSection

<?php
$filename = preg_replace('/\\xE2\\x80\\xAE|\\xE2\\x80\\xAD/', '', $filename);
$filename = preg_replace('/\\s/u', '_', $filename);
$filename = preg_replace('{[\\\\/:*?"<>|]}', '', $filename);

ツイートする

Permalink | コメント(0) | トラックバック(0)