如何打印stream上下文以便debug

M66 2025-05-28

在PHP 中， stream_context_get_options函數是一個非常有用的調試工具，它可以幫助你查看與流(stream) 相關的上下文選項。當你在使用PHP 的stream函數時，往往會傳遞一些上下文選項來配置流的行為，例如設置代理、認證、超時等。為了調試和查看這些選項， stream_context_get_options是一個非常方便的工具。

什麼是stream 上下文？

stream_context是一個封裝了流資源的設置對象，它允許你通過上下文配置流的行為。例如，在通過file_get_contents函數讀取文件或通過fopen打開文件時，你可以使用上下文來設置請求頭、代理、認證信息等。

如何使用stream_context_get_options函數？

stream_context_get_options函數返回一個關聯數組，其中包含所有已配置的上下文選項。通過該函數，你可以在調試時查看哪些設置已經應用到流。

以下是一個使用stream_context_get_options函數的示例：

 <?php
// 創建一個帶有選項的流上下文
$options = array(
    "http" => array(
        "method" => "GET",
        "header" => "User-Agent: PHP\r\n"
    ),
    "ssl" => array(
        "verify_peer" => false
    )
);

// 創建上下文
$context = stream_context_create($options);

// 使用上下文打開流
$stream = fopen("https://m66.net/somepath", "r", false, $context);

// 打印流的上下文選項進行調試
$options = stream_context_get_options($context);
echo "<pre>";
print_r($options);
echo "</pre>";

// 關閉流
fclose($stream);
?>

代碼解釋：

創建上下文：代碼通過stream_context_create創建了一個包含HTTP 和SSL 設置的上下文。 http部分包含了請求方法和頭部信息， ssl部分則禁用了SSL 證書驗證。
打開流：使用fopen函數打開URL https://m66.net/somepath ，並將創建的上下文傳遞給它。這一步可以訪問外部資源，並應用上下文設置。
獲取上下文選項： stream_context_get_options($context)用來獲取當前上下文的所有設置。返回的結果是一個包含所有選項的關聯數組。
輸出調試信息： print_r($options)將上下文選項以可讀的格式輸出，以便開發者檢查和調試。

常見的調試用途：

查看代理設置：當使用http流時，代理設置是很常見的選項。使用stream_context_get_options可以幫助你確認代理設置是否正確。
調試SSL 配置：在使用HTTPS 協議時，可能會遇到SSL 證書錯誤。通過stream_context_get_options可以檢查SSL 選項是否正確配置，如是否驗證證書，是否使用特定的SSL 版本等。
檢查請求頭：如果你需要通過流發送自定義的請求頭， stream_context_get_options可以幫助你確認請求頭是否按預期被正確設置。

總結：

stream_context_get_options函數是一個非常強大的調試工具，它可以幫助開發者查看流上下文的設置。通過它，開發者可以在發送請求或進行文件操作時，快速查看上下文選項，以確保設置正確。

使用該函數時，記得打印出所有的上下文選項，特別是在調試網絡請求、文件讀取或寫入時。如果流配置沒有按預期工作，檢查上下文選項是排查問題的第一步。