bin字段用于定义包中可执行文件路径，Composer会将其链接到vendor/bin；它在composer.json中以数组形式列出脚本路径，如"bin/my-command"，文件需有可执行权限和Shebang行。
在 Composer 中，"bin" 字段用于指定包中可执行文件的路径，这些文件通常是一些命令行工具。当你安装一个包含 bin 定义的 Composer 包时，Composer 会自动将这些二进制文件软链接（或复制）到项目的 vendor/bin 目录下，从而让你可以在命令行中直接运行它们。
在 composer.json 中，bin 是一个数组字段，列出包中所有希望被暴露为可执行命令的脚本文件路径。
例如：
{
"name": "acme/cli-tool",
"bin": [
"bin/my-command",
"bin/another-tool"
]
}
上面的配置表示该包提供了两个可执行文件：bin/my-command 和 bin/another-tool。当这个包被其他项目依赖并安装时，Composer 会将这两个文件链接到该项目的 vendor/bin 目录中。
注意： 这些文件必须具有可执行权限（Unix 下可通过 chmod +x 设置），并且通常在文件开头包含 Shebang 行，如：
#!/usr/bin/env php <?php // your CLI logic here
当你运行 composer install 或 composer update 时，Composer 会遍历所有已安装的依赖包，检查每个包的 composer.json 是否包含 bin 字段。
对于每一个定义了 bin 的包，Composer 执行以下操作：
bin 数组中的每个文件路径vendor/bin 目录中创建指向这些文件的符号链接（Linux/macOS）或复制文件（Windows）最终结果是，所有依赖包提供的命令行工具都集中出现在 vendor/bin 中，你可以通过如下方式调用：
php vendor/bin/my-command
或者如果你将 vendor/bin 加入系统 PATH，可以直接运行：
my-command
为了确保 bin 文件正常工作，需要注意以下几点：
bin/my-script 指的是包根目录下的 bin/my-script
#!/usr/bin/env php 开头，以便系统能找到 PHP 解释器你也可以通过 bin-dir 配置自定义存放路径，在 composer.json 中添加：
{
"config": {
"bin-dir": "scripts"
}
}
这样 bin 文件会被放到 scripts/ 目录而不是默认的 vendor/bin（但现代版本推荐使用 vendor-bin 插件替代此方式）。
基本上就这些。Composer 的 bin 机制让 PHP 命令行工具的分发和使用变得非常方便。只要正确定义，用户安装后即可立即使用命令，无需手动配置路径。
以上就是如何在composer.json中定义二进制文件的路径_"bin" 字段与vendor/bin目录的生成原理的详细内容，更多请关注php中文网其它相关文章！
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移，垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是，许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
597
收藏
