0

0

Composer怎么在Ubuntu上配置全域变量_Linux安装Composer详细过程【介绍】

裘德小鎮的故事

裘德小鎮的故事

发布时间:2026-02-08 15:56:03

|

778人浏览过

|

来源于php中文网

原创

Composer 应全局安装并加入 PATH,而非设环境变量;Ubuntu 用 ~/.bashrc(zsh 用 ~/.zshrc),避免 apt 安装旧版;禁用 sudo 运行以免权限污染。

composer怎么在ubuntu上配置全域变量_linux安装composer详细过程【介绍】

Composer 在 Ubuntu 上不需要也不建议配置“全域变量”,正确做法是全局安装并确保系统能直接调用 composer 命令——本质是把可执行文件路径加入 $PATH,不是设置环境变量

为什么不能用 export PATH=... 临时加 /usr/local/bin?

临时修改 $PATH(比如在当前终端里运行 export PATH="/usr/local/bin:$PATH")只对当前 shell 有效,关掉终端就失效。很多用户卡在这一步,以为“配置失败”,其实是没写入 shell 配置文件。

  • Ubuntu 默认 shell 是 bash,应写入 ~/.bashrc(非 ~/.profile/etc/environment,后者不适用于交互式登录)
  • 如果用了 zsh(如 Ubuntu 22.04+ 某些桌面环境),要改 ~/.zshrc
  • 改完必须执行 source ~/.bashrc 或新开终端才生效

全局安装 Composer 的标准流程(推荐 curl + sudo)

官方推荐方式是下载 composer.phar 并移动到系统级可执行路径,避免权限混乱和更新困难:

curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer
sudo chmod +x /usr/local/bin/composer

这三步做完后,验证是否成功只需运行:

composer --version

如果报错 command not found,说明 /usr/local/bin 不在 $PATH 中——此时才需要检查并修正 shell 配置文件。

Refore
Refore

UI/UX智能设计工具,可以将任意网页、HTML文件或UI截图转换为设计稿

下载

常见错误:用 apt install php-composer 安装旧版或损坏版本

Ubuntu 官方源里的 php-composer 包长期滞后(例如 2023 年仍为 Composer 1.x),且可能因 PHP 扩展依赖缺失导致 composer diagnose 报错:

  • The openssl extension is missing, which means that secure HTTPS transfers are impossible.
  • The json extension is missing.

解决方法不是硬装扩展,而是绕过 apt,用上面的 curl 方式安装——它会自动检测本地 PHP 环境并给出明确提示,比包管理器更可靠。

权限问题:为什么不能用 sudo composer create-project?

全局安装后的 composer 命令本身无需 root 权限运行;但若在项目目录下用 sudo composer create-project,会导致生成的 vendor/ 文件属主变成 root,后续 gitphp artisan 等操作频繁报 permission denied。

  • 永远用普通用户身份运行 composer 命令
  • 确保项目目录可写:chmod -R u+rwX my-project/
  • 如果之前误用了 sudo,先修复权限:sudo chown -R $USER:$USER my-project/

真正容易被忽略的是:Composer 全局行为(如插件、缓存)默认存在 ~/.composer/,这个目录权限一旦被 sudo 污染,后续所有命令都会静默失败——得手动 chown 回来。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
composer是什么插件
composer是什么插件

Composer是一个PHP的依赖管理工具,它可以帮助开发者在PHP项目中管理和安装依赖的库文件。Composer通过一个中央化的存储库来管理所有的依赖库文件,这个存储库包含了各种可用的依赖库的信息和版本信息。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

158

2023.12.25

json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

431

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

543

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

314

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

79

2025.09.10

curl_exec
curl_exec

curl_exec函数是PHP cURL函数列表中的一种,它的功能是执行一个cURL会话。给大家总结了一下php curl_exec函数的一些用法实例,这个函数应该在初始化一个cURL会话并且全部的选项都被设置后被调用。他的返回值成功时返回TRUE, 或者在失败时返回FALSE。

450

2023.06.14

linux常见下载安装工具
linux常见下载安装工具

linux常见下载安装工具有APT、YUM、DNF、Snapcraft、Flatpak、AppImage、Wget、Curl等。想了解更多linux常见下载安装工具相关内容,可以阅读本专题下面的文章。

179

2023.10.30

自建git服务器
自建git服务器

git服务器是目前流行的分布式版本控制系统之一,可以让多人协同开发同一个项目。本专题为大家提供自建git服务器相关的各种文章、以及下载和课程。

789

2023.07.05

Golang处理数据库错误教程合集
Golang处理数据库错误教程合集

本专题整合了Golang数据库错误处理方法、技巧、管理策略相关内容,阅读专题下面的文章了解更多详细内容。

65

2026.02.06

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 11.3万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 11.2万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号