在 Vagrant 虚拟机中正确配置 Composer，关键在于确保 PHP 环境、网络访问和路径映射都正常。很多开发者在本地安装了 Composer，却在虚拟机内执行命令时报错“command not found”，这是因为 Composer 没有安装在虚拟机系统中，而是只装在宿主机上。下面教你如何正确配置。

1. 确保虚拟机内已安装 PHP 和依赖

Composer 是基于 PHP 的包管理工具，必须先在虚拟机内部安装 PHP 及相关扩展。

登录到你的 Vagrant 虚拟机：

vagrant ssh 

然后检查是否已安装 PHP：

php -v 

如果没有输出版本号，需要先安装 PHP。以 ubuntu 为例：

• sudo apt update
• sudo apt install php-cli php-zip php-mbstring php-curl

这些是 laravel 或大多数 PHP 项目所需的常用扩展。

2. 在虚拟机中安装 Composer

不要使用宿主机的 Composer 处理虚拟机内的项目。应在虚拟机内部安装 Composer。

执行以下命令：

curl -sS https://getcomposer.org/installer | php 

这会在当前目录生成 composer.phar。将其移动到全局可执行目录：

阿里云-虚拟数字人

阿里云-虚拟数字人是什么？ …

2

查看详情

sudo mv composer.phar /usr/local/bin/composer 

现在可以在任意目录使用 composer 命令：

composer --version 

如果看到版本信息，说明安装成功。

3. 配置共享目录与项目路径

Vagrant 默认会把项目根目录（含 Vagrantfile）挂载到虚拟机的 /vagrant 目录。你的 PHP 项目代码通常也放在这里。

进入项目目录执行 Composer 命令：

cd /vagrant/your-project composer install 

这样安装的依赖会保存在共享目录中，宿主机也能看到 vendor 文件夹。

注意：避免在宿主机运行 Composer 处理通过 NFS 共享的项目，可能因权限或文件锁导致问题。

4. 权限与性能优化建议

• 如果遇到权限错误，确保虚拟机内的用户对项目目录有读写权限。
• 对于大型项目，可考虑在 composer.json 中启用优化自动加载：

composer dump-autoload -o

• 若使用 Homestead 或自定义 box，推荐在 provision 脚本中自动安装 Composer，提升环境一致性。

基本上就这些。只要在虚拟机里正确安装 PHP 和 Composer，并在共享目录中操作项目，就能避免绝大多数问题。