ZipArchive 类无法在 PhpStorm 中直接解压 ZIP 包，IDE 仅支持只读预览；推荐通过 External Tools 配置 unzip/7z 命令实现右键一键解压，避免在项目中使用 extractTo() 自动解压上传包以防路径穿越漏洞。
ZipArchive 类不能在 PhpStorm IDE 内部直接解压 ZIP 包——它只是 PHP 运行时的扩展，和编辑器无关。PhpStorm 本身不提供“点击 ZIP 文件 → 解压到项目目录”的内置功能，但有更可靠、更可控的替代路径。
PhpStorm 里双击 ZIP 文件只会预览，不会解压
你看到的 ZIP 文件在项目视图中可展开、可浏览内容，那只是 IDE 的只读预览（类似查看 JAR 或 PHAR）。点开某个文件能看源码，但 extractTo() 不会自动执行，也不会弹出解压对话框。想“直接解压”，得靠外部工具或手动触发 PHP 脚本。
用 External Tools 配置一键解压命令（推荐）
这是最贴近“IDE 内操作”的方案：把系统 unzip 命令封装成 PhpStorm 的右键菜单项，选中 ZIP 文件后一键解压到当前目录。
- 打开 Settings → Tools → External Tools
- 点击
+添加新工具：
– Name:Unzip here
– Program:unzip（macOS/Linux）或7z（Windows，需提前安装 7-Zip 并加入 PATH）
– Arguments:-o $FilePath$ -d $FileDir$
– Working directory:$FileDir$ - 保存后，右键 ZIP 文件 →
External Tools → Unzip here，即刻解压到同级目录
注意：-o 参数强制覆盖，避免交互提示；若担心误覆盖，可改用 -n（跳过已存在文件）。
别在项目里写 extractTo() 脚本自动解压上传包
有人会在项目里放一个 unzip.php，调用 ZipArchive::extractTo() 解压用户上传的 ZIP。这在 IDE 里点运行看似“方便”，但实际极危险：
立即学习“PHP免费学习笔记（深入）”；
-
extractTo()不校验路径，../../etc/passwd会直接写到系统根目录 - 脚本若未限制解压目标路径（如硬编码为
./uploads/），且没做basename()或realpath()校验，就等于给攻击者开了后门 - PHP 进程权限通常高于预期（尤其本地开发用
sudo php -S），一旦路径穿越成功，后果比命令行更严重
真要测试解压逻辑，应把 ZIP 放进 tests/fixtures/，用单元测试驱动，目标路径固定为临时目录（sys_get_temp_dir()），并显式过滤所有含 .. 或开头为 / 的条目。
中文名 ZIP 在 PhpStorm 中显示乱码？不是 IDE 问题
PhpStorm 预览 ZIP 时文件名是乱码，大概率是 ZIP 包本身用 GBK 编码存的中文名，而 IDE 默认按 UTF-8 解析。这不是 PhpStorm 设置能修的——ZIP 规范没强制编码，不同压缩工具行为不一（Windows 压缩软件常用 GBK，macOS 默认 UTF-8）。
解决方式只有两个：
- 用命令行重压一遍：
unzip -l archive.zip看是否乱码，若是，用iconv转文件名再重打包 - 在 PHP 侧处理时，对
getNameIndex()返回的字符串做mb_convert_encoding($name, 'UTF-8', 'GBK')，但前提是确认原始编码
别指望在 PhpStorm 设置里调个“ZIP 编码”就搞定——它没有这个开关。
真正容易被忽略的是：**PhpStorm 的 ZIP 预览和实际解压行为完全脱钩**。你看到的结构，不等于extractTo() 写出来的结构；你双击打开的文件，也不代表它在磁盘上真实可读。一切以 PHP 运行时行为为准，IDE 只是壳。 
