如何用Composer進行包的發布

使用 Composer 進行包的發布涉及幾個步驟，包括準備包、配置 composer.json 文件、登錄 Packagist 以及執行發布命令。以下是詳細的步驟指南：

1. 準備你的包

確保你的包已經按照 PSR-4 自動加載標準進行了組織，并且有一個清晰的目錄結構。例如：

src/
    YourPackage/
        YourPackage.php
composer.json
README.md
LICENSE

2. 配置 composer.json

在你的 composer.json 文件中，確保有以下配置：

{
    "name": "your-vendor-name/your-package-name",
    "description": "A brief description of your package",
    "type": "library",
    "require": {
        // 依賴的其他包
    },
    "autoload": {
        "psr-4": {
            "YourVendorName\\YourPackageName\\": "src/"
        }
    },
    "license": "MIT",
    "authors": [
        {
            "name": "Your Name",
            "email": "your.email@example.com"
        }
    ],
    "minimum-stability": "dev",
    "prefer-stable": true
}

3. 登錄 Packagist

你需要一個 Packagist 賬戶來發布你的包。訪問 Packagist 并注冊一個賬戶。然后，使用 Composer 登錄：

composer login

輸入你的 Packagist 用戶名和密碼。

4. 發布包

在項目根目錄下運行以下命令來發布你的包：

composer publish

這個命令會將你的包發布到 Packagist。如果你只想發布特定的文件或目錄，可以使用 --classmap-authoritative 選項來確保 Composer 使用最新的類映射：

composer publish --classmap-authoritative

5. 驗證發布

發布完成后，你可以訪問 Packagist 并搜索你的包名，確認它已經成功發布。

6. 更新包

如果你需要更新包，可以修改 composer.json 文件并再次運行 composer publish 命令。如果你希望發布新版本，可以增加版本號并再次運行 composer publish。

注意事項

• 確保你的包名在 Packagist 上是唯一的。
• 在發布之前，最好先在本地測試你的包，確保它按預期工作。
• 如果你希望包是私有的，可以在 Packagist 上創建一個私有倉庫，并在 composer.json 中指定倉庫地址。

通過以上步驟，你應該能夠成功地使用 Composer 發布你的 PHP 包。