如何使用socket_set_option 設置SO_REUSEADDR 來解決端口被佔用的問題？

gitbox 2025-06-15

如何使用socket_set_option設置SO_REUSEADDR來解決端口被佔用的問題？

在開發基於PHP 的網絡應用時，尤其是需要綁定特定端口進行監聽的服務（如HTTP 服務器、Socket 服務等），遇到“端口已被佔用”問題是很常見的。這個問題通常發生在服務停止後，操作系統依然認為該端口被佔用，從而導致無法重新啟動服務並綁定端口。

為了有效解決這個問題，PHP 提供了socket_set_option函數，可以用來設置各種Socket 選項。其中， SO_REUSEADDR是一個常用的選項，可以幫助我們解決端口占用的問題。本文將詳細介紹如何使用socket_set_option設置SO_REUSEADDR ，以便在服務重啟時能夠重新綁定已經使用過的端口。

1. 什麼是SO_REUSEADDR ？

SO_REUSEADDR是一個Socket 選項，它允許一個端口在處於TIME_WAIT狀態時仍然可以被綁定。操作系統通常會將一個端口的狀態設置為TIME_WAIT ，以確保所有數據包都已經清理完畢。然而，系統在TIME_WAIT狀態下會阻止其他進程綁定該端口。設置SO_REUSEADDR後，可以讓你在端口尚處於TIME_WAIT狀態時重新綁定該端口。

2. 使用socket_set_option設置SO_REUSEADDR

在PHP 中， socket_set_option函數用於設置一個已經創建的Socket 的選項。語法如下：

 <span><span><span class="hljs-keyword">bool</span></span><span> </span><span><span class="hljs-title function_ invoke__">socket_set_option</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">$level</span></span><span> , </span><span><span class="hljs-keyword">int</span></span><span> </span><span><span class="hljs-variable">$optname</span></span><span> , </span><span><span class="hljs-keyword">mixed</span></span><span> </span><span><span class="hljs-variable">$optval</span></span><span> )
</span></span>

$socket ：要設置選項的Socket 資源。
$level ：協議層，通常為SOL_SOCKET ，表示操作的是套接字級別的選項。
$optname ：選項名稱，對於SO_REUSEADDR ，這個值為SO_REUSEADDR （通常是1 ）。
$optval ：選項值，對於SO_REUSEADDR ，這個值通常為1 ，表示啟用該選項。

3. 示例代碼

以下是一個簡單的PHP 示例，演示瞭如何使用socket_set_option來設置SO_REUSEADDR選項，從而避免端口被佔用的問題。

 <span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-comment">// 創建一個 TCP socket</span></span><span>
</span><span><span class="hljs-variable">$socket</span></span><span> = </span><span><span class="hljs-title function_ invoke__">socket_create</span></span><span>(AF_INET, SOCK_STREAM, SOL_TCP);
</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-literal">false</span></span><span>) {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"Socket 創建失敗: "</span></span><span> . </span><span><span class="hljs-title function_ invoke__">socket_strerror</span></span><span>(</span><span><span class="hljs-title function_ invoke__">socket_last_error</span></span><span>()) . </span><span><span class="hljs-string">"\n"</span></span><span>;
    </span><span><span class="hljs-keyword">exit</span></span><span>;
}

</span><span><span class="hljs-comment">// 設定 SO_REUSEADDR 選項</span></span><span>
</span><span><span class="hljs-variable">$optval</span></span><span> = </span><span><span class="hljs-number">1</span></span><span>;
</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-title function_ invoke__">socket_set_option</span></span><span>(</span><span><span class="hljs-variable">$socket</span></span><span>, SOL_SOCKET, SO_REUSEADDR, </span><span><span class="hljs-variable">$optval</span></span><span>) === </span><span><span class="hljs-literal">false</span></span><span>) {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"設定 SO_REUSEADDR 選項失败: "</span></span><span> . </span><span><span class="hljs-title function_ invoke__">socket_strerror</span></span><span>(</span><span><span class="hljs-title function_ invoke__">socket_last_error</span></span><span>(</span><span><span class="hljs-variable">$socket</span></span><span>)) . </span><span><span class="hljs-string">"\n"</span></span><span>;
    </span><span><span class="hljs-keyword">exit</span></span><span>;
}

</span><span><span class="hljs-comment">// 綁定到指定的 IP 和端口</span></span><span>
</span><span><span class="hljs-variable">$host</span></span><span> = </span><span><span class="hljs-string">'127.0.0.1'</span></span><span>;
</span><span><span class="hljs-variable">$port</span></span><span> = </span><span><span class="hljs-number">8080</span></span><span>;
</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-title function_ invoke__">socket_bind</span></span><span>(</span><span><span class="hljs-variable">$socket</span></span><span>, </span><span><span class="hljs-variable">$host</span></span><span>, </span><span><span class="hljs-variable">$port</span></span><span>) === </span><span><span class="hljs-literal">false</span></span><span>) {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"綁定失敗: "</span></span><span> . </span><span><span class="hljs-title function_ invoke__">socket_strerror</span></span><span>(</span><span><span class="hljs-title function_ invoke__">socket_last_error</span></span><span>(</span><span><span class="hljs-variable">$socket</span></span><span>)) . </span><span><span class="hljs-string">"\n"</span></span><span>;
    </span><span><span class="hljs-keyword">exit</span></span><span>;
}

</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"Socket 成功綁定到 <span class="hljs-subst">$host</span></span></span><span>:</span><span><span class="hljs-subst">$port</span></span><span>\n";

</span><span><span class="hljs-comment">// 監聽端口</span></span><span>
</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-title function_ invoke__">socket_listen</span></span><span>(</span><span><span class="hljs-variable">$socket</span></span><span>) === </span><span><span class="hljs-literal">false</span></span><span>) {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"監聽失敗: "</span></span><span> . </span><span><span class="hljs-title function_ invoke__">socket_strerror</span></span><span>(</span><span><span class="hljs-title function_ invoke__">socket_last_error</span></span><span>(</span><span><span class="hljs-variable">$socket</span></span><span>)) . </span><span><span class="hljs-string">"\n"</span></span><span>;
    </span><span><span class="hljs-keyword">exit</span></span><span>;
}

</span><span><span class="hljs-comment">// 等待連接</span></span><span>
</span><span><span class="hljs-variable">$clientSocket</span></span><span> = </span><span><span class="hljs-title function_ invoke__">socket_accept</span></span><span>(</span><span><span class="hljs-variable">$socket</span></span><span>);
</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$clientSocket</span></span><span> === </span><span><span class="hljs-literal">false</span></span><span>) {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"接收客戶端連接失敗: "</span></span><span> . </span><span><span class="hljs-title function_ invoke__">socket_strerror</span></span><span>(</span><span><span class="hljs-title function_ invoke__">socket_last_error</span></span><span>(</span><span><span class="hljs-variable">$socket</span></span><span>)) . </span><span><span class="hljs-string">"\n"</span></span><span>;
    </span><span><span class="hljs-keyword">exit</span></span><span>;
}

</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"有客戶端連接進來！\n"</span></span><span>;

</span><span><span class="hljs-comment">// 關閉連接</span></span><span>
</span><span><span class="hljs-title function_ invoke__">socket_close</span></span><span>(</span><span><span class="hljs-variable">$clientSocket</span></span><span>);
</span><span><span class="hljs-title function_ invoke__">socket_close</span></span><span>(</span><span><span class="hljs-variable">$socket</span></span><span>);
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

4. 代碼說明

創建Socket ：我們使用socket_create函數創建了一個TCP Socket。該函數返回一個資源，表示創建的Socket。如果創建失敗，則返回false 。
設置SO_REUSEADDR選項：我們通過socket_set_option設置了SO_REUSEADDR ，使得在端口處於TIME_WAIT狀態時，仍然能夠重新綁定端口。
綁定端口：使用socket_bind函數將創建的Socket 綁定到指定的IP 地址和端口上。如果綁定失敗，程序會輸出錯誤信息。
監聽端口： socket_listen函數用於監聽綁定的端口，準備接受客戶端連接。
接收客戶端連接： socket_accept會等待並接受客戶端連接。

5. 總結

通過使用socket_set_option設置SO_REUSEADDR選項，可以有效解決端口被佔用的問題，尤其在服務重啟時尤為重要。這個選項讓你能夠在端口處於TIME_WAIT狀態時重新綁定端口，避免了常見的“端口已被佔用”錯誤。

需要注意的是， SO_REUSEADDR選項並不會讓你完全繞過操作系統的端口使用規則，它主要解決的是端口處於TIME_WAIT狀態時的情況。如果你在其他場景下遇到端口被佔用的問題，可能需要考慮更複雜的網絡配置或進程管理策略。