如何通过 Composer 配置 bin-dir 来统一管理可执行文件？

Composer 的 bin-dir 配置可将依赖包的可执行文件统一软链接至指定目录，便于全局调用；支持项目级（composer.json 中配置）和全局级（composer config -g）两种设置方式，需手动创建目录并确保路径在 $PATH 中。

Composer 的 bin-dir 配置能让所有通过 require 安装的含可执行文件（如 phpunit、laravel/installer、php-cs-fixer）的包，把二进制脚本统一软链接到指定目录，避免散落在各 vendor 子目录里，也方便全局调用。

设置 bin-dir 的两种方式

你可以在项目根目录的 composer.json 中显式配置，也可以在全局配置中设定默认值：

• 项目级配置：在 composer.json 的 "config" 段添加：
  "bin-dir": "bin"（相对路径）或 "bin-dir": "/usr/local/bin"（绝对路径）
• 全局配置：运行 composer config -g bin-dir /usr/local/bin，之后所有新项目默认使用该路径（需确保有写入权限）

执行安装后自动创建软链接

配置生效后，运行 composer install 或 composer require xxx，Composer 会检查包的 bin 字段（如 "bin": ["phpunit"]），并在 bin-dir 目录下生成指向 vendor/xxx/xxx/bin/phpunit 的可执行软链接。

例如：安装 phpunit/phpunit 后，bin/phpunit 就能直接运行，无需写完整路径。

注意事项与常见问题

bin-dir 目录本身不会被 Composer 自动创建，需提前手动建立（如 mkdir bin）；若设为系统级路径（如 /usr/local/bin），建议配合 sudo 使用，或改用用户可写路径（如 ~/.local/bin）并确保它在 $PATH 中。

标签： php linux laravel js json composer windows 工具 mac macos 环境变量