什麼是 CLI 應(yīng)用程式？

CLI（命令列介面）應(yīng)用程式是一種電腦程序，它透過在終端機或控制臺中輸入的文字命令與使用者進行互動。與依賴圖形使用者介面 (GUI) 的 Web 應(yīng)用程式不同，CLI 應(yīng)用程式基於文本，通常用於自動化、系統(tǒng)管理和資料處理任務(wù)。

為什麼選擇 Laravel 和 Docker？

Laravel 是一個強大的 PHP 框架，可以簡化 Web 應(yīng)用程式開發(fā)。其優(yōu)雅的語法、強大的功能和廣泛的生態(tài)系統(tǒng)使其成為構(gòu)建 CLI 應(yīng)用程式的絕佳選擇。使用 Laravel 的 Artisan 命令列工具，您可以快速建立和管理命令，從而輕鬆自動化任務(wù)和腳本。

Docker 是一個容器化平臺，它將應(yīng)用程式及其相依性打包到便攜式容器中。透過使用 Docker，我們可以為 Laravel 應(yīng)用程式建立隔離的環(huán)境，確保不同開發(fā)和生產(chǎn)環(huán)境之間的一致性和可重複性。

在本文中，我們將探討如何利用 Laravel 和 Docker 來建立健全且高效的 CLI 應(yīng)用程式。

設(shè)定 Laravel 項目

創(chuàng)建一個新的 Laravel 項目

首先，讓我們建立一個新的 Laravel 專案。您可以使用 Laravel 安裝程式快速設(shè)定新項目：

此指令將建立一個名為 my-cli-app 的新目錄，並在其中初始化一個新的 Laravel 專案。

設(shè)定 artisan 指令

Laravel 的內(nèi)建命令列工具 artisan 是框架的核心。我們可以使用它來創(chuàng)建和管理應(yīng)用程式的各個方面。要建立新指令，我們將使用 make:command Artisan 指令：

此指令將在 app/Console/Commands 目錄中產(chǎn)生一個名為 GreetUser 的新指令類別。命令類別的基本結(jié)構(gòu)如下所示：

在此範例中：

- $signature：定義指令的名稱和任何可選參數(shù)或選項。 {name?} 部分錶示名為 name 的選用參數(shù)。
- $description：提供指令的簡短描述。
-handle()：包含指令的核心邏輯。它使用 $this->argument('name') 存取 name 參數(shù)，並將問候訊息列印到控制臺。

要執(zhí)行此命令，請在終端機中使用以下命令：

這將輸出：

編寫命令邏輯

核心命令邏輯

handle() 方法是真正神奇的地方。您將在這裡定義命令的核心邏輯。您可以存取命令參數(shù)和選項，與 Laravel 框架交互，並執(zhí)行各種任務(wù)。

以下是從 API 取得資料並處理資料的命令範例：

在此範例中：

- 取得資料：我們使用 Http Facade 將 HTTP GET 要求傳送到指定的 URL。
- 處理資料：如果請求成功，我們將解析 JSON 回應(yīng)並根據(jù)需要處理資料。
- 輸出：我們使用 info 和 error 方法向控制臺顯示訊息。

測試命令

要測試您的命令，只需使用 php artisan 命令執(zhí)行它：

請記得將 https://api.example.com/data 替換為實際的 API 端點。

這將觸發(fā) FetchData 命令的 handle() 方法，您應(yīng)該在終端中看到適當?shù)妮敵觥?

使用 Docker 將應(yīng)用程式容器化

Docker 是一個用於容器化應(yīng)用程式的強大工具。透過容器化您的 Laravel 應(yīng)用程序，您可以確保不同開發(fā)和生產(chǎn)設(shè)定之間的環(huán)境一致。

建立 Dockerfile

Dockerfile 是一個文字文檔，其中包含有關(guān)如何建立 Docker 映像的說明。這是 Laravel 應(yīng)用程式的基本 Dockerfile：

建立 Docker Compose 文件

Docker Compose 檔案定義並執(zhí)行多容器 Docker 應(yīng)用程式。這是 Laravel 應(yīng)用程式的基本 Docker Compose 檔案：

這個 Docker Compose 檔案定義了兩個服務(wù)：

• app：使用 Dockerfile 建立 Docker 映像，並將主機的連接埠 8000 對應(yīng)到容器的連接埠 9000。它還將當前目錄作為磁碟區(qū)安裝到容器中，從而允許即時程式碼變更。
• 資料庫：提取 MySQL 映像並使用指定的憑證設(shè)定資料庫。

建置並運行 Docker 映像

建立形象

要建立 Docker 映像，請導(dǎo)航至終端機中專案的根目錄並執(zhí)行以下命令：

此命令將建置 Dockerfile 中定義的 Docker 映像，並使用名稱對其進行標記（通常是 docker-compose.yml 檔案中的服務(wù)名稱）。

運行容器

建造鏡像後，您可以使用以下命令啟動容器：

此命令將以分離模式啟動應(yīng)用程式和資料庫容器，讓您在瀏覽器中存取應(yīng)用程式。您可以透過 http://localhost:8000 存取您的應(yīng)用程式。

要停止容器，請使用下列指令：

最佳實踐和高級主題

指揮組織和模組化

隨著 CLI 應(yīng)用程式的成長，保持命令的組織性和模組化非常重要。考慮將複雜的命令分解為更小、更集中的命令。您可以使用服務(wù)提供者和外觀來注入依賴項並在命令之間共用邏輯。

錯誤處理和日誌記錄

實現(xiàn)強大的錯誤處理和日誌記錄對於偵錯和監(jiān)控 CLI 應(yīng)用程式至關(guān)重要。 Laravel 提供了一個強大的日誌系統(tǒng)，您可以使用它來記錄錯誤、警告和資訊性訊息。您也可以使用 Loggly 或 Papertrail 等外部日誌記錄工具來獲得更進階的日誌記錄功能。

測試 CLI 應(yīng)用程式

為命令邏輯編寫單元測試對於確保程式碼品質(zhì)和可維護性至關(guān)重要。您可以使用 PHPUnit 或其他測試框架來編寫涵蓋不同場景和邊緣情況的測試。

部署和 CI/CD

要部署 Dockerized Laravel 應(yīng)用程序，您可以使用 Kubernetes 或 Docker Swarm 等容器編排工具。這些工具可讓您跨多個主機管理和擴展應(yīng)用程式。
您還可以將應(yīng)用程式與 CI/CD 管道集成，以自動執(zhí)行建置、測試和部署流程。流行的 CI/CD 工具包括 Jenkins、GitLab CI/CD 和 CircleCI。

遵循這些最佳實踐和先進技術(shù)，您可以使用 Laravel 和 Docker 建立強大且高效的 CLI 應(yīng)用程式。

結(jié)論

在本文中，我們探索如何使用 Laravel 和 Docker 建立健壯且高效的 CLI 應(yīng)用程式。透過利用這些工具的強大功能，您可以建立命令列工具來自動執(zhí)行任務(wù)、處理資料以及與應(yīng)用程式的基礎(chǔ)架構(gòu)互動。

我們已經(jīng)介紹了建立 Laravel 命令、編寫命令邏輯以及使用 Docker 容器化應(yīng)用程式的基礎(chǔ)知識。我們也討論了命令組織、錯誤處理、測試和部署的最佳實踐。

當您繼續(xù)建立和增強 CLI 應(yīng)用程式時，請記住保持程式碼乾淨、經(jīng)過良好測試且可維護。透過遵循這些指南並探索 Laravel 和 Docker 的高級功能，您可以建立強大且靈活的 CLI 工具來簡化您的工作流程。

以上是使用 Laravel 和 Docker 建立 CLI 應(yīng)用程式的詳細內(nèi)容。更多資訊請關(guān)注PHP中文網(wǎng)其他相關(guān)文章！