關鍵要點
composer.json
文件中。這允許您使用您使用 Gemfury 創建的任何私有 Composer 包,而無需每次要使用包時都添加單獨的存儲庫。 sudo gem install gemfury
安裝它。 假設您熟悉 Composer,這是最新且可能是最棒的 PHP 包管理器。如果不是,請查看 Alexander 的介紹,我相信您會立即被它吸引。您需要具備它的工作知識才能充分利用本文。
Composer 可與 Packagist(一個全面的公共包存儲庫)有效且無縫地結合使用。
但是,遲早會遇到您自己編寫的包的情況,由於某種原因,該包無法開源並通過 Packagist 免費共享。
託管這些私有包有幾種選擇。您可以通過分別添加包的存儲庫來配置項目的 composer.json
文件。或者,Satis 允許您生成您自己的靜態存儲庫。或者,Toran Proxy 允許您創建 Packagist 的自託管私有版本,一旦設置好,它比在您的 composer.json
中指定存儲庫更容易管理。
Gemfury 是一種 PaaS 替代方案。除了託管解決方案帶來的安心感(儘管需要付費)之外,一個巨大的優勢是它不僅支持 PHP Composer 包,還支持 Ruby Gems、Node.js npm、Python PyPi、APT、Yum 和 Nu-Get。如果您掌握多種語言,這將非常有用。
讓我們深入了解如何使用它。
設置您的帳戶
首先,您需要一個帳戶。有一個 14 天的試用期,一個免費帳戶限制為一個協作者和一個託管包,以及一系列每月 9 美元起價的其他計劃。
您可以使用您的電子郵件地址或 Github 帳戶註冊。前往網站註冊。
創建您的第一個包
為了演示如何將 Gemfury 用於私有 Composer 包,讓我們逐步創建一個包,稍後我們將將其提交到服務以在其他項目中使用。
創建新包最簡單的方法是使用以下命令:
composer init
它會問您一系列問題;以下是此過程的一個示例記錄:
<code>... (此处省略与原文相同的composer init交互过程) ...</code>
如您所見,我們正在創建一個只有一個依賴項 Faker 的簡單包。
接下來,讓我們在新建的 composer.json
中添加一行,告訴它在哪裡查找包的源代碼。
"autoload": { "psr-0": { "Acme\": "src/" } },
現在讓我們創建包本身。我們將創建一個只有一個用途的類;使用複雜、絕密的專有算法為電子商務平台生成折扣優惠券代碼。
在您的工作目錄中,創建 src
和 src/Acme
目錄,然後創建名為 Coupon.php
的以下文件:
<?php namespace Acme; use Faker\Factory; class Coupon { public static function generate($percent) { $faker = Factory::create(); return sprintf('%s-%s-%d', strtoupper(date('M')), strtoupper($faker->word()), intval($percent)); } }
現在運行 composer install
來加載我們唯一的依賴項並配置自動加載器。
這就是我們構建的包。現在將其上傳到 Gemfury。
要繼續,您需要您的 API 密鑰。如果您轉到您的儀表板,您會在“設置”下找到它。
構建和上傳包最簡單的方法是簡單地使用 Git,並讓 Gemfury 處理其餘部分。
首先創建一個 .gitignore
文件,內容如下:
<code>vendor/ composer.lock</code>
現在初始化存儲庫:
git init
添加文件:
git add src git add composer.json
現在我們將添加一個 Git 遠程倉庫。您可以通過在 Gemfury 儀表板中選擇“入門”,然後選擇“PHP Composer”選項卡來找到相關的 URL。它看起來會像這樣:
<code>https://your-username@git.fury.io/your-username/<package-name>.git</code>
請務必將 your-username
替換為您的 Gemfury 用戶名(如果您使用 Github 註冊,它將與您的 Github 用戶名相同),並將其添加為遠程倉庫:
git remote add fury https://your-username@git.fury.io/your-username/coupon.git
此時,您有兩個選擇。第一種是使用顯式版本控制,您在 composer.json
文件中指定版本,如下所示:
{ "name": "your-username/coupon", "description": "Generates a coupon code", "version": "1.0.0", ...
重要的是您使用語義版本控制。否則,您的包可能無法正確構建;這也可能導致一些措辭奇怪的錯誤消息。
或者,您可以使用 Git 標籤。例如,使用標籤創建新版本,如下所示:
git tag -a 1.0.0 -m "Version 1.0.0"
無論您採用哪種方法,下一步都是提交:
git commit -a -m "Initial commit"
最後,運行以下命令:
git push fury master --tags
這會將您的代碼推送到 Gemfury,然後 Gemfury 會自動將其構建為包。
現在,如果您轉到您的儀表板,您應該會看到您的新存儲庫已列出。接下來,讓我們看看您如何在項目中使用它。
使用私有包
如果您返回儀表板並在左側選擇“Repos”,您會找到您的私有倉庫 URL。這應該保持私密,所以請妥善保管。它看起來會像這樣:
<code>https://php.fury.io/SECRET-CODE/your-username/</code>
正是 SECRET-CODE
使其不可猜測,因此實際上是私有的。
現在將其添加到您的項目的 composer.json
:
composer init
您只需要添加這個一個存儲庫即可使用您使用 Gemfury 創建的任何私有 Composer 包。無需每次要使用包時都添加單獨的存儲庫。
現在您可以像在 Packagist 上一樣需要您的私有包。這是一個項目 composer.json
的完整示例:
<code>... (此处省略与原文相同的composer init交互过程) ...</code>
其他方法
就我個人而言,我相信使用 Git 和標籤是管理包最簡單有效的方法。
或者,如果您願意,您可以通過壓縮包的源代碼並通過 Gemfury 儀表板上傳來自己構建它。
命令行工具
Gemfury 還提供了一個命令行工具。要安裝它:
"autoload": { "psr-0": { "Acme\": "src/" } },
要列出您的包,您可以使用以下命令:
<?php namespace Acme; use Faker\Factory; class Coupon { public static function generate($percent) { $faker = Factory::create(); return sprintf('%s-%s-%d', strtoupper(date('M')), strtoupper($faker->word()), intval($percent)); } }
要查看特定包的版本:
<code>vendor/ composer.lock</code>
有關 CLI 的更多信息,請訪問文檔的相關部分。
總結
在本文中,我介紹了 Gemfury,這是管理私有存儲庫的眾多選項之一。作為一種 PaaS 解決方案,它無需像 Toran 那樣自託管選項的額外負擔,並且比 Satis 更易於使用。它還具有支持各種語言的包的巨大優勢,從 PHP Composer 包到 Ruby Gems 和 Node.js npm。當然,作為一種 PaaS 解決方案,它確實需要付費——但為什麼不使用免費試用版或免費單包計劃試用一下,看看它是否適合您呢?
(此處省略原文FAQs部分,因為該部分為常見問題解答,與文章主體內容重複性較高,偽原創後價值不高。)
以上是私人作曲家套餐帶有gemfury的詳細內容。更多資訊請關注PHP中文網其他相關文章!