[AWS] SES SMTP 메일 발송하기 PHP Mailer

조회 154회 댓글 0건

SMTP를 이용한 메일은 PHP mail 함수를 통해 발송 시키는 가장 일반적인 방식 입니다.

여기선 AWS SDK가 아니라 STMP 설정을 통해서 메일을 발송 시키는데 PHP에서 가장 잘 만들어진 PHPMailer 라이브러리를 이용 합니다.

● AWS SMTP 서버 활용 메일 발송 - 파일 첨부와 한글 사용

1) SMTP 설정 -> SMTP 보안 인증 생성 -> user와 password를 생성

2) 구성 -> 자격증명 -> 도메인 인증 , 메일인증

프로덕션 모드 이전일때는 보내고 받는 메일 모두 인증 해야 한다.

3) 한글 사용을 위해선 헤더 부분을 변경해 줘야 한다.

  # https://github.com/PHPMailer/PHPMailer

  # composer require phpmailer/phpmailer

  //Import PHPMailer classes into the global namespace

  //These must be at the top of your script, not inside a function

  use PHPMailer\PHPMailer\PHPMailer;

  use PHPMailer\PHPMailer\SMTP;

  use PHPMailer\PHPMailer\Exception;

  //Load Composer's autoloader

  require 'vendor/autoload.php';

  //Create an instance; passing `true` enables exceptions

  $mail = new PHPMailer(true);

  # AWS SMTP 서버 활용 메일 발송 - 파일 첨부와 한글 사용

  # 1) SMTP 설정 -> SMTP 보안 인증 생성 -> user와 password를 생성 

  # 2) 구성 -> 자격증명 -> 도메인 인증 , 메일인증 

  #    프로덕션 모드 이전일때는 보내고 받는 메일 모두 인증 해야 한다. 

  #    https://jflip.tistory.com/58

  # 3) 한글 사용을 위해선 헤더 부분을 변경해 줘야 한다. 

  try {

      //Server settings

      $mail->SMTPDebug = SMTP::DEBUG_SERVER;             

      $mail->isSMTP();                                   

      # 파일 전송 테스트일때는 오류발생 하기 전에는 0으로 하는것이 좋다. 

      $mail->SMTPDebug  = 2;    // 실사용에선 0 으로 변경 

      $mail->Host       = 'aws smtp 주소';               

      $mail->SMTPAuth   = true;                          

      $mail->Username   = 'aws user';                    

      $mail->Password   = 'aws password';                

      // 포트가 587 이면  

      $mail->Port       = 587;

      if ( $mail->Port == 587 ) {

        $mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;

      } else if ( $mail->Port == 465 ) {

        $mail->SMTPSecure = PHPMailer::ENCRYPTION_SMTPS;

}

      //Recipients

      $mail->setFrom('test@test1.com', '테스트1');

      $mail->addAddress('test@test2.com', '테스트2');     //Add a recipient

      // $mail->addAddress('ellen@example.com');               //Name is optional

      // $mail->addReplyTo('info@example.com', 'Information');

      // $mail->addCC('cc@example.com');

      // $mail->addBCC('bcc@example.com');

$mail->addReplyTo('replay@test.com');

$mail->Sender = 'noreplay@test.com'; // Return-Path 변경

      # 파일 첨부 테스트 결과 잘 된다. 

      // $mail->addAttachment('/var/tmp/file.tar.gz');         //Add attachments

      // $mail->addAttachment('/tmp/image.jpg', 'new.jpg');    //Optional name

      # 샘플에서 추가 된것 - 한글 사용을 위한것 

      $mail->XMailer    = "Mailer 2023.02.12";

      $mail->CharSet    = "utf-8";

      $mail->Encoding   = "base64";

      $mail->ContentType= "text/html";

      //Content

      $mail->isHTML(true);                                  //Set email format to HTML

      $mail->Subject = '한글 제목';

      $mail->Body    = '한글 HTML 바디 <b>in 한글 bold!</b>';

      // $mail->AltBody = 'non-HTML mail clients';

      $mail->send();

      echo 'Message has been sent';

  } catch (Exception $e) {

      echo "Message could not be sent. Mailer Error: {$mail->ErrorInfo}";

}

위를 클래스로 만든 것입니다. 큰 차이는 없고 분리된것 뿐 입니다.

  use PHPMailer\PHPMailer\PHPMailer;
  use PHPMailer\PHPMailer\SMTP;
  use PHPMailer\PHPMailer\Exception;

  require 'vendor/autoload.php';

  class Mailer {
    private $mail;

    public function __construct() {
      $this->mail = new PHPMailer(true);
      $this->setup();
    }

    private function setup() {
      try {
        $this->mail->isSMTP();
        $this->mail->SMTPDebug = 2; // 실제 사용시에는 0으로 설정
        $this->mail->Host = 'aws smtp 주소';
        $this->mail->SMTPAuth = true;
        $this->mail->Username = 'aws user';
        $this->mail->Password = 'aws password';
        $this->mail->Port = 587;
        $this->mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;

        $this->mail->CharSet = 'UTF-8';
        $this->mail->Encoding = 'base64';
        $this->mail->ContentType = 'text/html';
        $this->mail->XMailer = 'Mailer 2023.02.12';
      } catch (Exception $e) {
        echo "Mailer Error: " . $this->mail->ErrorInfo;
      }
    }

    public function sendMail($from, $fromName, $to, $toName, $subject, $body, $attachments = []) {
      try {
        $this->mail->setFrom($from, $fromName);
        $this->mail->addAddress($to, $toName);

        foreach ($attachments as $attachment) {
          $this->mail->addAttachment($attachment);
        }

        $this->mail->isHTML(true);
        $this->mail->Subject = $subject;
        $this->mail->Body = $body;

        $this->mail->send();
        echo 'Message has been sent';
      } catch (Exception $e) {
        echo "Message could not be sent. Mailer Error: {$this->mail->ErrorInfo}";
      }
    }
  }

실행 예제 인데 DKIM 등은 여기에 빠져 있으니 필요한 경우 다른 예를 찾아야 합니다.

그리고 AWS SES에서 도메인에 dkim 설정이 되어 있으면 자동으로 생성이 됩니다.

  require 'Mailer.php'; // Mailer 클래스 파일을 포함합니다. 실제 경로에 맞게 조정하세요.

  // Mailer 클래스의 인스턴스를 생성합니다.
  $mailer = new Mailer();

  // 메일 발송 정보 설정
  $from = 'sender@example.com';  // 발신자 이메일 주소
  $fromName = '발신자 이름';      // 발신자 이름
  $to = 'recipient@example.com'; // 수신자 이메일 주소
  $toName = '수신자 이름';       // 수신자 이름
  $subject = '테스트 메일';       // 메일 제목
  $body = '<h1>메일 내용</h1><p>이것은 테스트 메일입니다.</p>'; // 메일 본문 (HTML 형식)

  // 첨부 파일 리스트 (옵션)
  $attachments = [
    '/path/to/first/file.txt',
    '/path/to/second/image.jpg'
  ];

  // 메일 발송 실행
  try {
    $mailer->sendMail($from, $fromName, $to, $toName, $subject, $body, $attachments);
    echo "메일이 성공적으로 발송되었습니다.";
  } catch (Exception $e) {
    echo "메일 발송에 실패했습니다. 에러: " . $e->getMessage();
  }

https://docs.aws.amazon.com/ko_kr/ses/latest/dg/send-email-concepts-email-format.html

Reply-To - 회신을 전송할 이메일 주소입니다. 기본적으로 회신은 원래 발신자 이메일 주소로 전송됩니다.

Return-Path - 반송 메일 및 수신 거부를 전송해야 할 이메일 주소입니다. "Return-Path"는 때때로 "envelope from", "envelope sender" 또는 "MAIL FROM"으로 불립니다.

Amazon SES를 통해 보내는 메시지는 기본적으로 amazonses.com의 서브도메인을 기본 MAIL FROM 도메인으로 자동 사용합니다.

발신자 정책 프레임워크(SPF) 인증은 기본 MAIL FROM 도메인이 이메일을 보낸 애플리케이션과 일치하기 때문에 이러한 메시지를 성공적으로 검증합니다. 이 경우 SES입니다.

SES 기본 MAIL FROM 도메인을 사용하고 싶지 않고,

소유한 도메인의 서브도메인을 사용하고 싶다면, 이는 SES에서 사용자 정의 MAIL FROM 도메인 사용으로 지칭됩니다.

이를 위해서는 사용자 정의 MAIL FROM 도메인에 대한 자체 SPF 레코드를 게시해야 합니다.

또한, SES는 이메일 제공업체가 보내는 반송 및 불만 통지를 도메인이 수신할 수 있도록 MX 레코드 설정도 요구합니다.

사용자 정의 MAIL FROM 도메인을 사용함으로써 SPF, DKIM 또는 둘 모두를 사용하여 도메인 기반 메시지 인증, 보고 및 준수(DMARC) 검증을 달성할 수 있는 유연성을 가질 수 있습니다. DMARC는 발신자 도메인이 도메인에서 보낸 이메일이 하나 이상의 인증 시스템으로 보호된다는 것을 나타낼 수 있게 합니다. DMARC 검증을 달성하는 두 가지 방법은 SPF를 통한 DMARC 준수와 DKIM을 통한 DMARC 준수입니다.