PHP 中使用 ZipArchive 解压文件时，若未检查 open() 返回值就直接调用 extractTo() 或 close()，会导致“Invalid or uninitialized Zip object”错误；关键在于 open() 必须成功返回 TRUE，而非忽略错误码（如 19 表示 ZIP_OPEN_FAILED）。
php 中使用 ziparchive 解压文件时，若未检查 `open()` 返回值就直接调用 `extractto()` 或 `close()`，会导致“invalid or uninitialized zip object”错误；关键在于 `open()` 必须成功返回 `true`，而非忽略错误码（如 19 表示 zip_open_failed）。
在您提供的代码中，核心问题有三处：
错误地使用了
ZipArchive::CREATE模式：该模式用于创建新 ZIP 文件，而非打开已有 ZIP 进行读取或解压。对只读解压操作，应使用ZipArchive::RDONLY（默认可省略），或至少避免CREATE—— 否则open()会尝试以写入模式打开一个已存在的 ZIP，失败并返回错误码（如19 = ZIP_OPEN_FAILED），但您未做判断便继续调用方法，导致后续所有操作均作用于未初始化对象。未校验
open()的返回值：ZipArchive::open()不返回布尔值true/false，而是返回整型状态码（如ZIPARCHIVE::ER_OK = 0表示成功，19表示无法打开文件）。直接用$res === TRUE判断是无效的；必须显式对比=== ZIPArchive::ER_OK或检查是否为0。-
路径与权限隐患：尽管您确认路径正确，但 WordPress 环境下需确保：
立即学习“PHP免费学习笔记（深入）”；
-
$extract_path/archive.zip文件真实存在且 PHP 进程有读取权限； -
$previews_path目录存在、可写，且路径末尾不带斜杠（extractTo()会自动处理）； - 使用绝对路径更可靠（推荐
realpath()或ABSPATH+trailingslashit()组合）。
-
✅ 正确用法如下（含错误处理与健壮性增强）：
$zip = new ZipArchive();
$archivePath = $extract_path . '/archive.zip';
$targetDir = $previews_path;
// 1. 使用只读模式打开（默认即 RDONLY，无需显式传参）
$res = $zip->open($archivePath);
if ($res !== ZIPArchive::ER_OK) {
throw new RuntimeException("Failed to open ZIP archive: " . ziparchive_error_message($res));
}
// 2. 确保目标目录存在且可写
if (!is_dir($targetDir)) {
if (!mkdir($targetDir, 0755, true)) {
throw new RuntimeException("Cannot create extraction directory: $targetDir");
}
}
if (!is_writable($targetDir)) {
throw new RuntimeException("Extraction directory is not writable: $targetDir");
}
// 3. 安全解压（可选：限制解压范围防路径遍历）
$zip->extractTo($targetDir);
$zip->close();
echo "Extraction completed successfully.";? 补充说明：
-
ziparchive_error_message()是辅助函数（PHP ≥ 8.0 内置，旧版本可手动映射错误码，如19 => 'Can\'t open file'）； - 若需防止 ZIP 中恶意路径（如
../../../etc/passwd），应在extractTo()前遍历文件并过滤非法路径，或使用ZipArchive::getFromName()配合白名单校验； - 在 WordPress 中，建议用
wp_mkdir_p($targetDir)替代原生mkdir()，兼容多层目录创建。
总结：ZipArchive 是强状态对象，一切操作前必须确保 open() 成功；永远不要跳过返回值校验，这是避免“uninitialized Zip object”错误的唯一可靠方式。
