當前位置: 首頁> 最新文章列表> stream_notification_callback 與PHP 流上下文的關係，理解其作用與影響

stream_notification_callback 與PHP 流上下文的關係，理解其作用與影響

gitbox 2025-08-14

什麼是流上下文（Stream Context）？

流上下文在PHP 中用於配置流的屬性和行為。通過流上下文，開發者可以定義不同類型的流操作，指定流的讀取和寫入方式、資源打開方式等。流上下文實際上是一個包含流相關選項的數組或資源，PHP 使用它來設置與流操作相關的各種選項。

常見的流上下文設置包括：

  • stream.wrapper_data ：用於指定流包裝器的配置。

  • http ：用於設置HTTP 流的選項，如請求頭、代理服務器等。

  • ssl ：用於配置SSL 連接的相關選項，如證書、密碼等。

例如，創建一個流上下文的代碼如下：

 <span><span><span class="hljs-variable">$options</span></span><span> = </span><span><span class="hljs-keyword">array</span></span><span>(
    </span><span><span class="hljs-string">"http"</span></span><span> =&gt; </span><span><span class="hljs-keyword">array</span></span><span>(
        </span><span><span class="hljs-string">"method"</span></span><span>  =&gt; </span><span><span class="hljs-string">"GET"</span></span><span>,
        </span><span><span class="hljs-string">"header"</span></span><span>  =&gt; </span><span><span class="hljs-string">"Accept-language: en\r\n"</span></span><span>
    )
);
</span><span><span class="hljs-variable">$context</span></span><span> = </span><span><span class="hljs-title function_ invoke__">stream_context_create</span></span><span>(</span><span><span class="hljs-variable">$options</span></span><span>);
</span></span>

流上下文通過stream_context_create()函數創建，並可以在文件操作或網絡流操作中使用。

stream_notification_callback的作用

stream_notification_callback是PHP 中與流相關的一個回調函數。這個函數用於接收和處理流操作中的通知。當流操作涉及到一些特殊事件時（例如文件打開失敗、網絡連接中斷等），PHP 可以通過回調函數通知開發者。其基本語法如下：

 <span><span><span class="hljs-title function_ invoke__">stream_context_set_option</span></span><span>(</span><span><span class="hljs-variable">$context</span></span><span>, </span><span><span class="hljs-string">"notification"</span></span><span>, </span><span><span class="hljs-string">"callback"</span></span><span>, </span><span><span class="hljs-string">"stream_notification_callback"</span></span><span>);
</span></span>

stream_notification_callback接收一個包含通知信息的參數，允許開發者根據流操作的不同狀態做出反應。

參數說明：

  • resource $stream ：表示與當前通知相關的流資源。

  • int $notification_code ：通知的類型，通過常量來表示，如STREAM_NOTIFY_CONNECT 、 STREAM_NOTIFY_DISCONNECT等。

  • int $ severity ：通知的嚴重程度，通常為一個整數，越高表示問題越嚴重。

  • string $message ：通知的消息，提供有關當前流狀態的信息。

回調函數的作用是讓開發者能夠捕捉和響應這些通知。例如，當某個流連接失敗時，開發者可以在回調函數中捕獲這一信息，並採取相應的措施，如重試連接、記錄錯誤日誌等。

stream_notification_callback與流上下文的關係

stream_notification_callback與流上下文之間有著緊密的聯繫。正是通過流上下文中的回調設置，開發者才能將stream_notification_callback作為一個處理流通知的機制集成到流操作中。具體來說， stream_context_set_option函數允許開發者在流上下文中為通知事件設置回調函數。

例如，在創建一個網絡流並設置回調函數時，開發者可以使用以下代碼：

 <span><span><span class="hljs-variable">$options</span></span><span> = </span><span><span class="hljs-keyword">array</span></span><span>(
    </span><span><span class="hljs-string">"notification"</span></span><span> =&gt; </span><span><span class="hljs-keyword">array</span></span><span>(
        </span><span><span class="hljs-string">"callback"</span></span><span> =&gt; </span><span><span class="hljs-string">"stream_notification_callback"</span></span><span>
    )
);
</span><span><span class="hljs-variable">$context</span></span><span> = </span><span><span class="hljs-title function_ invoke__">stream_context_create</span></span><span>(</span><span><span class="hljs-variable">$options</span></span><span>);
</span><span><span class="hljs-variable">$fp</span></span><span> = </span><span><span class="hljs-title function_ invoke__">stream_socket_client</span></span><span>(</span><span><span class="hljs-string">"tcp://example.com:80"</span></span><span>, </span><span><span class="hljs-variable">$errno</span></span><span>, </span><span><span class="hljs-variable">$errstr</span></span><span>, </span><span><span class="hljs-number">30</span></span><span>, STREAM_CLIENT_CONNECT, </span><span><span class="hljs-variable">$context</span></span><span>);
</span></span>

在上述代碼中， stream_socket_client()函數打開了一個TCP 連接，並將自定義的回調函數綁定到流上下文中。這樣，如果在連接過程中發生任何通知事件，PHP 將自動調用stream_notification_callback 。

常見通知類型

PHP 的stream_notification_callback可以捕獲多種類型的通知，以下是一些常見的通知類型及其含義：

  • STREAM_NOTIFY_CONNECT ：表示流已成功連接。

  • STREAM_NOTIFY_DISCONNECT ：表示流已斷開連接。

  • STREAM_NOTIFY_FAILURE ：表示流操作失敗。

  • STREAM_NOTIFY_AUTH_REQUIRED ：表示流操作需要認證信息。

開發者可以根據這些通知類型來編寫特定的響應邏輯。例如，遇到連接失敗時，可以嘗試重新連接；遇到認證請求時，可以提供認證憑證等。

相關內容