哪些常見場景下適合用stream_socket_shutdown 來關閉PHP 的socket 連接？

M66 2025-06-22

在PHP 中，使用socket 進行網絡通信時，關閉連接的方式有很多種。其中， stream_socket_shutdown函數是一種常見的方式，它允許開發者更精細地控制socket 的關閉過程。了解stream_socket_shutdown的作用及其適用場景，對於提高代碼的健壯性和性能至關重要。

什麼是stream_socket_shutdown ？

stream_socket_shutdown是PHP 中用於關閉socket 連接的一種方法。與簡單的fclose()或socket_close()不同，它提供了更多的控制選項，允許開發者選擇是否關閉讀寫操作，或者完全關閉連接。函數原型如下：

 <span><span><span class="hljs-keyword">bool</span></span><span> </span><span><span class="hljs-title function_ invoke__">stream_socket_shutdown</span></span><span>(resource </span><span><span class="hljs-variable">$socket</span></span><span>, </span><span><span class="hljs-keyword">int</span></span><span> </span><span><span class="hljs-variable">$how</span></span><span>);
</span></span>

$socket ：表示待關閉的socket 資源。
$how ：控制關閉的操作類型。可以是以下幾種：
- STREAM_SHUT_RD ：只關閉讀取操作，保持寫入功能。
- STREAM_SHUT_WR ：只關閉寫入操作，保持讀取功能。
- STREAM_SHUT_RDWR ：同時關閉讀取和寫入操作，完全關閉連接。

適用場景

1. 單向通信時關閉寫操作

在某些應用場景中，客戶端或服務器在發送完數據後不再需要寫入，只需等待對方的響應。例如，HTTP 請求完成後，客戶端不再發送數據，只需要等待服務器返迴響應。這時可以使用stream_socket_shutdown來關閉寫操作，減少資源消耗，提升性能。

示例代碼：

 <span><span><span class="hljs-variable">$socket</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-title function_ invoke__">fwrite</span></span><span>(</span><span><span class="hljs-variable">$socket</span></span><span>, </span><span><span class="hljs-string">"GET / HTTP/1.1\r\nHost: example.com\r\n\r\n"</span></span><span>);

</span><span><span class="hljs-comment">// 發送完請求後關閉寫操作，不再發送數據</span></span><span>
</span><span><span class="hljs-title function_ invoke__">stream_socket_shutdown</span></span><span>(</span><span><span class="hljs-variable">$socket</span></span><span>, STREAM_SHUT_WR);

</span><span><span class="hljs-comment">// 讀取服務器響應</span></span><span>
</span><span><span class="hljs-variable">$response</span></span><span> = </span><span><span class="hljs-title function_ invoke__">fread</span></span><span>(</span><span><span class="hljs-variable">$socket</span></span><span>, </span><span><span class="hljs-number">1024</span></span><span>);

</span><span><span class="hljs-title function_ invoke__">fclose</span></span><span>(</span><span><span class="hljs-variable">$socket</span></span><span>);
</span></span>

在這個例子中，客戶端已經發送完HTTP 請求，不再需要向服務器寫入數據，所以調用stream_socket_shutdown關閉寫操作。

2. 只讀取數據時關閉寫操作

在某些應用中，客戶端或服務器可能只需要從對方讀取數據，而不再發送數據。此時，可以使用stream_socket_shutdown來關閉寫操作，確保連接不再消耗無謂的寫資源。例如，FTP 協議的某些模式下，客戶端和服務器只需要進行數據讀取，而不需要再進行寫操作。

示例代碼：

 <span><span><span class="hljs-variable">$socket</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:21"</span></span><span>);

</span><span><span class="hljs-title function_ invoke__">fwrite</span></span><span>(</span><span><span class="hljs-variable">$socket</span></span><span>, </span><span><span class="hljs-string">"USER anonymous\r\n"</span></span><span>);
</span><span><span class="hljs-title function_ invoke__">fwrite</span></span><span>(</span><span><span class="hljs-variable">$socket</span></span><span>, </span><span><span class="hljs-string">"PASS anonymous\r\n"</span></span><span>);

</span><span><span class="hljs-comment">// 不再發送數據，關閉寫操作</span></span><span>
</span><span><span class="hljs-title function_ invoke__">stream_socket_shutdown</span></span><span>(</span><span><span class="hljs-variable">$socket</span></span><span>, STREAM_SHUT_WR);

</span><span><span class="hljs-comment">// 讀取服務器返回的響應</span></span><span>
</span><span><span class="hljs-variable">$response</span></span><span> = </span><span><span class="hljs-title function_ invoke__">fread</span></span><span>(</span><span><span class="hljs-variable">$socket</span></span><span>, </span><span><span class="hljs-number">1024</span></span><span>);

</span><span><span class="hljs-title function_ invoke__">fclose</span></span><span>(</span><span><span class="hljs-variable">$socket</span></span><span>);
</span></span>

通過關閉寫操作，可以減少不必要的資源佔用，保證通信過程更高效。

3. 雙向通信完成後的連接關閉

對於一些需要雙向通信的應用，如實時聊天系統或者網絡遊戲，通常會在客戶端或服務器端完成數據交換後，調用stream_socket_shutdown來徹底關閉連接，釋放所有相關資源。使用STREAM_SHUT_RDWR關閉連接，確保讀取和寫入操作都被妥善結束。

示例代碼：

 <span><span><span class="hljs-variable">$socket</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:12345"</span></span><span>);

</span><span><span class="hljs-comment">// 進行雙向數據交換</span></span><span>
</span><span><span class="hljs-title function_ invoke__">fwrite</span></span><span>(</span><span><span class="hljs-variable">$socket</span></span><span>, </span><span><span class="hljs-string">"Hello Server!"</span></span><span>);
</span><span><span class="hljs-variable">$response</span></span><span> = </span><span><span class="hljs-title function_ invoke__">fread</span></span><span>(</span><span><span class="hljs-variable">$socket</span></span><span>, </span><span><span class="hljs-number">1024</span></span><span>);

</span><span><span class="hljs-comment">// 完成雙向通信後徹底關閉連接</span></span><span>
</span><span><span class="hljs-title function_ invoke__">stream_socket_shutdown</span></span><span>(</span><span><span class="hljs-variable">$socket</span></span><span>, STREAM_SHUT_RDWR);

</span><span><span class="hljs-title function_ invoke__">fclose</span></span><span>(</span><span><span class="hljs-variable">$socket</span></span><span>);
</span></span>

此時，雙方都已經不再需要繼續通信，調用stream_socket_shutdown關閉讀取和寫入操作，確保socket 連接完全關閉。

4. 網絡中斷或錯誤處理

在一些特殊的情況下，網絡連接可能因異常中斷或錯誤需要被關閉。使用stream_socket_shutdown可以更細粒度地控制socket 的關閉過程。例如，如果發生網絡中斷或應用程序異常，可以選擇性地關閉讀取或寫入操作，防止繼續佔用資源。

示例代碼：

 <span><span><span class="hljs-variable">$socket</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-keyword">if</span></span><span> (!</span><span><span class="hljs-variable">$socket</span></span><span>) {
    </span><span><span class="hljs-keyword">die</span></span><span>(</span><span><span class="hljs-string">"Unable to connect to server"</span></span><span>);
}

</span><span><span class="hljs-comment">// 假設某些錯誤發生，停止數據寫入</span></span><span>
</span><span><span class="hljs-title function_ invoke__">stream_socket_shutdown</span></span><span>(</span><span><span class="hljs-variable">$socket</span></span><span>, STREAM_SHUT_WR);

</span><span><span class="hljs-comment">// 繼續讀取錯誤信息或者通知用戶</span></span><span>
</span><span><span class="hljs-variable">$response</span></span><span> = </span><span><span class="hljs-title function_ invoke__">fread</span></span><span>(</span><span><span class="hljs-variable">$socket</span></span><span>, </span><span><span class="hljs-number">1024</span></span><span>);

</span><span><span class="hljs-title function_ invoke__">fclose</span></span><span>(</span><span><span class="hljs-variable">$socket</span></span><span>);
</span></span>

在這裡，出現異常或錯誤時，我們通過關閉寫操作，避免進一步嘗試寫入數據，減輕對服務器的影響。

5. 實現超時機制

有些應用可能需要實現超時機制，即在連接長時間沒有響應時主動關閉socket 連接。在這種情況下， stream_socket_shutdown可以用來關閉不再需要的連接，從而避免等待死鎖或長時間佔用網絡資源。

示例代碼：

 <span><span><span class="hljs-variable">$socket</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>);

</span><span><span class="hljs-keyword">if</span></span><span> (!</span><span><span class="hljs-variable">$socket</span></span><span>) {
    </span><span><span class="hljs-keyword">die</span></span><span>(</span><span><span class="hljs-string">"Unable to connect: <span class="hljs-subst">$errstr</span></span></span><span> (</span><span><span class="hljs-subst">$errno</span></span><span>)");
}

</span><span><span class="hljs-comment">// 設置超時機制，超時後關閉連接</span></span><span>
</span><span><span class="hljs-title function_ invoke__">stream_set_timeout</span></span><span>(</span><span><span class="hljs-variable">$socket</span></span><span>, </span><span><span class="hljs-number">10</span></span><span>); </span><span><span class="hljs-comment">// 設置超時時間為10秒</span></span><span>
</span><span><span class="hljs-variable">$response</span></span><span> = </span><span><span class="hljs-title function_ invoke__">fread</span></span><span>(</span><span><span class="hljs-variable">$socket</span></span><span>, </span><span><span class="hljs-number">1024</span></span><span>);

</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-title function_ invoke__">feof</span></span><span>(</span><span><span class="hljs-variable">$socket</span></span><span>)) {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"Connection timed out or completed.\n"</span></span><span>;
    </span><span><span class="hljs-title function_ invoke__">stream_socket_shutdown</span></span><span>(</span><span><span class="hljs-variable">$socket</span></span><span>, STREAM_SHUT_RDWR);
}

</span><span><span class="hljs-title function_ invoke__">fclose</span></span><span>(</span><span><span class="hljs-variable">$socket</span></span><span>);
</span></span>

在這個例子中，如果連接在10 秒內沒有響應， stream_socket_shutdown會被調用來關閉連接。

總結

stream_socket_shutdown在PHP 中是一個非常有用的函數，能夠提供對socket 連接關閉的細粒度控制。它適用於多種場景，包括單向通信時關閉寫操作、雙向通信完成後的連接關閉、網絡異常處理等。了解其使用方式，能夠幫助開發者更有效地管理網絡資源，提高應用的穩定性和性能。