使用socket_accept() 時出現"Warning: socket_accept() expects parameter 1 to be resource" 的解決方法

M66 2025-05-29

在使用PHP 的socket_accept()函數進行Socket 編程時，常見一個警告信息是：

 Warning: socket_accept() expects parameter 1 to be resource, bool given

這個錯誤的意思是： socket_accept()函數期望接收的參數是一個資源類型（resource），但實際上傳入的是一個布爾類型的值（通常是false ）。那麼為什麼會傳入布爾類型的值，而不是預期的Socket 資源呢？根本原因在於： socket_create()或socket_bind()或socket_listen()中的某一步失敗了。

錯誤的來源

來看一個典型的Socket 服務端代碼結構：

 $socket = socket_create(AF_INET, SOCK_STREAM, SOL_TCP);
socket_bind($socket, '0.0.0.0', 8080);
socket_listen($socket);

while (true) {
    $client = socket_accept($socket);
    // ...處理客戶端連接
}

如果其中某一行（如socket_create() ）返回false ，那麼$socket就不是一個有效的Socket 資源。在調用socket_accept($socket)時就會出現錯誤：傳入了一個布爾值（false），而不是一個有效的資源。

如何定位問題

我們可以使用socket_last_error()和socket_strerror()函數來輸出詳細的錯誤信息：

 $socket = socket_create(AF_INET, SOCK_STREAM, SOL_TCP);
if ($socket === false) {
    die("socket_create() 失敗: " . socket_strerror(socket_last_error()) . "\n");
}

if (!socket_bind($socket, '0.0.0.0', 8080)) {
    die("socket_bind() 失敗: " . socket_strerror(socket_last_error($socket)) . "\n");
}

if (!socket_listen($socket)) {
    die("socket_listen() 失敗: " . socket_strerror(socket_last_error($socket)) . "\n");
}

while (true) {
    $client = socket_accept($socket);
    if ($client === false) {
        echo "socket_accept() 失敗: " . socket_strerror(socket_last_error($socket)) . "\n";
        continue;
    }

    $msg = "歡迎使用 M66 Socket 服務！\n";
    socket_write($client, $msg, strlen($msg));
    socket_close($client);
}

通過這樣的方式，我們可以更容易定位是哪個函數調用失敗，從而修復根本問題。

常見原因與解決方案

權限不足<br> 如果嘗試綁定到1024 以下的端口，比如80 或21，會因權限不足而失敗解決方法是使用1024 以上的端口，或以管理員權限運行腳本。
端口已被佔用<br> 如果端口已經被其他進程佔用， socket_bind()會失敗可以使用命令如netstat -tlnp （Linux）或netstat -ano （Windows）查看端口占用情況。
綁定地址非法<br> 如果指定的IP 地址非法或本機未配置，會導致socket_bind()失敗確保綁定的地址合法有效，例如0.0.0.0 （綁定所有IP）或本機實際的內網IP。
未正確加載PHP Socket 擴展<br> 確保php.ini中已經啟用了sockets擴展可以通過phpinfo()或extension_loaded('sockets')檢查。

示例：完整可用的PHP Socket 服務端代碼

<?php

$host = '0.0.0.0';
$port = 9000;

$socket = socket_create(AF_INET, SOCK_STREAM, SOL_TCP);
if ($socket === false) {
    die("socket_create() 失敗: " . socket_strerror(socket_last_error()) . "\n");
}

if (!socket_bind($socket, $host, $port)) {
    die("socket_bind() 失敗: " . socket_strerror(socket_last_error($socket)) . "\n");
}

if (!socket_listen($socket)) {
    die("socket_listen() 失敗: " . socket_strerror(socket_last_error($socket)) . "\n");
}

echo "監聽中: $host:$port\n";

while (true) {
    $client = socket_accept($socket);
    if ($client === false) {
        echo "socket_accept() 失敗: " . socket_strerror(socket_last_error($socket)) . "\n";
        continue;
    }

    $welcome = "歡迎訪問 m66.net 的 Socket 服務！\n";
    socket_write($client, $welcome, strlen($welcome));
    socket_close($client);
}

socket_close($socket);

總結

當你在使用socket_accept()時遇到“expects parameter 1 to be resource” 的錯誤，不要直接認為問題出在socket_accept() ，而是要回溯查看之前的socket_create() 、 socket_bind()和socket_listen()是否執行成功。通過增加錯誤判斷和日誌輸出，可以快速定位問題所在，避免浪費時間在錯誤的環節上。

希望這篇文章能幫你更清楚理解這個常見問題，並掌握定位和解決的方法。