PHP, Composer로 패키지 관리 한 방에 끝내기

PHP와 Composer

Node.js에는 패키지(라이브러리)를 관리해주는 npm이라는 툴이 존재한다. PHP 또한 Composer라는 툴이 존재하여 라이브러리를 편리하게 관리할 수 있게 해준다.

제약사항

• Composer는 PHP 5.3.2 이상에서만 작동한다. 하위 버전에서는 사용할 수 없다.

Composer 설치

• 여기를 클릭하여 Composer를 다운로드 및 설치한다.

• CentOS 6 등의 리눅스 환경에서는 아래와 같이 설치한다.

$ curl -sS https://getcomposer.org/installer | php
$ mv composer.phar /usr/local/bin/composer

• 설치가 완료되면 아래와 같이 커맨드 창에서 명령이 정상적으로 실행됨을 확인한다.

$ composer -V
Composer version 1.4.1 2017-03-10 09:29:45

Composer를 이용한 패키지 설치

이제 프로젝트에 Composer를 적용하여 패키지를 설치해보자.

• 프로젝트 루트에서 아래 명령을 실행한다. 아래 명령은 Carbon이라는 날짜/시간 API를 제공하는 패키지를 설치한다.

$ composer require nesbot/carbon

• 패키지 설치가 완료되면 프로젝트 루트에 패키지 정보를 담은 composer.json 파일, composer.lock 파일, vendor 디렉토리가 생성된다. 이제 패키지 사용 준비는 끝났다.

패키지 사용

마지막으로 소스 코드에서 패키지를 사용할 차례이다.

<?php
require 'vendor/autoload.php';

use Carbon\Carbon;

echo Carbon::now()->toDateTimeString();

프로젝트 클래스 오토로드하기

외부 패키지가 아닌 프로젝트 내의 네임스페이스 기반의 클래스 또한 오토로드 대상에 포함하려면 아래와 같이 작성한다. (네임스페이스는 PHP 5.3.0부터 지원한다.)

• 작성할 클래스의 위치를 프로젝트 루트의 /src/{애플리케이션명}/{네임스페이스명}/{서브네임스페이스명...}/{클래스명}.php로 정한다고 가정한다.

• 위 규칙에 따르면 Hello로 시작하는 네임스페이스의 클래스들은 모두 /src/Hello/ 디렉토리에 위치하게 된다. 프로젝트 루트의 composer.json 파일에 아래 내용을 추가한다.

{
  ...
  "autoload": {
    "psr-4": {
      "Hello\\": "src/Hello/"
    }
  }
}

• 주의할 점은 네임스페이스가 명시된 클래스 내에서 네임스페이스가 명시되지 않은(PHP 5.3.0 이전 시대에 작성된) 클래스를 참조할 때는 참조할 클래스명 앞에 반드시 \(루트 네임스페이스)를 붙여줘야 한다. (ex: new \SomeClass();)


• 위 설정을 적용하려면 아래와 같이 Composer를 실행한다.

$ composer dump-autoload --optimize

• 프로젝트 루트의 index.php에서 앞서 Composer가 생성한 autoload.php 파일을 로드하면 오토로드가 완료된다.

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

// 소스 코딩

참조 문헌

• php[architect] Magazine 2016/01