萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

PHP ftp_connect 失敗:php_network_getaddresses getaddrinfo failed 解決方案

錯誤訊息

PHP Warning: ftp_connect(): php_network_getaddresses: getaddrinfo failed in ...

常見原因

  1. 防火牆/iptables 封鎖 FTP 端口 (21):伺服器輸出/輸入規則未放行。
  2. 主機名解析失敗:DNS 解析異常、/etc/hosts 錯誤、主機名拼寫錯誤。
  3. FTP 服務未啟動:目標伺服器 vsftpd/proftpd 未運行。
  4. 被動模式端口範圍未開放:FTP 被動模式需額外開放高位端口範圍。

排查步驟

# 1. 測試連通性
telnet ftp.example.com 21
# 或
nc -zv ftp.example.com 21

# 2. 檢查本機防火牆
iptables -L -n | grep 21
# 開放 21
iptables -A INPUT -p tcp --dport 21 -j ACCEPT
iptables -A OUTPUT -p tcp --sport 21 -j ACCEPT

# 3. 檢查 DNS 解析
dig ftp.example.com
nslookup ftp.example.com

# 4. 檢查 FTP 服務狀態(目標機)
systemctl status vsftpd
# 或
service vsftpd status

PHP 代碼防禦性寫法

$conn = @ftp_connect('ftp.example.com', 21, 30); // 30 秒逾時
if (!$conn) {
    // 記錄詳細錯誤
    error_log('FTP 連線失敗: ' . error_get_last()['message']);
    // 可嘗試 IP 直連排除 DNS 問題
    $conn = @ftp_connect('203.0.113.10', 21, 30);
}
if ($conn) {
    $login = ftp_login($conn, $user, $pass);
    // 被動模式(穿透 NAT/防火牆)
    ftp_pasv($conn, true);
}

被動模式端口範圍設定(vsftpd.conf)

pasv_enable=YES
pasv_min_port=40000
pasv_max_port=40100
pasv_address=your.public.ip

對應防火牆需開放 40000:40100。

總結

  • 90% 以上案例為防火牆/安全組未放行端口。
  • 先用 telnet/nc 驗證 TCP 連通性,再檢查 PHP 代碼。
  • 生產環境建議改用 SFTP (SSH2),加密傳輸、單一端口 (22)、更易管理。
copyright © 萬盛學電腦網 all rights reserved