萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 實現 FTP 上傳基礎範例:連線、登入、上傳三步驟

FTP 上傳核心流程

PHP 內建 FTP 擴展提供完整操作函數,實現檔案上傳僅需三步驟:連線 → 登入 → 上傳。

最小可行程式碼

<?php
// 1. 連線 FTP 伺服器
$ip   = '101.101.101.101';
$port = 21; // 預設 21,可省略
$conn = ftp_connect($ip, $port) or die('FTP 連線失敗');

// 2. 登入驗證
$name = 'username';
$pwd  = 'password';
if (!ftp_login($conn, $name, $pwd)) {
    die('FTP 登入失敗,請檢查帳號密碼');
}

// 3. 上傳檔案
$local_file  = 'test.php';           // 本地檔案路徑
$remote_file = 'ittest/test.php';    // 遠端相對路徑(相對 FTP 根目錄)
$mode        = FTP_ASCII;            // ASCII 模式(文字檔);二進位檔用 FTP_BINARY

if (ftp_put($conn, $remote_file, $local_file, $mode)) {
    echo "檔案上傳成功:$remote_file";
} else {
    echo "檔案上傳失敗";
}

// 關閉連線
ftp_close($conn);

關鍵函數說明

函數用途備註
ftp_connect()建立 FTP 連線支援指定 Port、逾時秒數
ftp_login()使用者驗證回傳 bool
ftp_put()上傳單一檔案模式:FTP_ASCII / FTP_BINARY
ftp_fput()上傳開啟的檔案指標適合大檔案流式上傳
ftp_pasv()設定被動模式穿透防火牆/NAT 必開:ftp_pasv($conn, true)
ftp_mkdir() / ftp_chdir()建立/切換遠端目錄上傳前確保目標目錄存在
ftp_close()關閉連線釋放資源

進階擴充建議

  • 表單上傳整合:結合 $_FILES 接收 HTTP 上傳,再轉 FTP 至儲存伺服器,實現前端直傳後端分發。
  • 錯誤處理與重試:封裝 ftp_put 為可重試函數,記錄失敗日誌。
  • SSL/TLS 加密:使用 ftp_ssl_connect() (需 OpenSSL 支援) 建立 FTPS 連線,保障傳輸安全。
  • 批量上傳:遞迴掃描本地目錄,配合 ftp_mkdir 對應建立遠端結構。

常見坑點提醒

  1. 防火牆封鎖 Port 20/21 或被動模式 Port 範圍 → 需開啟 ftp_pasv() 並配置伺服器被動 Port 範圍。
  2. 二進位檔(圖片、壓縮包、執行檔)務必用 FTP_BINARY,否則檔案損毀。
  3. FTP 根目錄權限:確保 FTP 使用者對目標目錄有寫入權限。
  4. 大檔案上傳逾時:調整 ftp_connect() 第三參數 $timeout 及 PHP max_execution_time。

掌握基礎 FTP 操作,是構建分散式檔案系統、自動化部署、跨伺服器同步的基石。

copyright © 萬盛學電腦網 all rights reserved