Slim Framework 개요와 PHP 환경 구축 (Composer)

Slim Framework 란?

Slim Framework는 꼭 필요한 기능(라우팅, 미들웨어, 의존성 주입 등)만을 제공하는 경량 PHP 마이크로 프레임워크입니다. 불필요한 코드를 줄이고 가벼운 API 시스템이나 마이크로 서비스를 개발할 때 매우 유용합니다. Composer와 결합하여 현대적이고 모듈화된 PHP 애플리케이션을 구축할 수 있습니다.

모놀리식 프레임워크 vs 마이크로 프레임워크

Composer를 통한 의존성 관리

최신 PHP 개발의 핵심은 Composer입니다. Composer는 프로젝트 단위로 라이브러리(패키지)를 관리해주는 PHP 의존성 관리 도구입니다. Slim Framework 역시 Composer를 통해 설치 및 관리됩니다.

명령어	설명
composer init	프로젝트를 초기화하고 composer.json 파일을 생성합니다.
composer require slim/slim:"4.*"	Slim 프레임워크 패키지를 다운로드하고 의존성에 추가합니다.
composer install	composer.lock 파일을 기반으로 패키지들을 설치합니다 (배포 시).
composer update	모든 패키지를 최신 버전으로 업데이트합니다.

⚠️ 주의: PSR-4 Autoloading

Composer는 `vendor/autoload.php` 파일을 생성하여 PSR-4 표준에 따른 자동 로딩을 지원합니다. 여러분의 PHP 스크립트 최상단에서 이 파일을 가장 먼저 `require` 해야 모든 라이브러리를 사용할 수 있습니다.

Slim Framework 기초 API 실습 시뮬레이션

실제 PHP 환경에서 Slim Framework를 구동하여 /api/hello 엔드포인트를 호출했을 때의 코드를 작성하고 결과를 브라우저에서 확인해 보겠습니다.

      
      index.php
    

<?php
use Psr\Http\Message\ResponseInterface as Response;
use Psr\Http\Message\ServerRequestInterface as Request;
use Slim\Factory\AppFactory;

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

$app = AppFactory::create();

// 간단한 JSON API 라우트 정의
$app->get('/api/hello', function (Request $request, Response $response, $args) {
    $data = [
        "message" => "Hello from Slim Framework!",
        "status" => 200
    ];
    $response->getBody()->write(json_encode($data, JSON_PRETTY_PRINT));
    return $response->withHeader('Content-Type', 'application/json');
});

$app->run();
?>

localhost:8080/api/hello

{
  "message": "Hello from Slim Framework!",
  "status": 200
}

이처럼 Slim Framework를 활용하면 불필요한 보일러플레이트 코드 없이, 꼭 필요한 라우팅 로직만으로 가벼운 API 서버를 구축할 수 있습니다. 다음 강의에서는 실제 PHP 환경에서 설치하는 과정을 상세히 진행합니다.

명령어

설명

composer init

프로젝트를 초기화하고 composer.json 파일을 생성합니다.

composer require slim/slim:"4.*"

Slim 프레임워크 패키지를 다운로드하고 의존성에 추가합니다.

composer install

composer.lock 파일을 기반으로 패키지들을 설치합니다 (배포 시).

composer update

모든 패키지를 최신 버전으로 업데이트합니다.

<?php use Psr\Http\Message\ResponseInterface as Response; use Psr\Http\Message\ServerRequestInterface as Request; use Slim\Factory\AppFactory; require __DIR__ . '/vendor/autoload.php'; $app = AppFactory::create(); // 간단한 JSON API 라우트 정의 $app->get('/api/hello', function (Request $request, Response $response, $args) { $data = [ "message" => "Hello from Slim Framework!", "status" => 200 ]; $response->getBody()->write(json_encode($data, JSON_PRETTY_PRINT)); return $response->withHeader('Content-Type', 'application/json'); }); $app->run(); ?>