如何在composer.json中定义项目的二进制（bin）文件？（创建命令行工具）

在 composer.json 中通过 "bin" 字段声明可执行脚本路径，Composer 会将其软链接至 vendor/bin/；该脚本须为项目根目录下的 PHP 文件，具备可执行权限且以 #!/usr/bin/env php 开头。

在 composer.json 中定义二进制文件，核心是通过 "bin" 字段声明可执行脚本路径，Composer 会自动将其软链接到 vendor/bin/ 下，供命令行直接调用。

配置 "bin" 字段指向入口脚本

"bin" 的值必须是项目根目录下某个 PHP 文件的相对路径（通常为 bin/your-command 或 src/YourCommand.php），该文件需具备可执行权限且以 #!/usr/bin/env php 开头（或由 Composer 自动处理 shebang）。

• 在 composer.json 中添加字段，例如：

"bin": ["bin/mytool"]

确保 bin/mytool 存在，内容类似：

#!/usr/bin/env php
<?php
require __DIR__ . '/../vendor/autoload.php';
// 你的命令行逻辑
echo "Hello from mytool!\n";

确保脚本有执行权限

Linux/macOS 下需运行 chmod +x bin/mytool；Windows 用户可跳过，Composer 会适配。

标签： php js json composer 工具