在 ServBay 中使用 PHP 的 cURL 模組

ServBay 作為一款功能強大的本地 Web 開發環境，為開發者預先配置了各式工具與套件，其中包含 PHP 的 cURL 模組。cURL 是功能豐富的函式庫，用於在指令列或腳本中傳輸資料，支援多種協議，是現代 Web 開發中進行 API 互動與資料傳輸不可或缺的重要工具。透過 ServBay，開發者可輕鬆在 PHP 應用中運用 cURL 處理資料傳輸與網路請求，無須繁瑣的安裝設定。

cURL 模組簡介

cURL 函式庫是一款功能強大的工具，廣泛應用於指令列或腳本中的資料傳輸。它支援多種協議（如 HTTP、HTTPS、FTP、FTPS、SFTP、SCP 等），並能處理多種複雜網路請求，如 GET、POST、PUT、DELETE 等。cURL 在 Web 開發領域被廣泛用於與其他 Web 服務及 API 互動。

主要特色

多協議支援：cURL 支援多種主流網路傳輸協議。
彈性的請求方式：支援多種 HTTP 請求方法，滿足不同的網路互動需求。
豐富的選項：提供大量選項細緻控制請求，例如設定請求標頭、處理認證、使用代理、設定逾時等。
簡單易用：提供簡潔的 API 介面，方便開發者於 PHP 程式碼中整合網路功能。
強大的除錯功能：能詳列傳輸過程，有助於開發者診斷與優化網路請求。

ServBay 中的 cURL 版本與啟用狀態

ServBay 支援多個 PHP 版本，並且針對每一個整合於 ServBay 的 PHP 版本，都預先安裝且預設啟用對應的 cURL 模組。這表示您安裝 ServBay 後，不需進行額外安裝或設定，即可於 PHP 專案中直接使用 cURL 功能。

如何確認 cURL 模組已啟用

雖然 cURL 在 ServBay 中預設啟用，若您想核對或檢視更詳細資訊，可透過標準的 phpinfo() 函數進行驗證。

於您的網站根目錄（例如 /Applications/ServBay/www/您的專案目錄/）下新增 PHP 檔案，例如 info.php。
在 info.php 檔案中新增以下程式碼：
php
```
<?php
phpinfo();
?>
```
1
2
3
透過瀏覽器存取該檔案（如 http://localhost/您的專案目錄/info.php 或 http://您的自訂網域/info.php）。
於開啟的 phpinfo 頁面搜尋「cURL」。您應該會看到獨立的「curl」區塊，其中「cURL support」會顯示為「enabled」，同時列出 cURL 的版本、支援的協議等詳細資訊。

這代表 cURL 模組已於目前的 PHP 版本中成功啟用並可隨時使用。

在 PHP 程式碼中使用 cURL

確認 cURL 模組已啟用後，您就可以直接在 PHP 程式碼中運用 cURL 函式進行網路請求。以下提供兩個簡單例子，分別示範如何進行 HTTP GET 與 POST 請求。

範例程式碼（HTTP GET 請求）

本範例示範如何以 cURL 執行簡單的 HTTP GET 請求並取得回應內容。

php

<?php
// 初始化cURL會話
$ch = curl_init();

// 設定cURL選項
// CURLOPT_URL: 指定請求的URL
// CURLOPT_RETURNTRANSFER: 設為 true 表示將回應作為字串返回，而非直接輸出
curl_setopt($ch, CURLOPT_URL, 'https://api.example.com/data'); // 替換為實際的API URL
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// 執行cURL請求
$response = curl_exec($ch);

// 檢查是否發生錯誤
if (curl_errno($ch)) {
    echo 'cURL error: ' . curl_error($ch);
} else {
    // 輸出回應內容
    echo 'Response: ' . $response;
}

// 關閉cURL會話並釋放資源
curl_close($ch);
?>

範例程式碼（HTTP POST 請求）

本範例示範如何以 cURL 執行 HTTP POST 請求並發送資料。

php

<?php
// 初始化cURL會話
$ch = curl_init();

// 設定POST資料
$postData = [
    'name' => 'ServBay Demo User', // 範例使用者名稱
    'email' => '[email protected]', // 範例電子信箱
    'age' => 30 // 範例年齡
];

// 設定cURL選項
// CURLOPT_URL: 指定請求的URL
// CURLOPT_POST: 設為 true 代表這是 POST 請求
// CURLOPT_POSTFIELDS: 設定 POST 資料，通常以 http_build_query 格式化
// CURLOPT_RETURNTRANSFER: 設為 true 表示回應以字串形式返回
curl_setopt($ch, CURLOPT_URL, 'https://api.example.com/submit'); // 替換為實際的API URL
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($postData));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// 執行cURL請求
$response = curl_exec($ch);

// 檢查是否發生錯誤
if (curl_errno($ch)) {
    echo 'cURL error: ' . curl_error($ch);
} else {
    // 輸出回應內容
    echo 'Response: ' . $response;
}

// 關閉cURL會話並釋放資源
curl_close($ch);
?>

這些範例說明了 cURL 的基本應用方式。在實際開發時，cURL 提供更多參數與進階用法可應對各種複雜情境，例如設定請求標頭、管理 Cookie、上傳檔案、設定代理、處理重導向、調整 SSL/TLS 選項等。建議參考 PHP 官方的 cURL 文件以獲得更完整的資訊與進階操作技巧。

注意事項

錯誤處理： 使用 cURL 時，務必檢查 curl_exec() 回傳值，以及經由 curl_errno() 和 curl_error() 取得的錯誤訊息。妥善的錯誤處理是建構穩健應用系統的關鍵。
SSL 憑證驗證： 預設情況下，cURL 會驗證 HTTPS 連線的 SSL 憑證。在開發環境中，若連接的服務使用自簽憑證或憑證鏈不完整，可能導致驗證失敗。ServBay 提供 ServBay User CA 及 ServBay Public CA，助您於本地開發及測試時處理 SSL 憑證問題，請參考 ServBay 的 SSL 憑證相關文件以進行設定與使用。
效能： 若應用是否需大量並發請求或長時間連線時，請務必妥善管理 cURL 資源，例如運用 curl_multi_* 系列函數來進行批次處理。

結論

ServBay 為開發者提供預先安裝並預設啟用的 PHP cURL 模組，大幅簡化在本地開發環境中建立網路請求的流程。您可以立即在 PHP 應用中充分發揮 cURL 的強大功能，無需額外安裝或設定。配合 ServBay 所提供的其他便利功能，您將能更高效地進行 Web 開發與測試，輕鬆打造可與外部服務互動的 PHP 應用程式。

在 ServBay 中使用 PHP 的 cURL 模組 ​

cURL 模組簡介 ​

主要特色 ​

ServBay 中的 cURL 版本與啟用狀態 ​

如何確認 cURL 模組已啟用 ​

在 PHP 程式碼中使用 cURL ​

範例程式碼（HTTP GET 請求） ​

範例程式碼（HTTP POST 請求） ​

注意事項 ​

結論 ​