Composer 사용법

1. 도입 (왜 배워야 하는가)

PHP 프로젝트를 개발할 때, Composer는 필수 도구입니다. Composer는 PHP 의존성 관리 도구로, 라이브러리와 패키지를 쉽게 설치하고 관리할 수 있습니다. 이는 마치 요리를 할 때 필요한 재료를 쉽게 구매할 수 있는 마트와 같습니다. Composer를 사용하지 않으면, 필요한 라이브러리를 수동으로 다운로드하고 추가해야 하는 번거로움이 생기며, 이는 프로젝트의 유지보수를 어렵게 만듭니다. 또한, 라이브러리 간의 버전 충돌 문제에 직면할 수 있습니다. Composer를 통해 이러한 문제를 예방하고, 효율적인 작업 환경을 구축할 수 있습니다.

2. 핵심 개념 설명

Composer

• PHP 의존성 관리 도구로, 필요한 라이브러리를 쉽게 다운로드하고 관리할 수 있습니다.

패키지

• Composer를 통해 설치할 수 있는 라이브러리 또는 모듈입니다. 각 패키지는 특정 기능을 제공합니다.

composer.json

• 프로젝트의 의존성을 정의하는 파일입니다. 어떤 패키지를 사용할 것인지 명시합니다.

용어	설명
Composer	PHP 의존성 관리 도구
패키지	Composer를 통해 설치할 수 있는 라이브러리 또는 모듈
composer.json	프로젝트의 의존성을 정의하는 파일

3. 기본 코드 예제

Composer를 사용하기 위해서는 먼저 Composer를 설치해야 합니다. 이후 composer.json 파일을 생성하고 패키지를 추가할 수 있습니다.

// composer.json 파일 생성
{
    "require": {
        "monolog/monolog": "^2.0"
    }
}

실행 결과

위의 내용을 composer.json 파일에 작성한 후, 터미널에서 다음 명령어를 실행합니다:

composer install

코드 한 줄씩 동작 설명

• composer.json 파일에 필요한 패키지 정보를 입력합니다.
• 터미널에서 composer install 명령어를 통해 해당 패키지를 다운로드하고, vendor 디렉토리에 설치합니다.

4. 실전 활용 예제

쇼핑몰에서 장바구니를 구현할 때

장바구니 기능을 구현하기 위해 monolog/monolog 패키지를 사용하여 로그를 기록할 수 있습니다.

require 'vendor/autoload.php';

use Monolog\Logger;
use Monolog\Handler\StreamHandler;

// 로그 채널 생성
$log = new Logger('shopping_cart');
$log->pushHandler(new StreamHandler('path/to/your.log', Logger::WARNING));

// 장바구니에 상품 추가
function addToCart($item) {
    global $log;
    // 상품 추가 로직
    $log->warning('상품이 장바구니에 추가되었습니다: ' . $item);
}

addToCart('사과');

실행 결과

로그 파일에 다음 내용이 기록됩니다:

[WARNING] 상품이 장바구니에 추가되었습니다: 사과

5. 흔한 실수와 주의사항

1. 잘못된 패키지 이름

// 잘못된 예
{
    "require": {
        "monolog/monolog": "2.0.x" // 버전 지정이 올바르지 않음
    }
}

• 올바른 예

{
    "require": {
        "monolog/monolog": "^2.0" // 올바른 버전 표기법
    }
}

2. composer.lock 파일 관리 소홀

• composer.lock 파일은 현재 프로젝트에서 사용 중인 패키지의 정확한 버전을 기록합니다. 이 파일을 버전 관리에 포함시키지 않으면, 다른 개발자들이 동일한 환경에서 작업하기 어렵습니다.

6. 정리

• Composer는 PHP 프로젝트의 의존성을 쉽게 관리할 수 있는 도구입니다.
• composer.json을 통해 필요한 패키지를 정의하고, composer install로 설치합니다.
• 실무에서 패키지를 효과적으로 활용하기 위해서는 패키지 버전 관리와 composer.lock 파일의 중요성을 이해해야 합니다.

다음에 학습하면 좋은 주제:

• Composer의 고급 기능 (예: Autoloading)
• PHP 패키지 배포 방법
• Composer와 Git을 함께 사용하는 방법