PHP Ziparchiveユーザーガイド：安全で信頼できるファイルパッケージングプラクティス

M66 2025-09-16

PHP Ziparchive Extensionの紹介

PHP Ziparchive Extensionは、PHPでZIPファイルを操作する機能を開発者に提供します。プロジェクトが安全で信頼性が高いことを確認するには、予期しないエラーやセキュリティリスクを避けるために、一部のベストプラクティスに従う必要があります。

アーカイブの整合性チェックを有効にします

Ziparchiveは、デフォルトでZIPファイルの整合性を確認せず、悪意のあるファイルが抽出または上書きされた悪意のあるファイルにつながる可能性があります。セーフモードは、次の方法で有効にできます。

 <span class="fun">$ zip-> open（ "archive.zip"、ziparchive :: create | ziparchive :: overwrite | ziparchive :: checkcons）;</span>

ファイルとディレクトリのアクセスを制限します

デフォルトでは、Ziparchiveを使用すると、ファイルまたはディレクトリにアクセスできます。セキュリティを高めるために、パッケージ化するファイルとディレクトリを指定できます。

 $zip->setArchiveComment("安全なアーカイブ");
$zip->addFromPath("files/important.txt");

アーカイブの完全性を確認します

抽出する前に破損したファイルが抽出されないようにアーカイブの整合性を確認してください。

 if ($zip->statusSys === ZIPARCHIVE::ER_OK) {
    // 完全にアーカイブされています，抽出できます
} else {
    // アーカイブが破損しています，撤退を拒否します
}

パスワード保護を使用します

パスワード保護は、機密データを含むアーカイブに使用する必要があります。

 <span class="fun">$ zip-> setPassword（ "I&#39;m Safe"）;</span>

ファイルサイズ制限

悪意のあるアップロードまたは特大ファイルを防ぐために、単一のファイルまたはアーカイブ全体の最大ファイルサイズを設定します。

 <span class="fun">$ zip-> setMaxsize（1024000）; // 1MBに制限します</span>

シンボリックリンクを処理します

デフォルトでは、Ziparchiveはシンボリックリンクに従いません。次の方法を使用できます。

 <span class="fun">$ zip-> setexternalattributesname（ "sym.link"、ziparchive :: opsys_unix、ziparchive :: opsys_unix_symlink）;</span>

一時的なディレクトリを使用してください

アーカイブを作成または抽出するときは、サーバー上に不要なファイルを作成しないように一時的なディレクトリを使用することをお勧めします。

 <span class="fun">$ zip-> setempdir（sys_get_temp_dir（））;</span>

無料のリソース

操作を完了した後、Ziparchiveオブジェクトと関連するリソースは、リソースの漏れを防ぐためにclose（）メソッドを使用してリリースする必要があります。

 <span class="fun">$ zip-> close（）;</span>

エラー処理

Ziparchiveを使用するプロセス中にエラーが発生する場合があります。 getStatstring（）を介してエラー情報を取得し、それを処理できます。

 if ($zip->getStatusString() === ZIPARCHIVE::ER_INCONS) {
    // アーカイブは一貫性がありません，操作を拒否します
}

テストと記録

生産環境でZiparchiveを使用する前に、コードを完全にテストし、セキュリティ、信頼性、パフォーマンスを検証し、チームが理解できるように実装を詳細に記録する必要があります。

例：安全で信頼性の高いパッケージ

次の例は、Ziparchiveを使用してベストプラクティスによってファイルをパッケージ化する方法を示しています。

 <?PHP
$zip = new ZipArchive();
$zip->open("archive.zip", ZipArchive::CREATE | ZipArchive::OVERWRITE | ZipArchive::CHECKCONS);
$zip->setArchiveComment("安全なアーカイブ");
$zip->addFromPath("files/important.txt");
$zip->setExternalAttributesName("sym.link", ZipArchive::OPSYS_UNIX, ZipArchive::OPSYS_UNIX_SYMLINK);
$zip->setMaxSize(1024000);
$zip->setTempDir(sys_get_temp_dir());
$zip->close();
?>

要約します

これらのベストプラクティスに従って、開発者はPHP Ziparchiveを使用して、安全で信頼できるパッケージングとデータの抽出を拡張し、セキュリティの脆弱性、データ損失、パフォーマンスの問題を効果的に防止できます。