在 ServBay 中指定網站和腳本的 PHP 版本

身為 Web 開發者，您可能同時要處理不同 PHP 版本的專案，或需測試程式碼在特定 PHP 版本下的相容性。ServBay 做為強大的本機開發環境工具，提供了靈活的 PHP 版本管理與切換方案。本篇將詳細說明如何在 ServBay 中，為您的專案、PHP 腳本及整個網站指定專屬的 PHP 執行環境。

為專案指定特定版本的 PHP

ServBay 支援在專案層級設定 PHP 運行環境。只需在專案根目錄建立名為 .servbay.config 的檔案，即可指定該專案使用的 PHP 版本。

指定特定 PHP 版本的 .servbay.config 檔案內容範例如下：

PHP_VERSION=8.0

注意： .servbay.config 應放於專案根目錄，也就是您在 ServBay 中設定網站時所指定的資料夾。例如，若您的網站根目錄為 /Applications/ServBay/www/my-project，則 .servbay.config 應位於 /Applications/ServBay/www/my-project/.servbay.config。

詳細設定說明請參考 ServBay 官方文件：.servbay.config 檔案說明。

為 PHP 腳本指定特定版本的 PHP

若您無需將整個專案或網站的 PHP 版本鎖定，只想暫時用特定 PHP 版本執行某個腳本，ServBay 也提供了便捷的命令列方案。

在 ServBay 整合的命令列環境下，可以運用 php-<version> 指令來指定 PHP 版本運行 PHP 腳本。這對於快速測試腳本於不同 PHP 版本表現時尤其好用。

例如，使用 PHP 5.6 去執行名為 version.php 的腳本，可以執行以下指令：

$ php-5.6 version.php
Hello World
PHP Version: 5.6.40

$ php-7.3 version.php
Hello World
PHP Version: 7.3.33

範例說明

• php-5.6 version.php：明確指定以 ServBay 中安裝的 PHP 5.6 版本執行 version.php 腳本。
• php-7.3 version.php：明確指定以 ServBay 中安裝的 PHP 7.3 版本執行 version.php 腳本。

如此一來，您能非常彈性地測試及執行不同 PHP 版本的相容性，無需調整專案或網站的全域設定。

為網站指定特定版本的 PHP

若需為整個網站（即經由 ServBay 設定的虛擬主機），指定一個固定 PHP 執行版本，可直接透過 ServBay 的圖形化管理介面完成。

這類情境常見於讓特定網站長期運行於某一版本 PHP（如：需要舊版 PHP 的專案，或正進行新版 PHP 相容性調適的專案）。

操作步驟

1. 打開 ServBay 管理介面： 啟動 ServBay 應用程式。

2. 進入網站設定： 於 ServBay 介面左側導覽選單點擊 網站 選項。

3. 選取目標網站： 在網站列表中找到您要設定的網站，於該行右側 PHP 版本 下拉選單點擊。

4. 選擇 PHP 版本並儲存： 於彈出的 PHP 版本選單中選取目標 PHP 版本（請確認已於 ServBay 安裝且處於執行中）。選取後，點選介面上的儲存按鈕（通常於列表頂部或底部）。

注意事項

• 請確認 PHP 版本已安裝且執行中：指定網站 PHP 版本之前，請先利用 ServBay「軟體包」功能，檢查該版本 PHP 是否已安裝並啟動，狀態需為「執行中」。如未安裝或未啟動，請先完成相關操作。
• 相容性測試建議：切換 PHP 版本後，建議立即瀏覽網站並完整測試主要功能，確保各元件與程式碼於新 PHP 版本下皆能正常運作。
• 網站根目錄建議：在 ServBay 設定網站時，建議將網站檔案集中於 /Applications/ServBay/www/ 下，各網站設子資料夾（如 /Applications/ServBay/www/servbay.demo）。本文範例皆依此路徑規範。

總結

ServBay 為開發者帶來多層次、彈性又便利的 PHP 執行環境管理方案，您可以：

• 於專案根目錄建立 .servbay.config，為單一專案指定 PHP 版本。
• 運用命令列工具 php-<version>，臨時以指定 PHP 版本執行單一腳本。
• 透過 ServBay 圖形化管理介面，為整個網站設定固定 PHP 運行版本。

這種多層級 PHP 版本控制，讓您面對不同專案需求時應對自如，不論是維護舊系統、開發新功能還是相容性測試皆能游刃有餘，徹底提升本機開發的效率與彈性。