ダウンロードヘルパー¶
ダウンロードヘルパーを使うと、データをデスクトップにダウンロードさせることができます。
利用できる機能¶
次の関数が利用できます:
- force_download([$filename = ''[, $data = ''[, $set_mime = FALSE]]])¶
パラメータ: - $filename (string) – ファイル名
- $data (mixed) – ファイルのデータ
- $set_mime (bool) – 実際の MIME タイプを送信するかどうか
返り値の型: void
データを強制的にデスクトップにダウンロードさせるためのサーバヘッダを 生成します。 ファイルのダウンロードで使えます。 第1引数には、ダウンロードファイルにつけたい名前を指定し、第2引数には、 ファイルのデータを指定します。
第2引数に NULL を設定している場合、 $filename が読込み可能であれば、ファイルのデータを 読み出します。
第3引数に TRUE を設定した場合、指定したファイルの MIME タイプ(ファイル名の拡張子が指すものになります)が送信され、 ブラウザはそのタイプのハンドラを使用します。
例:
$data = 'Here is some text!'; $name = 'mytext.txt'; force_download($name, $data);
サーバに存在するファイルをダウンロードさせたい場合は次のようにする 必要があります。:
// photo.jpg のデータは自動的に読み出されます force_download('/path/to/photo.jpg', NULL);