CodeIgniter 透過 SMTP 發送 HTML 郵件完整設定指南

CodeIgniter 內建 Email 類別支援多種協定，本文說明如何使用 SMTP 發送 HTML 格式郵件，並解決常見的雙引號跳脫、除錯模式等問題。

1. 設定檔 application/config/email.php

<?php
defined('BASEPATH') OR exit('No direct script access allowed');

$config['protocol']    = 'smtp';
$config['smtp_host']   = 'smtp.126.com';      // SMTP 伺服器
$config['smtp_user']   = 'your_email@126.com'; // 寄件帳號
$config['smtp_pass']   = 'your_password';      // 密碼或授權碼
$config['smtp_port']   = 25;                   // 或 465 (SSL), 587 (TLS)
$config['charset']     = 'utf-8';
$config['wordwrap']    = TRUE;
$config['mailtype']    = 'html';               // 關鍵：發送 HTML 郵件
$config['newline']     = "\r\n";               // 部分 SMTP 要求 CRLF
$config['crlf']        = "\r\n";

2. 控制器發送範例

public function send_html_mail() {
  $this->load->library('email');

  // 可選：覆蓋設定
  $this->email->initialize([
    'mailtype' => 'html',
    'charset'  => 'utf-8'
  ]);

  $this->email->from('your_email@126.com', '系統名稱');
  $this->email->to('recipient@example.com');
  $this->email->subject('HTML 郵件測試');
  
  $html_content = '
    
歡迎使用我們的服務
    
這是一封 HTML 格式 的測試郵件。
    點擊連結
  ';

  // 重要：移除 HTML 屬性中的雙引號，避免 CI 內部處理錯誤
  $html_content = str_replace('"', '', $html_content);
  
  $this->email->message($html_content);

  // 開發階段建議開啟除錯
  $this->email->print_debugger(['headers', 'subject', 'body']);

  if ($this->email->send()) {
    echo '發送成功';
  } else {
    show_error($this->email->print_debugger());
  }
}

常見問題與解決

建議

• 正式環境務必關閉 print_debugger，避免洩露帳號密碼。
• 大量發送請使用隊列（如 Redis + Worker）非同步處理，避免阻塞請求。
• 郵件內容盡量使用內聯 CSS，相容性最佳。