PHP Composer 설치 및 사용법
- 정광섭
composer 는 ruby 의 bundle 처럼 패키지간의 의존성을 관리해 주는 유틸리티입니다.
composer v2 기준입니다.
설치
- openssl extension 이 활성화되어야 한다.
Linux/Unix/Mac OS X
curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin/
또는 curl 이 없을 경우 php 로 바로 설치. (https 관련 에러가 날 경우 php.ini 의 openssl extension 이 주석해제 되었는지 확인)
php -r "readfile('https://getcomposer.org/installer');" | php -- --install-dir=/usr/local/bin/
사용하기 쉽게 symbolic link 를 건다.
sudo ln -s /usr/local/bin/composer.phar /usr/local/bin/composer
Windows
자동 설치
- 설치 프로그램을 다운로드 받아 실행 https://getcomposer.org/Composer-Setup.exe
수동 설치
- cmd.exe 를 연다.
- PATH 가 걸린 디렉터리로 이동한다.
다음 명령어를 실행하면 composer.phar 이 설치된다.
php -r "readfile('https://getcomposer.org/installer');" | phpcomposer.phar 이 있는 디렉터리에서 composer.bat 이름으로 배치 파일을 작성한다.
@ECHO OFF php "%~dp0composer.phar" %*
Composer version 1 설치
사용
명령어 없이 실행하면 사용 가능한 명령어 목록을 출력한다.
composer.json
프로젝트 설정은 composer.json 파일에 기술하며 의존성 항목은 require 항목으로 기술한다. require 는 "owner/packagename" : "version" 형식으로 기술한다.
{
"name": "lesstif/my-project",
"require": {
"laravel/framework": "4.2.*",
"kmd/logviewer": "1.2.*",
"monolog/monolog": "1.11.*"
"netresearch/jsonmapper" : "*"
},
}
버전은 기본적으로 프로젝트의 tags 디렉터리에서 찾으며 -dev 가 붙을 경우 branches 에서 가져 오게 된다. (버전 명명법 보기)
더 자세한 내용은 의존성 지옥(dependency hell), 유의적 버전(Semantic Versioning)을 참고
require 구문은 composer.json 에 직접 기술해도 되지만 require 명령을 사용하는게 더 간편하다.
composer require monolog/monolog 1.11.\*
패키지 설치
composer.json 에 필요한 패키지를 다 기술했으면 install 명령어로 설치할 수 있다. 설치된 패키지는 vendor 폴더밑에 위치한다.
composer install
패키지 갱신
composer.json 파일이 변경되었으면 update 명령어로 반영할 수 있다.
composer update
Autoloading
composer 로 설치한 library 들은 autoload.php 에 등록되므로 PHP 개발시에 필요한 라이브러리를 일일이 require 구문을 사용하지 않고 다음 문장 하나만 적어 주면 된다.
require 'vendor/autoload.php';
개발 브랜치 사용하기
버전 항목을 "dev-master" 로 설정하면 릴리스 되지 않은 master 브랜치의 마지막 버전을 가져 옴.
{
"require": {
"lesstif/php-jira-rest-client": "dev-master"
}
}
develop 브랜치를 사용할 경우 "dev-master" 대신 "dev-develop" 로 지정
{
"require": {
"lesstif/php-jira-rest-client": "dev-develop"
}
}
composer config
config 옵션으로 composer 의 기본 동작을 제어하는 옵션을 설정할 수 있음.
설정 보기
composer.json 이 있는 폴더에서 아래 명령을 실행하여 현재 설정을 출력
composer config --list
전역 설정을 보려면 global 옵션을 추가
composer global config --list
설정
config 명령뒤에 설정할 key value 를 입력
composer config repositories.foo vcs https://github.com/foo/bar
전역적으로 설정할 경우 config 앞에 global 키워드 추가
composer global config minimum-stability dev
composer로 신규 프로젝트 만들기
기존 프로젝트 복제하여 생성
옵션에 프로젝트 명을 주면 기존 프로젝트를 설치하면서 프로젝트 생성. 마지막 옵션(2.2.*) 은 사용할 버전이며 생략시 최신 버전이 사용됨.
php composer.phar create-project doctrine/orm path/to/my-cloned-project 2.2.*
새로 생성
프로젝트 폴더 생성
$ mkdir monolog-eloquent $ cd monolog-eloquent
프로젝트 초기화
$ composer init
프로젝트 설정 입력
- composer.json 이 생성됨.
.gitignore 파일 생성(https://www.gitignore.io/api/vim,laravel,composer)
# Created by https://www.gitignore.io ### Vim ### [._]*.s[a-w][a-z] [._]s[a-w][a-z] *.un~ Session.vim .netrwhist *~ ### Laravel ### /bootstrap/compiled.php .env.*.php .env.php .env ### Composer ### composer.phar vendor/ # Commit your application's lock file http://getcomposer.org/doc/01-basic-usage.md#composer-lock-the-lock-file # You may choose to ignore a library lock file http://getcomposer.org/doc/02-libraries.md#lock-file # composer.lock
composer install 로 의존성 패키지 설치
$ composer install
같이 보기
- 컴포저(Composer) - PHP용 패키지 관리자 - "쉽게 배우는 라라벨5 프로그래밍" 에서 발췌
- 내가 만든 PHP Composer 패키지를 등록해 보자. PHP 용 중앙 저장소 Packagist.org
- 모노로그(monolog) - PHP 용 로깅 프레임워크(logging framework)
- /wiki/spaces/SADM/pages/889266530
- Laravel 4 설치 및 설정
Ref
- 유의적 버전(Semantic Versioning) 2.0.0
- https://getcomposer.org/doc/01-basic-usage.md#package-versions
- https://getcomposer.org/doc/02-libraries.md