首页 游戏 软件 资讯 排行榜 专题
首页
编程语言
Composer如何在Linux上安装_Composer Linux安装教程【详解】

Composer如何在Linux上安装_Composer Linux安装教程【详解】

热心网友
39
转载
2026-05-03

必须卸载系统包管理器安装的 Composer,因其版本陈旧、缺乏安全校验、不支持新版 PHP 和依赖解析;应通过校验哈希后的官方脚本安装至 /usr/local/bin,并确保 PHP 扩展、权限、PATH 和 memory_limit 配置正确。

Composer如何在Linux上安装_Composer Linux安装教程【详解】

免费影视、动漫、音乐、游戏、小说资源长期稳定更新! 👉 点此立即查看 👈

这里有个核心建议,请务必记住:别用 apt 或 yum 这类系统包管理器去安装 Composer。你装上的很可能不是一个现代化的工具,而是一个过时的“兼容层”。它连 ^2.5 这样的依赖版本约束都解析不了,更别提对 PHP 8.2+ 新特性的支持了。

为什么 apt install composer 一定得卸掉

系统仓库里的 Composer 版本,往往滞后得令人惊讶。比如 Ubuntu 22.04 LTS 自带的版本是 2.0.14,但到了 22.10 版本,居然又退回到了 1.10.22。至于 CentOS 的 EPEL 仓库,更是长期停留在 1.10.21 这个老古董上。这些陈旧版本会带来一系列连锁问题:

  • 首先,它们不校验包的签名。这意味着你执行 composer install 时下载的依赖包,理论上存在被中间人篡改的风险。
  • 其次,它们会跳过关键的 platform-checkconflict 检查。这会导致依赖看似安装成功,但实际上与你的 PHP 环境或其它包存在隐性冲突,为项目埋下地雷。
  • 再者,self-update 命令在这些版本上基本失效。你无法平滑升级到 2.7+ 的安全版本,也打不上重要的安全补丁。
  • 最头疼的是,它们通常硬编码调用系统默认的 PHP 解释器(比如 CentOS 的 /usr/bin/php)。如果你的项目实际运行在 php8.2 上,就可能莫名其妙地报出 Class ZipArchive not found 这类错误,排查起来相当费劲。

所以,如果你运行 composer --version 看到的是 1.10.x 或任何低于 2.5 的版本,请立刻执行卸载:
在 Ubuntu 上使用 sudo apt remove composer,在 CentOS 上使用 sudo yum remove php-composer。完成后,务必用 which composer 命令确认一下,确保它不再返回 /usr/bin/composer 这个路径。

curl | php 安装时必须校验 sha384 哈希

通过官方脚本安装是正确路径,但这里有个关键步骤绝不能省略:校验安装脚本的哈希值。这个脚本不是“下载即用”那么简单,在传输过程中,内容存在被篡改的可能。如果跳过了校验,那么后续所有通过 Composer 安装的依赖,其可信度都将大打折扣。

正确的步骤应该分步执行(不要图省事合并成一行命令):

  • 第一步,下载安装器:php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
  • 第二步,从官方渠道获取最新的签名哈希:HASH=$(curl -sS https://composer.github.io/installer.sig)
  • 第三步,在本地计算文件的哈希值并进行比对:php -r "if (hash_file('sha384', 'composer-setup.php') === '$HASH') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); }"

只有当你看到 Installer verified 的输出时,才能继续安装。否则,应该立即删除 composer-setup.php 并重新开始。另外需要提醒的是,谨慎使用某些国内镜像站提供的“一键安装脚本”——它们常常将哈希值硬编码在脚本内部,这实际上完全失去了动态校验的意义。

/usr/local/bin/composer 权限和 PATH 必须手动确认

安装完成后,一运行 composer --version 就报 Permission denied?别急着怀疑文件损坏,大概率是权限或环境变量没配置好。

  • 首先,确保文件有可执行权限:sudo chmod +x /usr/local/bin/composer
  • 接着,检查它是否在你的系统 PATH 环境变量中:运行 echo $PATH,看看输出里是否包含 /usr/local/bin。如果没有,需要手动添加:export PATH="/usr/local/bin:$PATH"(记得把这行命令写入 ~/.bashrc 或相应的 shell 配置文件,以实现持久化)。
  • 最后,如果你计划用非 root 用户(例如 www-data 或部署用户 deploy)来运行 Composer,还需要确认文件权限:执行 ls -l /usr/local/bin/composer,其归属应为 root:root,且权限是 -rwxr-xr-x

特别是在使用 Docker 容器或 Alpine、CentOS Stream 这类最小化系统时,/usr/local/bin 很可能不在默认的 PATH 中。如果你发现 which composer 命令返回空,原因就在这里。

PHP 扩展缺失会导致 composer install 静默失败

这是另一个常见的“坑”:Composer 本身能启动,但执行 install 命令时,会卡在 “Loading composer repositories” 这一步,最终只输出一句不痛不痒的 Package operations: 0 installs, 0 updates, 0 removals。其实,这往往是因为缺少了关键的 PHP 扩展,比如 php-zipphp-phar

  • 在 Ubuntu/Debian 系统上,你需要:sudo apt install php-cli php-zip php-json php-mbstring php-xml php-phar
  • 在 CentOS/RHEL 8+ 系统上,则是:sudo dnf install php-cli php-zip php-json php-mbstring php-xml php-phar
  • 安装后,务必检查扩展是否已加载:php -m | grep -E 'zip|phar|xml'
  • 此外,某些严格的安全环境会在 disable_functions 配置里禁用 proc_open 函数,这会导致 composer update 等命令直接退出,且没有任何错误提示,排查起来非常困难。

而最隐蔽的问题,莫过于 memory_limit 内存限制了。Composer 2.7+ 版本在解析大型的 composer.json 文件时,至少需要 1GB 的内存。如果通过 php -i | grep memory_limit 查看到的值小于 1G,那么内存限制就必须调高,否则进程会因内存不足而意外终止。

来源:https://www.php.cn/faq/2324983.html
免责声明: 游乐网为非赢利性网站,所展示的游戏/软件/文章内容均来自于互联网或第三方用户上传分享,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系youleyoucom@outlook.com。

相关攻略

Filebeat如何实现跨平台日志收集
编程语言
Filebeat如何实现跨平台日志收集

Filebeat跨平台日志收集实践指南 一 架构与关键点 面对混合IT环境,如何用一套工具搞定所有主机的日志收集?Filebeat给出了答案。它提供了覆盖Linux、Windows和macOS的安装包,这意味着,你只需要维护同一套简洁的YAML配置,就能在不同操作系统上实现统一的日志采集与输出。其轻

热心网友
05.03
Filebeat如何进行日志压缩与归档
编程语言
Filebeat如何进行日志压缩与归档

Filebeat日志压缩与归档实践 说到日志管理,很多朋友会问:Filebeat本身能搞定日志的本地压缩和长期归档吗?答案是,这事儿得分两头看。Filebeat的核心任务是采集和转发,它并不包办所有存储和归档的活儿。一个典型的实践方案是:本地用系统工具处理Filebeat自己的日志,防止磁盘爆满;远

热心网友
05.03
如何利用Filebeat进行故障排查
编程语言
如何利用Filebeat进行故障排查

Filebeat故障排查实操手册 日志采集管道卡住了?数据流突然中断?别慌,这往往是Filebeat在“报警”。作为数据管道的第一公里,它的稳定至关重要。下面这份实操指南,能帮你像老手一样,快速定位并解决大多数常见问题。 一、快速定位流程 遇到问题,按这个顺序走一遍,十有八九能找到症结所在。 确认服

热心网友
05.03
如何自定义Filebeat日志格式
编程语言
如何自定义Filebeat日志格式

Filebeat日志格式自定义指南 一 概念澄清 在动手配置之前,先得把两个容易混淆的概念理清楚: Filebeat自身运行日志:这指的是Filebeat这个“搬运工”自己工作时产生的日志,比如它有没有正常启动、遇到了什么错误。这类日志通常输出到磁盘文件或控制台,方便运维人员排错。你可以选择让它以纯

热心网友
05.03
HDFS快照如何使用
编程语言
HDFS快照如何使用

HDFS 快照使用指南 说到数据备份与恢复,HDFS快照绝对是一个高效且轻量的利器。它本质上就是文件系统在某个特定时刻的“只读照片”,专门用于应对误操作或进行历史状态对比。那么,它到底是怎么工作的?简单来说,有以下几个核心特性: 一 核心概念与适用场景 首先,HDFS快照的创建几乎是瞬间完成的,时间

热心网友
05.03

最新APP

宝宝过生日
宝宝过生日
应用辅助 04-07
台球世界
台球世界
体育竞技 04-07
解绳子
解绳子
休闲益智 04-07
骑兵冲突
骑兵冲突
棋牌策略 04-07
三国真龙传
三国真龙传
角色扮演 04-07

热门推荐

Composer如何配置自定义的类加载路径_在 autoload 的 files 字段定义【进阶】
编程语言
Composer如何配置自定义的类加载路径_在 autoload 的 files 字段定义【进阶】

Composer如何配置自定义的类加载路径_在 autoload 的 files 字段定义【进阶】 为什么加了 files 还是报 Call to undefined function 遇到这个问题,十有八九是源头就出了问题:入口文件压根没引入 vendor autoload php,或者引入的位置

热心网友
05.03
怎么用VSCode开发Electron程序-主进程与调试工具关联方法
编程语言
怎么用VSCode开发Electron程序-主进程与调试工具关联方法

VSCode 调试 Electron 主进程:告别“断点失效”,回归 Node js 本质 调试 Electron 主进程,核心思路其实很简单:把它当作一个特殊的 Node js 进程来对待。 关键在于,别再执着于 VSCode 里那个名为 “electron” 的调试类型,而是用 type: "n

热心网友
05.03
git回退到指定版本的操作步骤【详解】
编程语言
git回退到指定版本的操作步骤【详解】

git回退到指定版本的操作步骤【详解】 开门见山,先说结论:想把代码回退到某个特定版本,git reset --hard 无疑是速度最快、效果最彻底的方法。但请注意,这个“大招”有明确的适用范围:仅限于你的改动还没推送到远程仓库,或者你拥有强制覆盖远程分支的权限。一旦代码已经合入了团队共享的主干分支

热心网友
05.03
Atom编辑器有哪些必装插件_Atom编辑器常用插件推荐教程【经典】
编程语言
Atom编辑器有哪些必装插件_Atom编辑器常用插件推荐教程【经典】

Atom已停止维护,apm官方源失效,需改用社区镜像源(如https: apm atom io cn)或手动下载GitHub包安装;仍可用插件需满足不联网、不调API、无后端依赖等条件。 Atom编辑器在2022年底就正式告别了官方维护,这已经是公开的事实。但话说回来,它并没有从我们的硬盘里消失。

热心网友
05.03
Composer如何配置脚本仅在特定条件执行_Composer脚本特定条件执行配置大全
编程语言
Composer如何配置脚本仅在特定条件执行_Composer脚本特定条件执行配置大全

Composer脚本无法原生支持条件判断,因scripts字段仅将字符串交由系统shell执行,而CI中环境变量未导出、Windows语法不兼容、autoload未加载等问题导致if语句失败;应改用PHP回调函数显式检测环境变量并控制流程。 先说一个核心结论:Composer脚本本身不具备原生的条件

热心网友
05.03