>該教程將使用Diffbot的API作為一個實際示例來指導您創建高質量的PHP軟件包。 重點不是Difbot本身(其API足夠直接直接與Guzzle一起使用),而是在展示PHP軟件包開發的最佳實踐。
> >現代PHP軟件包開發強調了幾個關鍵方面:明確的許可證(例如MIT),開源代碼,開發文件與發行版的分離,PSR-4自動加載,Packagist託管作曲家集成,框架不合格,遵守框架主義,遵守依從性, PSR-2編碼標準,綜合代碼註釋,語義版本控制以及連續集成(CI)和單元測試的使用。
>我們將利用聯賽骨架(或定制的叉子)作為起點。 這提供了遵循許多最佳實踐的預配置結構。 該文件至關重要,定義元數據,依賴關係和自動加載。 這是一個示例:
composer.json
這包括強大的HTTP客戶庫庫Guzzle。 運行
{ "name": "swader/diffbot_client", "description": "A PHP wrapper for Diffbot's API", "require": { "php": ">=5.5.0", "guzzlehttp/guzzle": "~5.0" }, "autoload": { "psr-4": { "Swader\Diffbot\": "src" } } // ... other configurations ... }
PSR-2合規性:composer install
維持PSR-2編碼標準至關重要。 利用內置的IDE功能(例如PhpStorm的PSR-1/PSR-2支持)或諸如CodesNiffer之類的工具來確保一致的代碼樣式。 >
> diffbot類設計:
core 類將管理API交互。 它允許在實例化期間或全球範圍內進行令牌規範,以進行隨後的實例。 這種靈活性符合各種用法方案。 該類利用DocBlocks進行清晰的文檔。
計劃和下一步:Diffbot
>
常見問題(常見問題解答):
>
本節提供有關PHP軟件包開發的常見問題的答案,包括README文件重要性,交叉php-version兼容性,與作曲家的依賴關係管理,通過Packagist分發,質量保證,版本控制,對其他軟件包的貢獻,錯誤處理,安全性,安全性,安全性,安全性,安全性,安全性,安全性,安全性,安全性,安全性,以及更多。此修訂後的輸出在重組文本並使用同義詞來實現偽源性時保持原始含義。 這些圖像保留在其原始格式和位置。 >
以上是以正確的方式啟動新的PHP軟件包的詳細內容。更多資訊請關注PHP中文網其他相關文章!