萬盛學電腦網

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

PHP 連線 IMAP/POP3/NNTP 與 FTP 伺服器完整實作教學

前言

PHP 內建 IMAP 與 FTP 擴充功能,支援郵件伺服器操作與檔案傳輸。本文完整示範:IMAP/POP3/NNTP 連線、郵件讀取、發送郵件、FTP 連線、上傳/下載/刪除/取得檔案大小,並說明安全與錯誤處理要點。

一、IMAP 郵件伺服器操作

1. 連線各種協定

<?php
// IMAP (port 143)
$mbox = imap_open('{mail.example.com:143/imap}INBOX', 'username', 'password');

// POP3 (port 110)
$mbox = imap_open('{mail.example.com:110/pop3}INBOX', 'username', 'password');

// NNTP 新聞群組 (port 119)
$nntp = imap_open('{news.example.com:119/nntp}comp.lang.php', '', '');

// SSL 加密連線 (IMAPS 993, POP3S 995)
$mbox = imap_open('{mail.example.com:993/imap/ssl}INBOX', 'username', 'password');

if (!$mbox) {
    die('連線失敗: ' . imap_last_error());
}
?>

2. 列出信箱資料夾

<?php
$mbox = imap_open('{imap.example.com:993/imap/ssl}', 'user', 'pass', OP_HALFOPEN)
    or die('連線失敗: ' . imap_last_error());

$folders = imap_getmailboxes($mbox, '{imap.example.com:993/imap/ssl}', '*');
if (is_array($folders)) {
    foreach ($folders as $folder) {
        echo "({$folder->attributes}) ";
        echo imap_utf7_decode($folder->name) . ", ";
        echo "分隔符: '{$folder->delimiter}'<br>";
    }
} else {
    echo "取得信箱列表失敗: " . imap_last_error();
}
imap_close($mbox);
?>

3. 讀取郵件基本資訊

<?php
$mbox = imap_open('{imap.example.com:993/imap/ssl}INBOX', 'user', 'pass');
$count = imap_num_msg($mbox);

for ($i = 1; $i <= min($count, 10); $i++) {
    $header = imap_headerinfo($mbox, $i);
    echo "主旨: " . imap_utf8($header->subject) . "<br>";
    echo "寄件者: " . $header->from[0]->mailbox . "@{$header->from[0]->host}<br>";
    echo "日期: " . date('Y-m-d H:i:s', $header->udate) . "<br><br>";
}
imap_close($mbox);
?>

二、郵件發送:mail() 函數

<?php
$to      = 'user@example.com';
$subject = '歡迎註冊';
$message = "親愛的會員,\n\n感謝您註冊本站服務。\n\n祝您愉快!";
$headers = "From: noreply@example.com\r\n" .
           "Reply-To: support@example.com\r\n" .
           "Content-Type: text/plain; charset=UTF-8\r\n" .
           "X-Mailer: PHP/" . phpversion();

if (mail($to, $subject, $message, $headers)) {
    echo "郵件發送成功";
} else {
    echo "郵件發送失敗";
}

// 注意:mail() 依賴本機 MTA (sendmail/postfix),生產環境建議用 SMTP 函式庫
// 推薦:PHPMailer、Symfony Mailer、SwiftMailer
?>

三、FTP 檔案傳輸完整實作

1. 連線與登入

<?php
$ftpServer = 'ftp.example.com';
$ftpUser   = 'username';
$ftpPass   = 'password';

$conn = ftp_connect($ftpServer) or die('無法連線 FTP 伺服器');
$login = ftp_login($conn, $ftpUser, $ftpPass) or die('FTP 登入失敗');

// 被動模式(穿透防火牆/NAT 必須)
ftp_pasv($conn, true);

echo "FTP 連線成功<br>";
?>

2. 上傳檔案

<?php
$localFile  = '/path/to/local/file.txt';
$remoteFile = 'uploads/file.txt';

if (ftp_put($conn, $remoteFile, $localFile, FTP_BINARY)) {
    echo "上傳成功: {$remoteFile}<br>";
} else {
    echo "上傳失敗<br>";
}

// 大檔案可用 ftp_fput 搭配檔案指標分塊上傳
$fp = fopen($localFile, 'r');
ftp_fput($conn, $remoteFile, $fp, FTP_BINARY);
fclose($fp);
?>

3. 下載檔案

<?php
$remoteFile = 'uploads/large.zip';
$localFile  = '/tmp/large.zip';

if (ftp_get($conn, $localFile, $remoteFile, FTP_BINARY)) {
    echo "下載成功: {$localFile}<br>";
} else {
    echo "下載失敗<br>";
}
?>

4. 刪除檔案

<?php
$file = 'uploads/old.txt';
if (ftp_delete($conn, $file)) {
    echo "刪除成功: {$file}<br>";
} else {
    echo "刪除失敗(檔案不存在或權限不足)<br>";
}
?>

5. 取得遠端檔案大小

<?php
$file = 'uploads/data.pdf';
$size = ftp_size($conn, $file);

if ($size !== -1) {
    echo "檔案大小: {$size} bytes (" . round($size/1024, 2) . " KB)<br>";
} else {
    echo "無法取得檔案大小(可能不存在或權限不足)<br>";
}
?>

6. 關閉連線

<?php
ftp_close($conn);
?>

四、FTP 完整封裝類別範例

<?php
class FtpClient {
    private $conn;
    private $connected = false;

    public function connect($host, $user, $pass, $port = 21, $timeout = 30) {
        $this->conn = @ftp_connect($host, $port, $timeout);
        if (!$this->conn) throw new Exception("無法連線 $host:$port");
        
        if (!@ftp_login($this->conn, $user, $pass)) {
            throw new Exception("FTP 登入失敗");
        }
        ftp_pasv($this->conn, true);
        $this->connected = true;
    }

    public function upload($local, $remote, $mode = FTP_BINARY) {
        $this->checkConn();
        return ftp_put($this->conn, $remote, $local, $mode);
    }

    public function download($remote, $local, $mode = FTP_BINARY) {
        $this->checkConn();
        return ftp_get($this->conn, $local, $remote, $mode);
    }

    public function delete($remote) {
        $this->checkConn();
        return ftp_delete($this->conn, $remote);
    }

    public function fileSize($remote) {
        $this->checkConn();
        return ftp_size($this->conn, $remote);
    }

    public function listFiles($dir = '.') {
        $this->checkConn();
        return ftp_nlist($this->conn, $dir);
    }

    public function close() {
        if ($this->connected) {
            ftp_close($this->conn);
            $this->connected = false;
        }
    }

    private function checkConn() {
        if (!$this->connected) throw new Exception('FTP 未連線');
    }

    public function __destruct() {
        $this->close();
    }
}

// 使用
$ftp = new FtpClient();
$ftp->connect('ftp.example.com', 'user', 'pass');
$ftp->upload('local.txt', 'remote.txt');
$ftp->close();
?>

安全與最佳實踐

  1. 強制使用 FTPS (FTP over SSL/TLS):ftp_ssl_connect() + ftp_login()
  2. 被動模式:ftp_pasv(true) 解決防火牆/NAT 連線問題
  3. 二進位模式:預設用 FTP_BINARY,避免文字模式換行符轉換損壞二進位檔
  4. 錯誤處理:所有 FTP 函數回傳 false 時檢查 ftp_error()(需 PHP 7.1+)或自行記錄
  5. 權限最小化:FTP 帳號僅開放必要目錄讀寫權限
copyright © 萬盛學電腦網 all rights reserved