PHPでzipファイルのダウンロードがうまくできません(文字化けがブラウザ上で表示される)

Question

前提・実現したいこと

ダウンロードボタンを押すとzipファイルを作成してダウンロード出来るようにしたいです。

下記のコードだとzipファイル作成までは出来たのですが、その後にダウンロードが始まることはなくブラウザ上にzipの中身が文字化けして表示されるだけで何も動作しません。作成できたzipファイルを直接ダウンロードして解凍してみたのですが問題なく解凍できました。なのでダウンロード周りのコードが間違っているのかもしれません。

該当のソースコード

<?php
$test_file = __DIR__ . '/../../../uploads/txt/test.txt';

if (isset($_POST['downloadbutton'])) {
    $zip = new ZipArchive();
    $zipFileName = get_the_ID() . '.zip';
    $zipTmpDir = __DIR__ . '/../../../uploads/zip/';
    $result = $zip->open($zipTmpDir.$zipFileName, ZIPARCHIVE::CREATE | ZIPARCHIVE::OVERWRITE);
        
    if ($result === true) {
        set_time_limit(0);
        $zip->addFile($test_file, 'test.txt');
        $zip->close();

        header('Content-type: application/zip');
        header('X-Content-Type-Options: nosniff');
        header('Content-Length: '.filesize($zipTmpDir.$zipFileName));
        header('Content-Disposition: attachment; filename="'.$zipFileName.'"');
        header('Connection: close');
        while (ob_get_level()) { ob_end_clean(); }
        readfile($zipTmpDir.$zipFileName);
    }
    unlink($zipTmpDir.$zipFileName);
    exit;
}
?>

<form id="testdl" method="post">
	<button id="button" type="submit" name="downloadbutton"><p>Download</p></button>
</form>

php.iniに下記を追加することで文字化けがブラウザに表示されなくなり、ダウンロード出来るようになりました。ただこの方法が正しいのか、もしくはただエラーがあるのに無理やりダウンロード出来るようにしているのか分かりません。

output_buffering = on

参考にしたサイト: PHP：Warning: Cannot modify header information - headers already sent by ...の解決策

試したことと結果

• いくつかのサイトを参考にしたのでいらないものを足してしまったか、もしくは引いてしまったのかと思いダウンロード周りのコードを何度も修正したのですが別のエラー（Cannot modify header information - headers already sent）が表示され結局解決できませんでした。

• while (ob_get_level()) { ob_end_clean(); } を　ob_end_clean();　に変更しました。文字化けが表示されるようになりました→ 　PK 8b�Stest.txtPK
  ? 8b�S��test.txtPK
  
  6&

• 上記のコードを別のphpファイルに移しfunctionにして元のファイルからincludeで呼んだんですが同じ文字化けが表示されました。

• mb_output_handler("pass");　と　mb_http_output("pass");　をコメントアウトしてみましたが同じ文字化けが表示されました。

• header('Content-Type: application/zip; name="' . $zipFileName . '"');　をコメントアウトしてheader('Content-type: application/zip');　を追加してみましたが同じ文字化けが表示されました。

• サーバーのファイルパーミッションを確認したんですがダウンロード出来ない原因は見つかりませんでした。

• 私と同じようにzipの中身が文字化けしてブラウザに表示されてダウンロード出来ない方の解決済みの投稿を見つけたんですが（https://teratail.com/questions/279532）その方はCakePHPを使用されているみたいで、その解決策のコードを追加してもエラーが出るだけでした。

追加したコード→ Configure::write('debug', 0);

• unlink($zipTmpDir.$zipFileName);　をコメントアウトし作成されたzipファイルを削除せず、そのzipファイルをhtmlコード　<a href="test.zip" download>download test</a>　でダウンロードしてみたんですが、それは問題なくダウンロードも解凍もできました。

• header('X-Content-Type-Options: nosniff'); を追加しました。

• php.ini に output_buffering = on を追加しました。

• ob_end_clean(); を再び while (ob_get_level()) { ob_end_clean(); } に戻したらダウンロードも解凍もできました。ただiphoneのchromeからだとダウンロードはできても解凍ができません。

補足情報（FW/ツールのバージョンなど）

phpのバージョン: 7.4.25

phpのzipのバージョン
Zip enabled
Zip version 1.15.6
Libzip headers version 1.3.2
Libzip library version 1.3.2

使用しているサーバー: Conoha Wing

使用しているEditer: Visual Studio Code

Wordpressでサイトを作っています

よろしくお願いいたします。

Comments

[AsukaKobayashi]

1/7時点で質問に記載のコードを、
WordPress環境ではない、さくらサーバーにて動かしてみたところ問題なく動作しました。
（$test_file $zipFileName $zipTmpDir の3か所は適宜変更してテストしています）

> 作成できたzipファイルを直接ダウンロードして解凍してみた

とのことですが、
`unlink($zipTmpDir.$zipFileName);` の行を消した状態で
Download ボタンをクリックし、その後

https://example.com/uploads/zip/hoge.zip

というような形で、「作成できたzipファイル」のURLに直接アクセスしたときは
文字化けは発生せず、ファイルのダウンロードができるということでしょうか？

[退会済みユーザー]

AsukaKobayashiさん
テストしていただき有難うございます！
同じコードで問題なく動作したということはコード以外のサーバーか何かの設定のところで問題があるのかもしれませんね...。

「直接ダウンロード」というのは unlink($zipTmpDir.$zipFileName); の部分を一度コメントアウトしてその後にダウンロードボタンをクリックし、Conoha Wingが用意してあるファイルマネージャーで直接上記のコードで指定したサーバー上のフォルダを開き、zipファイルをそのファイルマネージャーからダウンロードしました。

一応その後にphpコードで作成されたzipファイルをHTMLコードだけで　<a href="test.zip" download>download test</a> と記述してダウンロードしてみたんですが、それは問題なくダウンロードも解凍もできました。

Answer 1

追加で質問をしてややこしくなってしまったので、一番の最初の質問の"文字化けが表示されてダウンロード出来ない"のところまでで一度解決にしたいと思います。解決策は下記になります。ご回答をしてくださった皆様本当にありがとうございました！！

コード

<?php
$test_file = __DIR__ . '/../../../uploads/txt/test.txt';

if (isset($_POST['downloadbutton'])) {
    $zip = new ZipArchive();
    $zipFileName = get_the_ID() . '.zip';
    $zipTmpDir = __DIR__ . '/../../../uploads/zip/';
    $result = $zip->open($zipTmpDir.$zipFileName, ZIPARCHIVE::CREATE | ZIPARCHIVE::OVERWRITE);
        
    if ($result === true) {
        set_time_limit(0);
        $zip->addFile($test_file, 'test.txt');
        $zip->close();

        header('Content-type: application/zip');
        header('X-Content-Type-Options: nosniff');
        header('Content-Length: '.filesize($zipTmpDir.$zipFileName));
        header('Content-Disposition: attachment; filename="'.$zipFileName.'"');
        header('Connection: close');
        while (ob_get_level()) { ob_end_clean(); }
        readfile($zipTmpDir.$zipFileName);
    }
    unlink($zipTmpDir.$zipFileName);
    exit;
}
?>

<form id="testdl" method="post">
	<button id="button" type="submit" name="downloadbutton"><p>Download</p></button>
</form>

解決策

php.iniに下記を追加することで文字化けがブラウザに表示されなくなり、ダウンロード出来るようになりました。ただこの方法が正しいのか、もしくはただエラーがあるのに無理やりダウンロード出来るようにしているのか分かりません。

output_buffering = on

参考にしたサイト: PHP：Warning: Cannot modify header information - headers already sent by ...の解決策

Answer 2

質問に記載のコードを
WordPress環境ではない、さくらサーバーにて動かしてみたところ問題なく動作してしまったため
（ファイルのパスやWordPress固有の部分は変更／Win10 Google Chromeにて確認）
下記が有効かわかりませんが、対応のアイディアをいくつか回答させてください。

ダウンロード用のコードを修正してみる案

header('Content-type: application/zip');

の下に

//-- ウェブブラウザが独自にMIMEタイプを判断する処理を抑止する
header('X-Content-Type-Options: nosniff');

を追加してみるのはいかがでしょうか？

参考：【PHP】正しいダウンロード処理の書き方

WordPressのデバッグモードの切り替えしてみる案

私と同じようにzipの中身が文字化けしてブラウザに表示されてダウンロード出来ない方の解決済みの投稿を見つけたんですが（https://teratail.com/questions/279532）その方はCakePHPを使用されているみたいで、その解決策のコードを追加してもエラーが出るだけでした。

こちらは「デバッグモードをOFFにする」という解決方法とのことなので、
WordPressのデバッグモードをONまたはOFFに切り替えてみるのはいかがでしょうか？

wp-config.php に記載の
define('WP_DEBUG', false); または efine('WP_DEBUG', true); を
trueからfalseまたは、falseからtrueに変更することで変化が起きるかご確認いただくとよいかもしれません。

参考：WordPressのデバッグモード

Comments

[退会済みユーザー]

ご回答ありがとうございます。

両方試させていただきましたが同じ文字化けの画面が表示されました。

wordpressにデバッグモードの機能があることを知りませんでした！上記のコードとは違うところでundefined variableを見つけることができました。ありがとうございます！

Answer 3

ここをこのように変えてどうなるか試してみてください。何も表示されていないのはphp.iniでエラー制御をオフにしているため、なにか重大なエラーが見えていないだけの可能性が高いです。

 while (ob_get_level()) { ob_end_clean(); }

↓

ob_end_clean();

Comments

[退会済みユーザー]

ご回答ありがとうございます！
ob_end_clean();　に変更してみました。

ダウンロードボタンを押した後に下記のような文字化けが表示されるようになりました。

PK 8b�Stest.txtPK
? 8b�S��test.txtPK

6&

[FKM]

ブラウザに表示されているのでしょうか？

[退会済みユーザー]

はいchromeのブラウザに表示せれています。

[FKM]

それが表示されているということは、どこかでその値をechoやvar_dumpなどをしている可能性があります。その部分をコメントアウトしましょう。
header命令前にそれをやると、エラーが起きますので。

[退会済みユーザー]

header命令前に文字化け部分が表示するようなechoやvar_dumpは見つけられなかったです。
上記のコードの上にはワードプレスの記事を表示するコードを一緒に同じファイルに書いていたのですが、それらが何か影響してるのかと思い上記のzipファイルの作成からダウンロードまでのコードを別のphpファイルに移してfunctionにして元のファイルから呼ぶようにしてみたのですが結果は同じで全く同じ文字化けが表示されまいた。

[FKM]

mb_output_handler("pass");
mb_http_output("pass");
ここも変な気がします。ここは対象エンコードを表記するものなので。

[phper.k]

header('Content-type: application/zip');
を追加すればいけそう

[退会済みユーザー]

返信遅れてすみません！
FKMさん
その二つのコードをコメントアウトしてみたんですが結果は同じで文字化けが表示されました。

phper.kさん
header('Content-Type: application/zip; name="' . $zipFileName . '"');　の部分をコメントアウトして　header('Content-type: application/zip');　を追加してみたのですが変わりはなく文字化けが表示されました。