페이지 컨트롤러 디자인 패턴은 웹 기반 시스템에 사용되는 일반적인 아키텍처 접근 방식입니다. 개별 페이지 또는 요청에 대한 논리를 처리하기 위해 특정 컨트롤러를 전용으로 지정하여 제어 흐름을 구성합니다. 이 접근 방식은 책임을 분리하여 코드베이스를 더 쉽게 유지 관리하고 발전시키는 데 도움이 됩니다.

페이지 컨트롤러란 무엇입니까?

페이지 컨트롤러 패턴에서 각 페이지(또는 비슷한 동작을 하는 페이지 그룹)에는 다음을 담당하는 자체 컨트롤러가 있습니다.

1. 요청 처리: 클라이언트에서 보낸 데이터를 처리합니다.
2. 페이지별 로직 실행: 입력 유효성 검사, 모델과 상호 작용 또는 계산 수행.
3. 응답 렌더링: 처리된 데이터를 뷰(템플릿)에 전달하고 최종 응답을 클라이언트에 반환합니다.

패턴의 장점

1. 간단한 흐름: 각 페이지는 자체 전용 컨트롤러에 매핑됩니다.
2. 관심사 분리: 각 컨트롤러는 자체 로직만 처리합니다.
3. 유지관리성: 한 페이지에 대한 변경 사항은 연관된 컨트롤러에만 영향을 미칩니다.
4. 확장성: 새 페이지를 추가하는 것은 간단하며 기존 기능을 방해하지 않습니다.

기본 구조

일반적인 구현에는 다음 구성 요소가 포함됩니다.

• 컨트롤러: 특정 페이지에 대한 논리가 포함된 PHP 파일입니다.
• 경로: URL을 컨트롤러에 매핑하는 라우팅 메커니즘입니다.
• 뷰: 사용자 인터페이스를 렌더링하는 데 사용되는 템플릿입니다.

흐름

1. 클라이언트가 특정 URL로 요청을 보냅니다.
2. 라우팅 시스템은 요청에 적합한 컨트롤러를 식별합니다.
3. 컨트롤러는 필요한 로직을 실행하고 응답 렌더링을 뷰에 위임합니다.
4. 뷰는 최종 출력을 생성하여 클라이언트에 반환합니다.

구현 예

파일 구조

/htdocs
    /src
        /Controllers
            HomeController.php
            AboutController.php
        /Services
            ViewRenderer.php
        /Views
            home.html.php
            about.html.php
    /public
        index.php
    /routes.php
    composer.json

오토로더

{
    "autoload": {
        "psr-4": {
            "App\\": "htdocs/"
        }
    }
}

composer dump-autoload

주형

홈페이지 및 about.html.php.
용 템플릿

    


    
= htmlspecialchars($title) ?>
    
= htmlspecialchars($content) ?>

ViewRenderer

namespace App\Services;

class ViewRenderer {

    public function render(string $view, array $data = []): void {
        extract($data); // Turns array keys into variables
        include __DIR__ . "/../../Views/{$view}.html.php";
    }
}

홈컨트롤러

홈페이지 로직을 처리합니다.

namespace App\Controllers;

use App\Services\ViewRenderer;

class HomeController {

    public function __construct(private ViewRenderer $viewRenderer)
    {
    }

    public function handleRequest(): void {
        $data = [
            'title' => 'Welcome to the Site',
            'content' => 'Homepage content.',
        ];

        $this->viewRenderer->render('home', $data);
    }
}

컨트롤러 정보

"회사 소개" 페이지 로직을 처리합니다.

namespace App\Controllers;

use App\Services\ViewRenderer;

class AboutController
{

    public function __construct(private ViewRenderer $viewRenderer)
    {
    }

    public function handleRequest(): void {
        $data = [
            'title' => 'About Us',
            'content' => 'Information about the company.',
        ];

        $this->viewRenderer->render('about', $data);
    }
}

routes.php

컨트롤러에 대한 경로 매핑을 정의합니다.

use App\Controllers\HomeController;
use App\Controllers\AboutController;

// Define the routes in an associative array
return [
    '/' => HomeController::class,
    '/about' => AboutController::class,
];

index.php

애플리케이션의 진입점입니다.

require_once __DIR__ . '/../vendor/autoload.php';

use App\Services\ViewRenderer;

// Include the routes
$routes = require_once __DIR__ . '/../routes.php';

// Instantiate the view rendering service
$viewRenderer = new ViewRenderer();

// Get the current route from the request URI
$requestUri = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);

// Check if the route exists and resolve the controller
if (isset($routes[$requestUri])) {
    $controllerClass = $routes[$requestUri];
    $controller = new $controllerClass($viewRenderer);
    $controller->handleRequest();
} else {
    http_response_code(404);
    echo "Page not found.";
}

장점과 단점

장점

• 조직: 컨트롤러는 모듈식이며 각각 특정 페이지를 처리합니다.
• 재사용성: 뷰는 다양한 컨트롤러에서 재사용될 수 있습니다.
• 디버깅: 각 페이지마다 전용 컨트롤러가 있으므로 오류를 추적하기가 더 쉽습니다.

단점

• 컨트롤러 수 증가: 대규모 프로젝트에서는 컨트롤러 수가 급증하여 더 나은 구성이 필요할 수 있습니다.
• 코드 중복: 컨트롤러 전반에 걸쳐 공통 논리가 반복될 수 있습니다. 이는 기본 컨트롤러 클래스를 사용하여 완화할 수 있습니다.

페이지 컨트롤러 패턴을 언제 사용해야 할까요?

• 간단한 시스템: 각 페이지에 특정 논리가 있는 중소 규모 웹 애플리케이션에 가장 적합합니다.
• 모듈형 프로젝트: 더 쉬운 유지 관리를 위해 로직을 분리하려는 경우.
• 프레임워크 없음: 강력한 프레임워크(예: Laravel 또는 Symfony)가 없는 PHP 프로젝트에 이상적입니다.

로직 재사용이 상당하거나 진입점이 여러 개인 더 복잡한 프로젝트의 경우 전면 컨트롤러 또는 전체 MVC 아키텍처와 같은 패턴이 더 적합할 수 있습니다.