升級套件

在 ServBay 本地 Web 開發環境中，保持套件（如 PHP、資料庫、Web 伺服器等）為最新狀態，有助於確保開發效率、安全性和享有最新功能。ServBay 提供直覺且高效的流程來管理及升級您的套件。透過以下詳細步驟和功能說明，您可以輕鬆將所需套件更新至最新版本。

TIP

升級套件的過程安全且無破壞性。升級操作不會影響您現有的資料，包含但不限於 MariaDB、MySQL、PostgreSQL 資料庫中的資料檔案、網站檔案、SSL 憑證設定等。您可以安心更新至最新版本，無須擔憂資料遺失或損毀。

升級套件步驟

ServBay 的圖形使用者介面 (GUI) 讓升級流程變得非常直觀。請依照以下步驟進行：

1. 開啟 ServBay 應用程式： 啟動 ServBay 應用程式。您可以透過 macOS 的 Launchpad、Applications 資料夾或 Spotlight 搜尋來開啟它。

2. 前往「套件」頁面： 在 ServBay 應用介面的左側導覽選單中，點擊標有 套件 的選項。這將帶您進入 ServBay 管理所有已安裝套件的頁面。

3. 檢視套件列表： 於「套件」頁面，您會看到一個詳細列表，展示 ServBay 中所有可用或已安裝的套件。列表通常包含套件名稱、現行已安裝版本、可用最新版本、執行狀態（如「執行中」、「已停止」）以及程序 ID (PID) 等關鍵資訊。

4. 檢查可用更新： 仔細檢查套件列表的 最新版本 欄位。如果某套件有可用更新，最新版本 欄會顯示高於 現行版本 的版本號。此時，在該套件條目的最右側通常會顯示一個顯眼的橘色 升級 按鈕（一般帶有向上箭頭圖示），明確提示有待安裝的更新。

5. 點擊「升級」按鈕： 找到您想升級的套件，然後點擊該套件項目最右側對應的橘色 升級 按鈕。點擊後，ServBay 將開始執行升級流程。

6. 監控升級進度： 點擊升級按鈕後，ServBay 會自動處理套件的下載與安裝。升級過程的進度可能會透過介面上的指示器或狀態訊息顯示。所需時間取決於套件大小及您的網路速度。升級完成後，ServBay 會自動重新啟動該套件（若原本為執行狀態），並更新其狀態為 執行中，現行版本 也會同步更新為新版本號。

範例說明：升級 PHP 套件

假設您想將 ServBay 中安裝的 PHP 8.1 版本進行升級。以下為具體操作範例：

1. 前往「套件」頁面： 開啟 ServBay 應用程式，並於左側導覽選單點擊 套件。

2. 尋找 PHP 8.1 套件： 在顯示的套件列表中，下滑或搜尋找到 PHP 8.1 項目。你可能會看到如：現行版本 顯示為 8.1.28，而 最新版本 為 8.1.29。這表示 PHP 8.1 可從 8.1.28 升級至 8.1.29。

3. 點擊相對應的「升級」按鈕： 於 PHP 8.1 條目的最右側，找到並點擊橘色 升級 按鈕。

4. 等待升級完成並驗證： ServBay 將開始下載與安裝 PHP 8.1 最新版本。升級過程中，該套件狀態可能顯示「升級中」。升級完成後狀態會自動回復為 執行中，且 現行版本 也會更新為 8.1.29。

圖示：ServBay 套件頁面，顯示有可用更新的套件及升級按鈕。

常見問題解答 (FAQ)

升級套件會影響我現有資料與專案嗎？

不會。 ServBay 的核心設計理念之一就是保障核心資料的安全與隔離。套件升級僅會替換程式檔案本身，您的網站檔案、資料庫檔案（例如 /Applications/ServBay/data/mysql、/Applications/ServBay/data/pgsql 等目錄下的資料）以及 SSL 憑證、自訂設定檔等，皆存放於獨立位置，不會於升級時被修改或刪除。更多關於資料庫檔案管理，可參考資料庫檔案管理與遷移。

如何確認套件是否升級成功？

有幾個跡象代表升級成功：

1. 在「套件」頁面上，該套件的 現行版本 已更新為升級前的 最新版本 號。
2. 套件狀態顯示為 執行中。
3. 您可檢查套件日誌記錄（若適用）或透過終端機指令確認版本是否已生效（例如 PHP 可於終端執行 php -v 檢查版本，但需注意您的系統 PATH 設定是否指向 ServBay 的 PHP）。

升級過程中若遇到錯誤該怎麼辦？

若在升級過程中遇到網路問題、檔案權限問題、磁碟空間不足或其他錯誤，ServBay 介面通常會顯示相關的錯誤提示。

• 首先，請依照錯誤提示進行排查，例如檢查網路連線、確認 ServBay 應用有寫入權限、或清理磁碟空間。
• 若問題未解決，您可嘗試重新啟動 ServBay 應用，再次執行升級。
• 若仍有疑問，請聯絡 ServBay 支援團隊，並提供詳細的錯誤訊息及您的 ServBay 版本、macOS 版本等資訊，以利獲得專業協助。

ServBay 是否支援自動升級套件？

目前，ServBay 尚未提供全自動化的套件背景升級功能。開發者需要定期手動檢查「套件」頁面，在有可用更新時點擊「升級」按鈕來進行更新。這種手動升級方式，使開發者可完全掌握升級時機及內容，避免自動升級導致可能的相容性問題。

小結

透過 ServBay 直覺的「服務」頁面與簡單點擊操作，您可以輕鬆讓本地開發環境內的各類套件（如 PHP、MySQL、Nginx、Apache、Node.js、Python、Go、Java 等）持續保持最新狀態。定期升級套件是維護開發環境安全、穩定且享有最新功能的重要步驟。此流程安全、不影響您的現有資料，讓您能專注於開發工作。