在 ServBay 本地環境中高效使用 PHP

PHP（Hypertext Preprocessor，超文本預處理器）是一種廣泛使用的開源腳本語言，特別適合網頁開發，可以直接嵌入於 HTML 中。結合其靈活的語法（吸收了 C、Java 和 Perl 的特色），PHP 容易上手，且可與多種資料庫系統及服務無縫整合。

作為一套強大的本地 Web 開發環境，ServBay 為 macOS 開發者帶來便捷的 PHP 安裝、配置與管理方式，使您能高效地在本地進行 PHP 應用的開發與測試。

ServBay 對 PHP 的支援

ServBay 支援多個 PHP 版本，從舊版相容到最新版穩定版，讓您可依專案需求選擇最合適的 PHP 環境進行開發與部署。ServBay 支援以下 PHP 版本：

• PHP 5.6
• PHP 7.0
• PHP 7.1
• PHP 7.2
• PHP 7.3
• PHP 7.4
• PHP 8.0
• PHP 8.1
• PHP 8.2
• PHP 8.3
• PHP 8.4

TIP

ServBay 已經 內建 Composer，毋須額外安裝。

安裝方式

您可透過 ServBay 的 GUI 面板輕鬆安裝和管理 PHP 套件。安裝步驟如下：

1. 開啟 ServBay GUI 面板。
2. 進入左側邊欄的「軟體包」-「PHP」區段。
3. 在清單中尋找所需的 PHP 版本。
4. 點選該版本旁的綠色「安裝」按鈕，等待安裝完成。

管理與切換 PHP 版本

ServBay 的一大優勢是可快速於多個 PHP 版本間切換。若您安裝了多個 PHP 版本，可以在 ServBay GUI 面板「軟體包」-「PHP」頁面，點擊某版本右側按鈕，設為目前啟用的 PHP 版本。

設定啟用版本後，ServBay 即會以此 PHP 版本來運行您的 Web 應用程式。

內建模組

ServBay 為 PHP 帶來多項常用模組，方便您擴展 PHP 的功能。多數核心模組預設已安裝並啟用，無須額外設定；其他模組則可視需求手動啟用。

以下為 ServBay 內建的部分 PHP 模組列表：

• GD：圖像處理函式庫，如建立、編輯或輸出各類圖片格式。預設安裝並啟用，無須額外設定。
• IMAP：用於處理郵件的函式庫，支援 IMAP、POP3 和 NNTP 協定。預設安裝並啟用，無須額外設定。
• Imagick：ImageMagick 的 PHP 擴充，提供更進階的圖像處理能力。預設安裝並啟用，無須額外設定。
• Memcache：記憶體物件快取系統 Memcache 的用戶端函式庫。預設安裝並啟用，無須額外設定。
• Memcached：高效能分散式記憶體快取系統 Memcached 的用戶端函式庫。預設安裝並啟用，無須額外設定。
• MySQL：連接與操作 MySQL 資料庫的 PHP 擴充（通常指 mysqli 或 mysqlnd）。預設安裝並啟用，無須額外設定。
• OpenLDAP：輕量級目錄存取協定的 PHP 擴充，用於與 LDAP 伺服器互動。預設安裝並啟用，無須額外設定。
• PgSQL：連接與操作 PostgreSQL 資料庫的 PHP 擴充。預設安裝並啟用，無須額外設定。
• Redis：連接與操作 Redis 鍵值儲存系統的 API 擴充。預設安裝並啟用，無須額外設定。
• SQLite 3：連接與操作 SQLite 資料庫的 PHP 擴充。預設安裝並啟用，無須額外設定。
• Sodium：用於加密操作的庫，可提供先進而強大的加密功能。預設安裝並啟用，無須額外設定。
• cURL：發送網路請求與資料傳輸的函式庫，支援多種協定（如 HTTP、HTTPS、FTP 等）。預設安裝並啟用，無須額外設定。
• MongoDB：操作 MongoDB 資料庫的 PHP 擴充。啟用方式請參閱：如何啟用 ServBay 內建的 MongoDB 模組。
• OPcache：提升 PHP 腳本效能的位元組碼快取模組。啟用方式請參閱：如何啟用 ServBay 內建的 OPcache 模組。
• Phalcon：高效能 PHP 框架擴充，以 C 擴充形式提供。啟用方式請參閱：如何啟用 ServBay 內建的 Phalcon 模組。
• SCWS：中文斷詞系統的 PHP 擴充。啟用方式請參閱：如何啟用 ServBay 內建的 SCWS 模組。
• Swoole：高效能的 PHP 非同步、協程和並行網路通訊框架擴充。啟用方式請參閱：如何啟用 ServBay 內建的 Swoole 模組。
• Xdebug：提供 PHP 偵錯與程式碼分析能力的強大擴充。啟用方式請參閱：如何啟用 ServBay 內建的 Xdebug 模組。

更詳細的使用教學請參考下方連結：

• GD
• IMAP
• Imagick
• Memcache
• Memcached
• MySQL
• OpenLDAP
• PgSQL
• Redis
• SQLite 3
• Sodium
• cURL
• MongoDB
• OPcache
• Phalcon
• SCWS
• Swoole
• Xdebug

如何確認模組是否啟用？

您可以在網站根目錄建立一個 info.php 檔案，內容為 <?php phpinfo(); ?>，然後在瀏覽器開啟該頁面。搜尋頁面內容即可檢視目前 ServBay 啟用中的 PHP 版本已安裝與啟用的所有模組及詳細設定資訊。

配置 PHP（php.ini）

PHP 行為可透過 php.ini 配置檔詳細設定，例如記憶體上限、錯誤回報等級、檔案上傳大小等等。ServBay 會為每個已安裝的 PHP 版本分別產生對應的 php.ini 檔案。

欲尋找目前啟用 PHP 版本的 php.ini 位置，最簡易方法是至 phpinfo() 頁面查詢 "Loaded Configuration File"（已載入的配置檔）欄位。

您可經由 ServBay GUI 面板快速打開目前啟用版本的 php.ini 進行編輯：

1. 開啟 ServBay GUI 面板。
2. 前往「軟體包」-「PHP」區段。
3. 找到目前啟用（綠色標示）的 PHP 版本。
4. 點選該版本旁的設定（齒輪）圖示，選擇「編輯 php.ini」。

修改 php.ini 後，通常需重啟 ServBay 或至少重啟 Web 伺服器（如 Caddy 或 Nginx），更動才會生效。

基本使用範例：執行第一個 PHP 腳本

在 ServBay 執行 PHP 腳本十分容易。請依下列步驟建立一個簡單的 "Hello, World" 範例：

1. 確認您已在 ServBay 安裝並啟動至少一個 PHP 版本及一個 Web 伺服器（如 Caddy 或 Nginx）。
2. 開啟 ServBay 的網站根目錄。依推薦設定，預設路徑通常為 /Applications/ServBay/www。
3. 在該目錄下建立新的子資料夾，例如 php-demo。完整路徑將會是 `/Applications/ServBay/www/php-demo