前言
在使用 PHP 依赖管理工具 Composer 时，许多开发者会遇到 “Failed to decode zlib stream” 的致命安装错误。这个问题通常源于系统缺失必要的 zlib 压缩库组件，尤其是在新部署的 Ubuntu 24.04 或 CentOS 7 系统环境中。本文将提供跨发行版的解决方案，涵盖主流的 Ubuntu 18.04-24.04、CentOS Stream 9 及 Rocky Linux 等系统。
什么是 Composer
Composer 在这里不是“作曲家”，而是一款好用的 PHP 依赖管理工具。它以项目的单位，需要的时候，在项目根目录创建 composer.json 文件，并写入 PHP 依赖项及其版本，然后运行 Composer 的相关命令，就可以自动地安装依赖。
安装时出现致命错误
安装 Composer 进行到 php composer-setup.php 这一步时遇到 Failed to decode zlib stream 错误。
Composer 安装错误解决方法
支持 Ubuntu 18.04, 20.04, 22.04, 24.04
在 Ubuntu 18.04+ 中可以通过执行以下命令解决这个问题：
sudo apt install -y zlib1g zlib1g-dev zlibc
如果上方命令中的软件包无法全部安装，从上面移除无法安装的包名，然后再次执行 APT 命令。
其他用 Yum 的操作系统上安装 glibc
在其他用 yum 为软件包管理工具的操作系统上，可以按以下命令安装：
# 如果是非 root 用户，需要在命令前面加上 sudo
yum install -y glibc
上述方案适用于 Ubuntu 18.04，Ubuntu 20.04，Ubuntu 22.04，Ubuntu 24.04，CentOS 7，Rocky Linux 9，Rocky Linux 8，CentOS Stream 9 等操作系统。
总结
“Failed to decode zlib stream” 错误的本质是系统缺少 zlib 或 glibc 等基础库的支持。通过安装对应的软件包（如 Ubuntu 的 zlib1g 系列或 CentOS 的 glibc），可彻底解决这一问题。无论是 Ubuntu 18.04 至 24.04，还是 CentOS Stream 9、Rocky Linux 等系统，均可按文中命令快速修复。若仍遇困难，建议检查系统版本是否匹配，或尝试更新软件源后重试。
鉴于本人的相关知识储备以及能力有限，本博客的观点和描述如有错漏或是有考虑不周到的地方还请多多包涵，欢迎互相探讨，一起学习，共同进步。
本文章可以转载，但是需要说明来源出处!
本文使用的部分图片来源于网上，若是侵权，请与本文作者联系删除： admin@icxzl.com