需启用PHP zlib扩展：先用php -m验证是否加载，未启用则在CLI对应的php.ini中取消extension=zlib（PHP≥8.0）或extension=zlib.so（旧版）注释；Linux/macOS检查ext目录是否存在zlib.so，缺失则安装php-zlib（Debian）或php-zlib（RHEL）或重装Homebrew PHP；Windows确认php/ext/下有php_zlib.dll并取消php.ini中对应行注释，修改后重启终端。

Composer 报错 zlib extension is missing 怎么办

直接原因很明确：PHP 运行时没加载 zlib 扩展，而 Composer 在下载包、解压 .tar.gz 或 .zip 时强依赖它。不装这个扩展，composer install、composer create-project 都会卡在“failed to open stream: operation failed”或直接报 zlib extension is missing。

确认 PHP 是否真的没启用 zlib

别急着改配置，先验证问题是否出在这里：

• 运行 php -m | grep zlib，无输出即未启用
• 运行 php -i | grep "zlib version"，有结果说明已加载；没结果或报错说明缺失
• 注意：CLI 和 Web（如 Apache/Nginx）可能用不同 php.ini，composer 走的是 CLI SAPI，所以只看 php -i 输出的 Loaded Configuration File 对应的那个 php.ini

Linux/macOS 下启用 zlib 的常见路径

绝大多数现代 PHP 发行版（包括 apt/yum/brew 安装的）默认编译了 zlib 支持，只是扩展未启用。操作分两步：

• 检查 ext/zlib.so 是否存在：php -r "echo ini_get('extension_dir');"，然后 ls $(php -r "echo ini_get('extension_dir');")/zlib.so
• 若存在，在 php.ini 中取消注释：extension=zlib（PHP ≥ 8.0）或 extension=zlib.so（旧版本）
• 如果 zlib.so 找不到，说明 PHP 编译时没带 --with-zlib。Ubuntu/Debian 用户补装：sudo apt install php-zip（该包会连带拉取 zlib 依赖）；CentOS/RHEL：sudo yum install php-zlib 或 dnf install php-zlib
• macOS + Homebrew 用户：brew install php@8.2（或其他版本）会自动包含 zlib；若单独编译过 PHP，请确保 configure 时加了 --with-zlib=/usr（macOS 系统 zlib 路径）

Windows 下 php.ini 修改要点

Windows 用户常因路径和扩展名混淆出错：

• 打开 php.ini（通过 php --ini 确认位置），搜索 php_zlib.dll
• 取消注释这一行：extension=php_zlib.dll（PHP 7.x）或 extension=zlib（PHP 8.0+）
• 确保 php_zlib.dll 文件真实存在于 php/ext/ 目录下；若缺失，说明安装包不完整，建议重下官方线程安全（TS）版 ZIP 包
• 修改后必须重启命令行终端（CMD/PowerShell），否则 php -v 仍读缓存配置

php -m | grep zlib
# 正常应输出：zlib

zlib 不是可选功能，它是 Composer 解包逻辑的底层依赖，哪怕你只装纯 PHP 包（不含二进制），也会在 vendor 压缩流校验阶段触发。漏掉这一步，后续所有依赖操作都不可靠。

# php  # linux  # centos  # composer  # windows  # apache  # nginx  # ubuntu  # mac  # ai  # echo  # 线程  # macos  # debian  # 加载  # 报错  # 重启  # 是否存在  # 的是  # 都不  # 找不到  # 会在  # 它是  # 扩展名 

相关栏目： 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571 】

相关推荐： laravel怎么在请求结束后执行任务（Terminable Middleware）_laravel Terminable Middleware请求结束任务执行方法  Win11怎么设置默认图片查看器_Windows11照片应用关联设置  Laravel如何使用Contracts（契约）进行编程_Laravel契约接口与依赖反转  html文件怎么打开证书错误_https协议的html打开提示不安全【指南】  Android自定义控件实现温度旋转按钮效果  Swift中swift中的switch 语句  Laravel怎么发送邮件_Laravel Mail类SMTP配置教程  如何在Windows 2008云服务器安全搭建网站？  如何快速搭建高效可靠的建站解决方案？  作用域操作符会触发自动加载吗_php类自动加载机制与::调用【教程】  佛山企业网站制作公司有哪些,沟通100网上服务官网？  宙斯浏览器怎么屏蔽图片浏览 节省手机流量使用设置方法  Linux后台任务运行方法_nohup与&使用技巧【技巧】  大连企业网站制作公司,大连2025企业社保缴费网上缴费流程？  如何用PHP快速搭建CMS系统？  用yum安装MySQLdb模块的步骤方法  昵图网官方站入口 昵图网素材图库官网入口  MySQL查询结果复制到新表的方法(更新、插入)  如何快速生成凡客建站的专业级图册？  矢量图网站制作软件,用千图网的一张矢量图做公司app首页，该网站并未说明版权等问题，这样做算不算侵权？应该如何解决？  怎么用AI帮你设计一套个性化的手机App图标？  如何快速上传自定义模板至建站之星？  悟空识字怎么关闭自动续费_悟空识字取消会员自动扣费步骤  javascript基本数据类型及类型检测常用方法小结  Laravel如何获取当前用户信息_Laravel Auth门面获取用户ID  标题：Vue + Vuex 项目中正确使用 JWT 进行身份认证的实践指南  电视网站制作tvbox接口,云海电视怎样自定义添加电视源？  Edge浏览器怎么启用睡眠标签页_节省电脑内存占用优化技巧  如何快速使用云服务器搭建个人网站？  高端网站建设与定制开发一站式解决方案 中企动力  谷歌Google入口永久地址_Google搜索引擎官网首页永久入口  html5audio标签播放结束怎么触发事件_onended回调方法【教程】  Laravel如何实现邮件验证激活账户_Laravel内置MustVerifyEmail接口配置【步骤】  怎样使用JSON进行数据交换_它有什么限制  如何在VPS电脑上快速搭建网站？  大学网站设计制作软件有哪些,如何将网站制作成自己app？  iOS中将个别页面强制横屏其他页面竖屏  关于BootStrap modal 在IOS9中不能弹出的解决方法(IOS 9 bootstrap modal ios 9 noticework)  如何在宝塔面板创建新站点？  如何用ChatGPT准备面试 模拟面试问答与职场话术练习教程  猎豹浏览器开发者工具怎么打开 猎豹浏览器F12调试工具使用【前端必备】  西安专业网站制作公司有哪些,陕西省建行官方网站？  Laravel如何实现多对多模型关联？（Eloquent教程）  详解jQuery停止动画——stop()方法的使用  历史网站制作软件,华为如何找回被删除的网站？  使用PHP下载CSS文件中的所有图片【几行代码即可实现】  网站制作报价单模板图片,小松挖机官方网站报价？  Laravel如何配置中间件Middleware_Laravel自定义中间件拦截请求与权限校验【步骤】  Laravel如何实现登录错误次数限制_Laravel自带LoginThrottles限流配置【方法】  html如何与html链接_实现多个HTML页面互相链接【互相】