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 為可重試函數,記錄失敗日誌。ftp_ssl_connect() (需 OpenSSL 支援) 建立 FTPS 連線,保障傳輸安全。ftp_mkdir 對應建立遠端結構。ftp_pasv() 並配置伺服器被動 Port 範圍。FTP_BINARY,否則檔案損毀。ftp_connect() 第三參數 $timeout 及 PHP max_execution_time。掌握基礎 FTP 操作,是構建分散式檔案系統、自動化部署、跨伺服器同步的基石。