ServBay 命令行工具：安裝、設定及操作指南

ServBay 不僅提供直觀的圖形使用者介面（GUI）來管理本地開發環境，同時也支援功能強大的命令行工具。只要將 ServBay 的命令行工具安裝於終端機（如 bash 或 zsh），就能在指令列中直接操作 ServBay 整合的各項開發工具與套件，有效提升您的開發效率與靈活性。

前置條件

在使用 ServBay 命令行工具之前，請確保您已順利安裝並運行 ServBay。

安裝 ServBay 命令行工具

以下為將 ServBay 命令行工具安裝至終端環境的詳細步驟：

開啟 ServBay 應用程式。
點選 ServBay 左側導覽列的「設定」選項。
在設定頁面中，找到「命令行工具」區塊。
根據您當前使用的終端環境（macOS 預設為 bash，或您可能使用 zsh），點擊對應的按鈕：
- 如果您使用 zsh，請點選「安裝 CLI 工具到 zsh」。
- 如果您使用 bash，請點選「安裝 CLI 工具到 bash」。
安裝過程中系統通常會要求您輸入管理員密碼，以修改系統環境檔案（比如 .zshrc 或 .bash_profile），請授權以完成安裝。
安裝完畢後，請務必關閉並重新開啟您的終端視窗。ServBay 命令行工具將於新的終端會話中生效。

設定預設軟體套件版本

ServBay 允許您針對常用套件（例如 PHP、Node.js、MySQL 或 MariaDB 等）設置全域預設版本。換言之，當您在終端直接執行 php、node、mysql 等指令時，系統會對應採用您於 ServBay GUI 中指定或透過命令行設置的預設版本。

如需詳細操作流程，請參閱設定預設版本文件。

為專案指定特定版本命令行

為配合不同專案的依賴版本需求，ServBay 支援透過在專案根目錄建立 .servbay.config 檔案來指定專案層級的 PHP 與 Node.js 版本。這將會覆蓋全域設定，確保每個專案始終使用指定的軟體版本，有效避免版本衝突。

使用 .servbay.config 檔案，除了可指定 PHP 與 Node.js 版本外，還能針對 Node.js 執行版本、套件庫位置、快取目錄等進行專案層級的客製化設定。

完整的設定與用法，請參考使用 .servbay.config 檔案文件。

直接執行指定版本的套件

除了設定預設版本與專案特定版本外，ServBay 也會自動將安裝過的主要軟體（如 PHP、Node.js）各版本的可執行檔加入系統 PATH，並以版本號作為檔名後綴（如 php-7.4、php-8.1、php-8.3）。因此，您可於終端機隨時直呼特定版本的執行檔，無需反覆切換全域、專案預設版本。

常用命令行範例

安裝 ServBay 命令行工具後，您可以直接於終端環境使用各項 ServBay 整合套件。以下為常見指令示例：

檢查當前系統預設 PHP 版本：
bash
```
php -v
```
1
檢查當前系統預設 Node.js 版本：
bash
```
node -v
```
1
以特定版本 PHP 執行腳本：
bash
```
php-8.3 your_script.php
```
1
您可將 php-8.3 替換為 ServBay 中已安裝的其他 PHP 版本，例如 php-7.4 或 php-8.1。
執行特定版本的 phpize 工具：
bash
```
phpize-8.3
```
1
phpize 工具常用於 PHP 擴充模組的編譯環境準備。
連線至 PostgreSQL 資料庫：
bash
```
psql -h localhost -U your_user -d your_database
```
1
請將 your_user 與 your_database 替換為實際的資料庫使用者名稱及資料庫名稱。
連線至 MySQL 資料庫：
bash
```
mysql -h localhost -u your_user -p your_database
```
1
請將 your_user 與 your_database 替換為實際資料庫帳號與資料庫名。執行後系統將提示您輸入密碼。

執行 SQL 查詢：

bash

psql -h localhost -U your_user -d your_database -c "SELECT * FROM your_table;"

加上 -c 參數後可直接於命令行執行 SQL 指令。

查詢 Redis 服務狀態資訊：
bash
```
redis-cli info stats
```
1

透過這些指令示例，您能輕鬆於命令行操作各種 ServBay 內建的套件與服務，大幅提升開發與除錯的效率。

注意事項

安裝命令行工具後，請務必重新開啟您的終端視窗，新環境變數才會生效。
若您更改了 ServBay 中軟體套件的安裝路徑，可能需要重新安裝命令行工具。

小結

ServBay 的命令行工具是其強大功能的核心之一，為開發人員帶來直接且高效的本地開發環境管理能力。只需數個簡單步驟，即可在終端中存取 ServBay 集成之 PHP、Node.js、資料庫等服務，並能根據專案需求輕鬆設定預設或專屬版本。熟練掌握 ServBay 命令行操作，將全面提升您的本地開發流程！

ServBay 命令行工具：安裝、設定及操作指南 ​

前置條件 ​

安裝 ServBay 命令行工具 ​

設定預設軟體套件版本 ​

為專案指定特定版本命令行 ​

直接執行指定版本的套件 ​

常用命令行範例 ​

注意事項 ​

小結 ​