파사드 디자인 패턴은 복잡한 클래스, 라이브러리 또는 하위 시스템 세트에 단순화된 인터페이스를 제공하는 구조적 패턴입니다. 이는 시스템의 복잡성을 숨기고 클라이언트에게 보다 사용자 친화적이고 사용하기 쉬운 인터페이스를 제공하는 데 사용됩니다.

주요 목표

• 상호 작용 단순화: Facade 패턴은 단일하고 간단한 인터페이스를 생성함으로써 내부 복잡성을 모두 노출하지 않고도 복잡한 시스템을 더 쉽게 사용할 수 있게 해줍니다.
• 하위 시스템의 캡슐화: 하위 시스템을 구성하는 클래스는 복잡할 수 있지만 외관은 추상화 계층 역할을 하여 클라이언트가 간단하고 응집력 있는 메서드로만 상호 작용할 수 있도록 합니다.
• 분리: 이 패턴은 클라이언트를 내부 구현에서 분리하는 데 도움이 되므로 향후 시스템을 더 쉽게 유지 관리하고 확장할 수 있습니다.

PHPMailer 및 Facade 패턴을 사용하는 예

상황:

간단한 방법으로 이메일을 보내야 하는 애플리케이션이 있다고 상상해 보세요. 이메일 전송 프로세스에는 인증 설정, SMTP 서버, 발신자, 수신자, 이메일 본문, 첨부 파일 설정 등이 포함될 수 있습니다. 이 전체 복잡한 프로세스를 최종 사용자에게 노출하는 대신 Facade를 만들어 이러한 작업을 캡슐화할 수 있습니다.

Composer를 통해 PHPMailer 설치

composer require phpmailer/phpmailer

디렉토리 시스템

?Facade
 ┣ ?src
 ┃ ┗ ?MailFacade.php
 ┣ ?vendor
 ┣ ?composer.json
 ┗ ?index.php

자동 로드

먼저, Composer가 종속성을 관리하고 클래스를 올바르게 자동 로드하는지 확인하겠습니다.

composer.json 파일에는 src 폴더의 클래스 자동 로드를 포함하고 PHPMailer 종속성을 추가할 수도 있습니다.

{
  "require": {
    "phpmailer/phpmailer": "^6.0"
  },
  "autoload": {
    "psr-4": {
      "App\\": "src/"
    }
  }
}

클래스 MailFacade

이제 사용자에게 이메일을 보내는 프로세스를 단순화하기 위해 Facade 역할을 할 MailFacade 클래스를 만들어 보겠습니다.

namespace App;

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

// Facade class
class MailFacade {
    private $mail;

    public function __construct() {
        $this->mail = new PHPMailer(true);  // Create a new instance of PHPMailer
        $this->mail->isSMTP();              // Set up to use SMTP
        $this->mail->Host = 'smtp.example.com';  // Set the SMTP server
        $this->mail->SMTPAuth = true;       // Enable SMTP authentication
        $this->mail->Username = '[email protected]'; // SMTP username
        $this->mail->Password = 'secret';   // SMTP password
        $this->mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS; // Enable TLS encryption
        $this->mail->Port = 587;            // SMTP server port
    }

}

메소드 sendEmail

// Method to send a simple email
public function sendEmail($to, $subject, $body) {
    try {
        // Set sender
        $this->mail->setFrom('[email protected]', 'Sender Name');

        // Set recipient
        $this->mail->addAddress($to);  // You can add more with $this->mail->addAddress('[email protected]');

        // Set email subject and body
        $this->mail->Subject = $subject;
        $this->mail->Body = $body;
        $this->mail->isHTML(true); // Set email body to accept HTML

        // Send email
        $this->mail->send();
        echo 'Email successfully sent!';
    } catch (Exception $e) {
        echo "Error sending email: {$this->mail->ErrorInfo}";
    }
}

메서드 sendEmailWithAttachment

// Method to send an email with an attachment
public function sendEmailWithAttachment($to, $subject, $body, $attachmentPath) {
    try {
        // Same basic configuration as in the previous method
        $this->mail->setFrom('[email protected]', 'Sender Name');
        $this->mail->addAddress($to);

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

        // Add the attachment
        $this->mail->addAttachment($attachmentPath);

        // Send the email
        $this->mail->send();
        echo 'Email with attachment successfully sent!';
    } catch (Exception $e) {
        echo "Error sending email: {$this->mail->ErrorInfo}";
    }
}

시험

require 'vendor/autoload.php';

use App\MailFacade;

// Using the Facade
$mailFacade = new MailFacade();

// Sending a simple email
$mailFacade->sendEmail('[email protected]', 'Email Subject', 'Email body in HTML');

// Sending an email with an attachment
$mailFacade->sendEmailWithAttachment('[email protected]', 'Subject with Attachment', 'Here is your attachment', '/path/to/attachment.pdf');

작동 방식:

• MailFacade: 이 클래스는 이메일을 구성하고 보내는 데 필요한 모든 로직을 캡슐화하여 Facade 사용자가 간단히 이메일을 보내는 메소드를 호출할 수 있도록 합니다.
• PHPMailer: PHPMailer의 복잡성(예: SMTP 구성, 인증 등)은 외관 내에 숨겨져 있습니다.

이익:

• 단순성: MailFacade를 사용하는 클라이언트 코드는 서버 구성, PHPMailer 메소드 등과 같은 세부 사항을 알 필요가 없습니다.
• 재사용 가능: 코드나 로직을 반복할 필요 없이 애플리케이션의 다양한 부분에서 파사드를 사용할 수 있습니다.
• 유지 관리 가능: 구현에서 무언가를 변경해야 하는 경우(예: SMTP 서버 전환) MailFacade 클래스 내에서만 업데이트하면 됩니다.

이것은 Facade 패턴이 PHPMailer와 같은 복잡한 라이브러리와의 상호 작용을 어떻게 단순화할 수 있는지 보여주는 실제적인 예입니다.