[번역] 의존성 관리 도구 컴포저 - 명령어 줄 인터페이스 / 명령어

* 원문: https://getcomposer.org/doc/03-cli.md

워낙 양이 많아서 나눠서 해볼까 고민하다가 한 페이지인데 나눠서 뭐하나 싶기도 해도 한꺼번에 번역해보았습니다.

---

명령어 줄 인터페이스 / 명령어

여러분은 이미 명령어 줄 인터페이스를 어떻게 사용하는지 배웠다. 이 장은 사용할 수 있는 명령어를 모은 문서이다.

명령어 줄에서 도움을 받으려면 모든 명령어 리스트를 보기 위해 간단하게 composer나 composer list를 호출하고 정보를 얻고 싶은 명령어와 --help를 합쳐서 호출하면 된다.

전역 옵션

다음 옵션은 모든 명령어에 사용할 수 있다.

• --verbose (-v): 메세지의 자세하게 표시한다.
• --help (-h): 도움말 정보를 표시한다.
• --quiet (-q): 어떤 메세지도 출력하지 않는다.
• --no-interaction (-n): 어떤 대화식 질문도 하지 않는다.
• --working-dir (-d): 지정되면 작업 디렉토리로 지정된 디렉토리를 사용한다.
• --profile: 타이밍과 메모리 사용 정보를 표시한다.
• --ansi: ANSI로 강제 출력한다.
• --no-ansi: ANSI 출력을 비활성화 한다.
• --version (-V): 애플리케이션 버전을 표시한다.

종료 코드 과정

• 0: OK
• 1: 일반/알 수 없는 오류 코드
• 2: 의존성 해결 오류 코드

init

라이브러리 장에서 우리는 수동으로 composer.json를 어떻게 만드는지 살펴보았다. init 명령어는 이러한 절차를 조금 더 쉽게 할 수 있다.

이 명령어를 실행하면 일부 기본 값을 사용하면서 대화형으로 항목을 기입할 수 있을 것이다.

php composer.phar init

옵션

• --name: 패키지 이름
• --description: 패키지 설명
• --author: 패키지 제작자 이름
• --homepage: 패키지 홈페이지
• --require: 패키지 버전 제약 조건을 요구한다. foo/bar:1.0.0 형식이어야 한다.
• --require-dev: 개발 요구 사항, --require 참고
• --stability (-s): minimun-stability항목 값

install

install 명령어는 현재 디렉터리에서 composer.json 파일을 읽고 종속성을 해결하고 vendor로 설치한다.

php composer.phar install

현재 디렉터리에 composer.lock 파일이 있으면 composer.json 파일을 해결하는 대신 그 파일에서 정확한 버전을 사용할 것이다. 라이브러리를 사용하는 모든 사람은 같은 의존성을 얻는다는 것을 보장한다.

composer.lock 파일이 없으면 컴포저는 종속성 작업을 처리한 후에 파일을 생성할 것이다.

옵션

• --prefer-source: 패키지를 다운로드하는 방법에는 source와 dist 이렇게 2가지 방법이 있다. 안정 버전의 경우 컴포저는 기본적으로 dist를 사용한다. source는 버전 관리 저장소이다. --prefer-source를 사용할 수 있고 존재한다면 컴포저는 source에서 설치할 것이다. 이는 프로젝트에 버그 수정을 하고 직접 종속성의 로컬 git 클론을 얻을 때 유용하다.
• --prefer-dist: --prefer-source의 반대이다. 컴포저는 가능하면 dist에서 설치한다. 이 명령어는 빌드 서버와 일반적으로 벤더 업데이트를 실행하지 않는 다른 경우에 대체로 설치 속도를 높일 수 있다. 이 옵션은 올바른 설정이 없는 경우 git의 문제를 회피하는 방법이다.
• --ignore-platform-reqs: php, hhvm, lib-*, ext-* 요청을 무시하고 로컬 기기가 이행하지 않아도 강제로 설치한다. platform 설정 옵션을 참고하라.
• --dry-run: 만약 실제로 패키지 설치 없이 설치를 통해 실행하고 싶으면 여러분은 --dry-run을 사용할 수 있다. 이것은 설치를 시뮬레이션하고 어떤 일이 일어나는지 보여준다.
• --dev: require-dev에서 나열된 패키지를 설치한다 (기본 동작이다).
• --no-dev: require-dev에서 나열된 패키지 설치를 건너뛴다. 자동 로드 생성은 자동 로드-개발 규칙을 건너 뛴다.
• --no-autoloader: 자동 로드 생성을 건너뛴다.
• --no-scripts: composer.json에서 정의된 스크립트 실행을 건너 뛴다.
• --no-plugins: 플러그인을 비활성화 한다.
• --no-progress: 백 스페이스 문자를 처리하지 않는 일부 터미널이나 스크립트를 엉망으로 만들 수 있는 진행 표시를 제거한다.
• --optimize-autoloader (-o): 빠른 오토로드를 얻기 위해 PSR-0/4를 클래스 맵으로 변환한다. 특히 실제품에 추천하지만 실행하는데 시간이 더 걸리므로 기본적으로 수행하지 않는다.

update

의존성 최신 버전을 받고 composer.lock 파일을 업데이트 하기 위해서 update 명령어를 사용해야 한다.

php composer.phar update

이것은 프로젝트에서 모든 의존성을 해결하고 composer.lock에 정확한 버전을 작성할 것이다.

만약 여러분이 몇몇 패키지와 일부를 업데이트 하고 싶으면 여러분은 다음와 같이 나열할 수 있다.

php composer.phar update vendor/package vendor/package2

또한 한번에 패키지를 업데이트하기 위해 와일드 카드 문자(*)를 사용할 수 있다.

php composer.phar update vendor/*

옵션

• --prefer-source: 사용할 수 있을 때 source로 패키지를 설치한다.
• --prefer-dist: 사용할 수 있을 때 dist로 패키지를 설치한다.
• --ignore-platform-reqs: php, hhvm, ext-* 요청을 무시하고 로컬 기기가 이행하지 않아도 강제로 설치한다. platform 설정 옵션을 참조하라.
• --dry-run: 실제 동작 없이 명령어를 시뮬레이션한다.
• --dev: require-dev에서 설치한 패키지를 나열한다 (기본 동작이다).
• --no-dev: require-dev에서 설치한 패키지를 나열하는 것을 건너 뛴다. 자동 로드 생성은 autoload-dev 규칙을 건너뛴다.
• --no-autoloader: 자동 로드 생성을 건너뛴다.
• --no-scripts: composer.json에서 정의한 스크립트 실행 동작을 건너뛴다.
• --no-plugins: 플러그인을 비활성화 한다.
• --no-progress: 백스페이스를 다룰 수 없는 몇몇 터미널이나 스크립트에서 엉망으로 만들 수도 있는 진행바 표시를 제거한다.
• --optimize-autoloader (-o): 빠른 오토로드를 얻기 위해 PSR-0/4를 클래스 맵으로 변환한다. 특히 실제품에 추천하지만 실행하는데 시간이 더 걸리므로 기본적으로 수행하지 않는다.
• --lock: 오래된 잠금 파일에 대해 경고를 숨기기 위해 잠금 파일 해시를 업데이트만 한다.
• --with-dependencies: 허용 목록을 위해 허용된 패키지의 모든 의존성을 추가한다.
• --prefer-stable: 안정적인 의존성 버전을 우선 시 한다.
• --prefer-lowest: 가장 낮은 의존성 버전을 우선 시 한다. 최소 요구를 테스트할 때 유용하고 일반적으로 --prefer-stable와 같이 사용한다.

require

require 명령어는 현재 디렉터리에서 composer.json 파일에 새 패키지를 추가한다. 파일이 존재하지 않으면 바로 파일을 하나 생성한다.

php composer.phar require

추가/변경 요청 후에 수정 요구는 설치되거나 업데이트 될 것이다.

만약 대화형으로 요구 사항을 선택하고 싶지 않으면 이 명령어를 통해 통과하면 된다.

php composer.phar require vendor/package:2.* vendor/package2:dev-master

옵션

• --prefer-source: 사용할 수 있을 때 source로 패키지를 설치한다.
• --prefer-dist: 사용할 수 있을 때 dist로 패키지를 설치한다.
• --ignore-platform-reqs: php, hhvm, ext-* 요청을 무시하고 로컬 기기가 이행하지 않아도 강제로 설치한다. platform 설정 옵션을 참조하라.
• --dev: require-dev로 패키지를 추가한다.
• --no-update: 의존성을 자동으로 업데이트 하는 것을 비활성화 한다.
• --no-progress: 백 스페이스 문자를 처리하지 않아서 일부 터미널이나 스크립트를 혼란스럽게 할 진행 표시를 제거한다.
• --update-no-dev: no-dev 옵션으로 의존성 업데이트를 실행한다.
• --update-with-dependencies: 새롭게 패키지를 요구한 의존성을 업데이트한다.
• --sort-packages: composer.json에서 패키지가 정렬되는 것을 유지한다.

remove

remove 명령어는 현재 디렉터리의 composer.json 파일에서 패키지를 제거한다.

php composer.phar remove vendor/package vendor/package2

요청대로 제거한 후에 수정된 요구 사항은 삭제 된다.

옵션

• --ignore-platform-reqs: php, hhvm, ext-* 요청을 무시하고
• 로컬 기기가 이행하지 않아도 강제로 설치한다. platform 설정 옵션을 참조하라.
• --dev: require-dev로 패키지를 제거한다.
• --no-update: 의존성을 자동으로 업데이트 하는 것을 비활성화 한다.
• --no-progress: 백 스페이스 문자를 처리하지 않아서 일부 터미널이나 스크립트를 혼란스럽게 할 진행 표시를 제거한다.
• --update-no-dev: --no-dev 옵션과 함께 의존성 업데이트를 실행한다.
• --update-with-dependencies: 제거한 패키지의 의존성을 업데이트 한다.

global

전역 명령어는 마치 COMPOSER_HOME 디렉터리에서 실행한 것처럼 install, require, update같은 다른 명령어를 실행할 수 있다.

이 명령어는 환경 변수 $PATH에 $COMPOSER_HOME/vendor/bin를 추가한다면 전역으로 CLI 유틸리티를 설치할 때 사용할 수 있다. 여기에 예제가 있다.

php composer.phar global require fabpot/php-cs-fixer:dev-master

이제 php-cs-fixer 바이너리는 (당신이 경로를 조정했다는 가정 하에) 전역으로 사용할 수 있다. 만약 여러분이 나중에 바이너리를 업데이트 하고 싶으면 전역 업데이트를 실행하면 된다.

php composer.phar global update

search

검색 명령어는 현재 프로젝트 패키지 저장소를 통해 검색할 수 있다. 보통 이 방법은 패키지스트가 할 것이다. 여러분은 단순히 검색할 조건을 전달한다.

php composer.phar search monolog

여러분은 다중 인자를 통해 둘 이상의 용어를 검색할 수 있다.

옵션

• --only-name (-N): 이름으로만 검색

show

사용할 수 있는 패키지를 나열하기 위해서 show 명령어를 사용할 수 있다.

php composer.phar show monolog/monolog

name     : monolog/monolog
versions : master-dev, 1.0.2, 1.0.1, 1.0.0, 1.0.0-RC1
type     : library
names    : monolog/monolog
source   : [git] https://github.com/Seldaek/monolog.git 3d4e60d0cbc4b888fe5ad223d77964428b1978da
dist     : [zip] https://github.com/Seldaek/monolog/zipball/3d4e60d0cbc4b888fe5ad223d77964428b1978da 3d4e60d0cbc4b888fe5ad223d77964428b1978da
license  : MIT

autoload
psr-0
Monolog : src/

requires
php >=5.3.0

옵션

• --installed (-i): 설치된 패키지 목록.
• --platform (-p): 플랫폼 패키지 목록 (php & 확장 기능).
• --self (-s): 루트 패키지 정보 목록

browse / home

browse (별칭 home)는 브라우저에서 패키지 저장소 URL이나 홈페이지를 연다.

옵션

• --homepage (-H): 저장소 URL 대신 홈페이지를 연다.

suggests

현재 설치된 패키지 세트는 모든 패키지 목록을 제안한다. 여러분은
그들의 패키지에 의해 만들어진 제안 결과물을 제한하기 위해
vendor/package 형식에서
선택적으로 하나 또는 여러개 패키지 이름을 건너뛸 수 있다.

옵션

• --no-dev:require-dev 패키지에서 제안을 제외한다.
• --verbose: (-v): 증가된 상세 내용은 제안한 패키지 이름과 제안 이유를 추가한다.

depends

depends 명령어는 다른 패키지가 특정 패키지에 의존한다는 것을 말한다. 여러분은 리스트에 포함되어야 하는 링크 유형(require, require-dev) 을 지정할 수 있다. 기본적으로 모두 사용된다.

php composer.phar depends --link-type=require monolog/monolog

nrk/monolog-fluent
poc/poc
propel/propel
symfony/monolog-bridge
symfony/symfony

옵션

• --link-type : 링크 유형을 여러번 지정할 수 있다.

validate

여러분은 composer.json 파일을 실행하기 전에 혹은 태그를 릴리즈하기 전에 항상 validate를 실행해야 한다. composer.json가 유효하다면 확인할 것이다.

php composer.phar validate

옵션

• --no-check-all: composer.json에 있는 요구사항이 언바운드 버전 제약이면 경고 (warning) 를 표시하지 않는다.
• --no-check-lock: composer.lock 파일이 존재하거나 최신 파일이 아니면 에러 (error) 를 표시하지 않는다.
• --no-check-publish: composer.json 파일이 패키지스트에 패키지로 발행하기에 적합하지 않으면 에러 (error)를 표시하지 않지만 그렇지 않으면 유효하다.

status

만약 여러분이 의존성 코드나 설치된 소스를 자주 수정한다면 status 명령어는 여러분이 로컬에서 변경되었는지 확인할 수 있다.

php composer.phar status

--verbose 옵션를 함께 쓰면 여러분이 변경된 정보에 대해 더 자세히 알 수 있다.

php composer.phar status -v

You have changes in the following dependencies:
vendor/seld/jsonlint:
    M README.mdown

self-update

컴포저 스스로 최신 버전으로 업데이트하기 위해서 그냥 self-update 명령어를 실행하면 된다. 이 명령어는 composer.phar 파일을 최신 버전으로 교체할 것이다.

php composer.phar self-update

특정 릴리즈를 간단하게 업데이트 하려면 다음과 같이 사용하면 된다.

php composer.phar self-update 1.0.0-alpha7

전체 시스템 (전역 설치 참고) 에 설치된 컴포저가 있다면 root 권한으로 명령어를 실행할 것이다.

sudo composer self-update

옵션

• --rollback (-r): 설치된 마지막 버전으로 롤백한다.
• --clean-backups: 업데이트 하는 동안 오래된 백업을 삭제한다. 업데이트 후에 컴포저의 현재 버전이 사용할 수 있는 백업 하나를 만든다.
  

config

config 명령어는 여러분이 로컬 composer.json 파일이나 전역 config.json 파일에서 몇몇 컴포저 기본 설정을 수정할 수 있도록 해준다.

php composer.phar config --list

사용

config [options] [setting-key] [setting-valu1] ... [setting-valueN]

setting-key는 설정 옵션 이름이고 setting-value1은 설정 값이다.
(github-protocols 같이) 배열 값일 경우 허용된 설정 값 인자가 하나 이상이다.

유효한 설정 옵션을 보려면 설정 장을 참고하라.

옵션

• --global (-g): 기본으로 $COMPOSER_HOME/config.json에 위치한 전역 설정 파일을 운영한다.
  이 옵션이 없으면 이 명령어는 로컬 composer.json 파일이나 --file로 지정된 파일에 영향을 미친다.
• --editor (-e): 환경 변수 EDITOR가 정의한 텍스트 에디터에서 로컬 composer.json 파일을 사용하여 연다. --global 옵션을 사용하면 전역 설정 파일을 연다.
• --unset: setting-key가 지은 설정 요소를 제거한다.
• --list (-l): 현재 설정 변수 리스트를 보여준다. --global 옵션을 사용하면 전역 설정만 출력한다.
• --file="..." (-f): composer.json 대신에 특정파일을 운영한다. --global 옵션과 함께 사용할 수 없음을 숙지하자.
• --absolute: 상대 경로 대신에 *-dir 설정값을 패치할 때 절대 경로로 반환한다.

수정된 저장소

추가적으로 설정 영역을 수정하려면 config 명령어는 다음과 같은 방법을 사용하여 변경 사항을 지원한다.

php composer.phar config repositories.foo vcs https://github.com/foo/bar

create-project

여러분은 컴포저로 존재하는 패키지에서 새로운 프로젝트를 생성할 수 있다. 이는 vendor의 "컴포저 설치" 다음에 git 클론이나 svn 체크아웃을 하는 것과 같다.

여기에 여러가지 애플리케이션이 있다.

1. 여러분은 애플리케이션 패키지를 배치할 수 있다.
2. 여러분은 어떤 패키지를 확인하고 예를 들어 패치에서 개발을 시작할 수 있다.
3. 여러 개발자가 참여하는 프로젝트는 개발을 위해 초기 애플리케이션을 설정하기 위한 기능을 사용할 수 있다.

컴포저를 사용하는 새 프로젝트를 생성하려면 여러분은 "create-project" 명령어를 사용할 수 있다. 패키지 이름을 전달하고 디렉토리에서 프로젝트를 만들 수 있다. 여러분은 또한 3번째 인자로 버전을 전달할 수 있고 전달하지 않으면 최신 버전이 사용된다.

디렉토리가 현재 존재하지 않으면 설치하는 동안에 생성한다.

php composer.phar create-project doctrine/orm path 2.2.*

프로젝트를 초기 설정하기 위해 기존 composer.json로 디렉토리에서 파라미터 없이 명령어를 실행할 수도 있다.

기본적으로 명령어는 packagist.org에서 패키지를 확인한다.

옵션

• --repository-url: 패키지를 찾기 위해 커스텀 저장소를 제공하고 패키지스트 대신에 사용된다.
  composer 저장소를 가리키는 HTTP URL이든 로컬 packages.json 파일 경로든 할 수 있다.
• --stability (-s): 패키지의 최소 안정성. stable가 기본이다.
• --prefer-source: 사용 가능할 때 source로 패키지를 설치한다.
• --prefer-dist: 사용 가능할 때 dist로 패키지를 설치한다.
• --dev: require-dev에서 설치한 패키지를 나열한다.
• --no-install: vendor 설치를 비활성화한다.
• --no-plugins: 플러그인을 비활성화한다.
• --no-scripts: 루트 패키지에서 정의된 스크립트 실행을 비활성화한다.
• --no-progress: 백스페이스를 다룰 수 없는 몇몇 터미널이나 스크립트에서 엉망으로 만들 수도 있는 진행바 표시를 제거한다.
• --keep-vcs: 생성된 프로젝트를 위해 VCS 메타 데이터 제거하는 절차를 건너뛴다. 이 옵션은 인터렉티브하지 않은 환경에서 명령어를 실행한다면 아주 유용하다.
• --ignore-platform-reqs: php, hhvm, lib-*, ext-* 요구사항을 무시하고
  로컬 기기에서 이행하지 않아도 강제로 설치한다.

dump-autoload

예를 들어 만약 여러분이 classmap 패키지에서 새로운 클래스 때문에 오토로드를 업데이트할 필요가 있다면 여러분은 설치나 업데이트를 쓸 필요 없이 "dump-autoload"를 사용하면 된다.

추가적으로 성능상의 이유로 클래스 맵으로 PSR-0/4을 변환한 최적화 오토로더를 내려 받을 수 있다. 많은 클래스가 있는 큰 애플리케이션에서 오토로드는 매 요청 시간의 상당한 부분을 차지한다. 개발 할 때 전부 클래스맵을 사용하는 것은 그닥 편리하지는 않지만 이 옵션을 사용하여 편의를 위한 PSR-0/4와 성능을 위한 클래스 맵을 사용할 수 있다.

옵션

• --optimize (-o): 빠른 오토로드를 얻기 위해 PSR-0/4를 클래스 맵으로 변환한다. 특히 실제품에 추천하지만 실행하는데 시간이 더 걸리므로 기본적으로 수행하지 않는다.
• --no-dev: 오토로드 개발용 규칙을 비활성화한다.

clear-cache

컴포터 캐시 디렉토리에 있는 모든 컨텐츠를 제거한다.

licenses

설치된 모든 패키지의 이름, 버전, 라이센스 목록을 출력한다. --format=json을 사용하여 기기가 읽을 수 있도록 결과물을 얻을 수 있다.

옵션

• --no-dev: 결과물에서 개발 의존성을 제거한다.
• --format: 결과물 포맷: text나 json (기본값: "text")

run-script

옵션

• --no-dev: 개발 모드를 비활성화
• --list: 사용자가 정의한 스크립트를 나열한다.

수동으로 이 명령어를 사용할 수 있는 스크립트를 실행하려면 그냥 스크립트 이름과 필요한 인수를 선택적으로 전달하면 된다.

diagnose

만일 여러분이 버그나 이상하게 동작하는 부분을 찾았다고 생각하면 여러분은 일반적인 문제에 대해 자동 검사를 수행하기 위해 diagnose 명령어를 실행하고 싶을 수도 있다.

php composer.phar diagnose

archive

이 명령어는 주어진 버전에서 지정된 패키지를 위해 zip/tar 아카이브를 생성하는데 사용한다. 또한 제외나 무시되는 파일 없이 전체 프로젝트를 보관하는데 사용할 수도 있다.

php composer.phar archive vendor/package 2.0.21 --format=zip

옵션

• --format (-f): 결과 아카이브의 포맷: tar, zip (기본값: "tar")
• --dir: 이 디렉토리에 아카이브를 작성 (기본값: ".")

help

어떤 명령어에 대해 더 많은 정보를 얻고 싶으면 그냥 help를 쓰면된다.

php composer.phar help install

환경 변수

여러분은 특정 설정을 재정의한 다양한 환경 변수를 설정할 수 있다. 가능하면 composer.json 대신 config 영역에서 이 설정을 지정하는 것이 좋다. 환경 변수 composer.json에서 지정된 값보다 항상 더 우선순위를 가지는 것에 대해 주목할 필요가 있다.

COMPOSER

COMPOSER 환경 변수를 설정하여 composer.json 파일이름을 다른 것으로 설정할 수 있다.

예를 들어,

COMPOSER=composer-other.json php composer.phar install

이 예제를 실행하면 composer-other.lock라는 이름으로 잠금파일이 생성될 것이다.

COMPOSER_ROOT_VERSION

이 변수를 설정하면 VCS 정보에서 추측할 수 없고 composer.json에서 존재하지 않으면 여러분이 루트 패키지의 버전을 지정할 수 있다.

COMPOSER_VENDOR_DIR

이 변수를 설정하면 여러분은 vendor가 아닌 다른 디렉토리로 의존성을 설치할 수 있도록 한다.

COMPOSER_BIN_DIR

이 옵션을 설정하면 여러분은 vendor/bin가 아닌 다른 디렉토리로 bin (Vendor 바이너리) 로 변경할 수 있다.

http_proxy나 HTTP_PROXY

만일 HTTP 프록시 뒤에서 컴포저를 사용하는 경우 여러분은 표준 http_proxy나 HTTP_PROXY 환경 변수를 사용할 수 있다. 간단하게 여러분의 프록시 URL를 설정한다. 대다수의 운영 시스템은 이미 여러분을 위해 변수를 설정하고 있다.

http_proxy (소문자) 를 사용하는 것이나 심지어 모두를 정의하는 것은 git이나 curl이 소문자 http_proxy 버전을 사용하는 몇몇 도구들 때문에 바람직할지도 모른다. 그렇게 하지 않으면 여러분은 git config --global http.proxy 를 사용하는 git 프록시를 정의할 수도 있다.

no_proxy

만일 프록시를 통하면서 특정 도메인을 해제하려는 경우 여러분은 no_proxy 환경 변수를 사용할 수 있다. 간단하게 프록시를 사용하지 않아야 하는 도메인을 쉼표로 구분하여 설정한다.

환경 변수가 CIDR 표기법으로 작성한 도메인, IP 주소, IP 차단 주소를 승인한다. 여러분은 특정 포트에 제한을 걸 수 있다 (예: :80). 여러분은 *를 설정하여 모든 HTTP 요청 프록시를 무시할 수도 있다.

HTTP_PROXY_REQUEST_FULLURI

만일 프록시를 사용하지만 request_fulluri 플래그를 지원하지 않는다면 여러분은 컴포저에서 request_fulluri 옵션을 설정하는 것을 막기 위해 이 환경 변수를  false나 0으로 설정해야 한다.

HTTPS_PROXY_REQUEST_FULLURI

만일 프록시를 사용하지만 HTTPS를 요청하는 request_fulluri 플래그를 지원하지 않는다면 여러분은 컴포저에서 request_fulluri 옵션을 설정하는 것을 막기 위해 이 환경 변수를  false나 0으로 설정해야 한다.

COMPOSER_HOME

COMPOSER_HOME 변수는 여러분이 컴포터 홈 디렉토리를 변경하도록 해준다. 이는 모든 프로젝트가 공유되는 전역 (시스템 사용자별) 디렉토리이고 숨겨져 있다.

기본적으로 *nix에서 /home//.composer, OSX에서 /Users//.composer, 윈도우에서 C:\Users\\AppData\Roaming\Composer를 가리키고 있다.

COMPOSER_HOME/config.json

여러분은 composer.json 파일을 COMPOSER_HOME이 가리키고 있는 위치에 놓을 수 있다. 컴포저는 여러분이 install이나 update 명령어를 실행하면 이 설정과 여러분의 프로젝트 composer.json를 병합할 것이다.

이 파일은 여러분이 사용자 프로젝트의 저장소와 구성을 설정할 수 있도록 해준다.

전역 설정이 로컬 설정이 충돌하는 경우에 프로젝트의 composer.json에 있는 로컬 설정이 항상 이긴다.

COMPOSER_CACHE_DIR

COMPOSER_CACHE_DIR 변수는 여러분이 컴포저 캐시 디렉토리를 변경할수 있도록 해주며 cache-dir 옵션을 통해 설정할 수도 있다.

기본적으로 *nix, OSX에서 $COMPOSER_HOME/cache, 윈도우즈에서는 C:\Users\<user>\AppData\Local\Composer 또는 %LOCALAPPDATA%/Composer를 가리키고 있다.

COMPOSER_PROCESS_TIMEOUT

이 환경 변수는 명령어 (git 명령어 같은) 실행을 완수하기 위한 컴포저 대기시간을 조정한다. 기본값은 300초이다 (5분).

COMPOSER_DISCARD_CHANGES

이 환경 변수는 discard-changes 설정 옵션을 조정한다.

COMPOSER_NO_INTERACTION

1로 설정되어 있으면 이 환경 변수는 컴포저가 모든 명령어에 --no-interation를 전달하는 것처럼 동작할 것이다. 이것은 boxes/CI 빌드에서 설정할 수 있다.

continue reading [번역] 의존성 관리 도구 컴포저 - 명령어 줄 인터페이스 / 명령어

[번역] 의존성 관리 도구 컴포저 - 라이브러리

* url: https://getcomposer.org/doc/02-libraries.md

라이브러리

이번 장은 컴포저를 통해서 설치할 수 있는 라이브러리를 만드는지 이야기할 것이다.

모든 프로젝트는 패키지이다

디렉토리에서 composer.json파일을 만드는 즉시 그 디렉토리는 패키지가 된다. 여러분은 require를 프로젝트에 추가할 때 다른 패키지에 의존하는 패키지를 만드는 셈이다. 여러분의 프로젝트와 라이브러리의 차이점은 여러분의 프로젝트가 이름 없는 패키지라는 점이다.

그 패키지를 설치 가능하도록 하기 위해서 이름을 지정해야한다. composer.json 파일에서 name 속성을 추가한다.

{
    "name": "acme/hello-world",
    "require": {
        "monolog/monolog": "1.0.*"
    }
}

프로젝트 이름이 acme/hello-world인 경우에 acme 부분은  벤더 이름이다. 벤더 이름을 제공하는 것은 필수이다.

참고: 만약 여러분이 벤더 이름을 어떤 것으로 사용 할 지 모르겠다면 보통 GitHub 사용자 이름이 괜찮다. 패키지 이름은 대소문자를 구별하고 있지만 모두 소문자로 하고 단어 구분은 하이픈으로 사용하는 것을 규칙으로 하고 있다.

플랫폼 패키지

컴포저에는 플랫폼 패키지가 있는데 시스템에 설치되어 있는 가상 패키지이지만 실제로는 컴포저가 설치한 것이 아니다. 이는 PHP 자체, PHP 확장 기능, 몇몇 시스템 라이브러리를 포함하고 있다.

• php는 제약 조건을 적용할 수 있도록 사용자 PHP 버전을 나타낸다. 예: >=5.4.0. PHP에 64비트 버전을 요청하기 위해 여러분은 php-64bit 패키지를 요청할 수 있다.
• hhvm는 HHVM 실행 시간 (아카 힙홉 가상 머신) 버전을 나타내고 제약 조건을 적용할 수 있다. 예: '>=2.3.3'.
• ext-<name>은 PHP 확장 기능 (코어 확장을 포함) 을 요구할 수 있다. 버전 지정은 여기에 아주 일치하지 않을 수도 있기에 보통 별표 (*) 로 제약 조건을 설정하는 것이 좋다. 확장 패키지 이름 예시는 ext-gd이다.
• lib-<name>은 PHP가 사용하는 라이브러리 버전을 만들도록 제약 조건을 걸 수 있다. 다음은 <name> 부분에 사용할 수 있는 내용이다 : curl, iconv, icu, libxml, openssl, pcre, uuid, xsl.

로컬에서 사용할 수 있는 플랫폼 패키지 리스트를 보려면 show --platform을 사용하면 된다.

버전 지정하기

패키지스트에서 여러분의 패키지를 발행할 때 VCS (git, svn, hg) 정보에서 버전을 유추할 수 있다. 이는 여러분이 명시적으로 선언할 필요가 없다는 것을 의미한다. 버전 숫자가 어떻게 추출되는지 태그와 브랜치를 읽어보자.

수동으로 패키지를 만들어서 거나 명시적으로 지정해야 하는 경우 여러분은 그저 version 항목을 추가하면 된다.

{
    "version": "1.0.0"
}

참고: 여러분은 되도록이면 명시적으로 버전 항목을 지정하지 않도록 해야한다. 왜냐하면 태그 값은 태그 이름과 일치해야 하기 때문이다.

태그

버전처럼 보이는 모든 태그의 경우 해당 태그의 패키지 버전이 생성될 것이다. 패키지 버전은 -patch (-p), -alpha (-a), -beta (-b), RC의 선택적인 접미사와 함께 'X.Y.Z'나 'vX.Y.Z' 형식과 일치해야 한다. 접미사 뒤에는 숫자가 따라올 수도 있다.

다음은 유효한 태그 이름의 예제들이다.

• 1.0.0
• v1.0.0
• 1.10.5-RC1
• v4.4.4-beta2
• v2.0.0-alpha
• v2.0.4-p1

참고: 여러분의 태그가 v로 시작할지라도 require 구문에서 버전 제약은 접두사 없이 지정해야한다. (예: 태그 v1.0.0은 버전 1.0.0가 된다.)

브랜치

모든 브랜치의 경우 패키지 개발 버전이 생성된다. 브랜치 이름이 버전 이름과 같으면 버전은 {branchname}-dev가 될 것이다. 예를 들어 브랜치 2.0은 2.0.x-dev 버전을 얻는다 (.x는 브랜치로 인식하기 위해 기술적인 이유로 추가됨). 또한 2.0.x 브랜치는 유효할 뿐 아니라 2.0.x-dev로 전환된다. 만약 브랜치가 버전과 같지 않으면 dev-{branchname}가 될 것이다. master는 dev-master 버전이 된다.

다음은 버전 브랜치 이름에 관련된 예시이다.

• 1.x
• 1.0 (1.0.x와 같음)
• 1.1.x

참고: 여러분이 개발 버전을 설치하면 그 source에서 자동으로 가져올 것이다. 더 자세한 내용은 install를 참고하라.

별칭

버전에 브랜치 별칭을 지정할 수 있다. 예를 들어 여러분은 dev-master를 1.0.x-dev로 지정하고 모든 패키지에서 1.0.x-dev를 요구할 수 있다.

더 자세한 내용은 별칭을 참고하라.

잠금 파일

라이브러리의 경우에 여러분이 원하면 composer.lock 파일을 커밋할 수 있다. 이는 여러분의 팀이 동일한 의존성 버전으로 테스트할 수 있도록 도와준다. 그러나 이 잠금 파일은 그것에 의존하는 다른 프로젝트에 어떤 영향도 주지 않을 것이다. 메인 프로젝트에만 영향을 줄 뿐이다.

만약 여러분이 잠금파일을 원하지 않으면서 git을 사용하고 있다면 .gitignore에 추가하라.

VCS로 발행하기

만약 composer.json 파일을 포함하는 VCS 저장소 (버전 관리 시스템, 예: git) 가 있으면 여러분의 라이브러리는 이미 컴포저가 설치할 수 있는 상태이다. 이 경우에 우리는 github.com/username/hello-world 밑에서 GitHub에 acme/hello-world 라이브러리를 발행할 것이다.

이제 acme/hello-world 패키지를 설치 테스트하기 위해서 로컬에 새 프로젝트를 생성한다. 우리는 acme/blog를 호출할 것이다. 이 블로그는 acme/hello-world에 의존하고 또 그것은 monolog/monolog에 의존하고 있을 것이다. 우리는 어딘가에 새 blog 디렉토리를 생성하고 composer.json를 포함하여 수행할 수 있다.

{
    "name": "acme/blog",
    "require": {
        "acme/hello-world": "dev-master"
    }
}

우리는 라이브러리로 이 블로그를 발행하고 싶지 않기 때문에 이 경우에 이름은 반드시 필요하지 않는다. 이름은 composer.json에 기술되는 것을 명확히 하기 위해 추가하였다.

이제 우리는 블로그 앱이 hello-world 의존성을 찾도록 설정해야한다. 우리는 블로그의 composer.json 패키지에 저장소 사양을 추가하여 이 작업을 수행할 수 있다.

{
    "name": "acme/blog",
    "repositories": [
        {
            "type": "vcs",
            "url": "https://github.com/username/hello-world"
        }
    ],
    "require": {
        "acme/hello-world": "dev-master"
    }
}

패키지 저장소가 동작하는 것과 사용할 수 있는 다른 종류에 대해서 더 자세히 알고 싶다면
저장소를 참고하라.

그게 다이다. 여러분은 이제 컴포저 install 명령어를 실행하여 의존성을 설치할 수 있다!

요약: composer.json 를 포함하는 모든 git/svn/hg 저장소는 캐피지 저장소를 지정하고 require 항목에서 의존성을 정의하는 것으로 여러분의 프로젝트에 추가할 수 있다.

패키지스트 발행하기

자, 이제 여러분은 패키지를 발행할 수 있다. 그러나 매번 VCS 저장소를 지정하 것은 번거롭다. 여러분은 모든 사용자가 그렇게 하도록 강요하면 안된다.

여러분이 눈치챈 다른 것은 monolog/monolg를 위한 패키지 저장소를 지정하지 않았다는 것이다. 어떻게 동작하는 것일까? 대답은 패키지스트이다.

패키지스트는 컴포저를 위한 매인 패키지 저장소이고 기본적으로 활성화되어 있다. 패키지스트에서 발행된 모든 것은 컴포저를 통해서 자동으로 사용 가능하다. 모놀로그는 패키지스트에 있기 때문에 우리는 저장소를 추가로 지정하지 않고도 의존할 수 있다.

만약 전세계에 hello-world를 공유하고 싶다면 물론 패키지스트에 발행하면 된다. 이렇게 하면 정말 간단하다.

여러분은 간단히 패키지스트에 방문하고 "Submit"을 누른다. 가입되어 있지 않다면 가입하라는 메세지가 뜰 것이고 패키지스트가 크롤링을 시작하는 지점에서 여러분의 VCS 저장소에서 URL을 전송할 수 있도록 한다. 완료되면 여러분의 패키지는 누구나 사용 할 수 있다!

continue reading [번역] 의존성 관리 도구 컴포저 - 라이브러리

[번역] 의존성 관리 도구 컴포저 - 기본 사용법(Basic usage)

개인 소장용으로 번역한 자료입니다.
참고용으로만 봐주시고, 틀린 점이 있으면 언제든 태클 걸어주세요.

* url: https://getcomposer.org/doc/01-basic-usage.md

기본 사용법

소개

기본 사용법을 소개하면서 로깅 라이브러리인 monolog/monolog를 설치할 것이다. 아직 컴포저를 설치하지 않았다면 소개 장을 참조하라.

참고: 단순화를 위해 이 소개는 컴포저의 로컬 설치를 가정할 것이다.

composer.json: 프로젝트 세팅

프로젝트에 컴포저를 사용하기 위해서 여러분은 composer.json 파일이 필요하다. 이 파일은 여러분의 프로젝트의 의존성에 대해서 기술할 뿐 아니라 다른 메타데이터도 포함할 수 있다.

require 키

composer.json에서 지정할 첫 번째 (또는 자주 할) 일은 require 키이다. 여러분은 프로젝트에 의존하는 패키지를 컴포저에 간단히 지정할 수 있다.

{
    "require": {
        "monolog/monolog": "1.0.*"
    }
}

보다시피 require은 패키지 이름 (예: monolog/monolog) 을 패키지 버전 (예: 1.0.*) 으로 매핑한 객체를 가져온다.

패키지 이름

패키지 이름은 벤더 이름과 프로젝트 이름으로 구성된다. 보통 벤더 이름과 프로젝트 이름은 동일하다. 벤더 이름은 그저 이름 충돌을 막기 위해 존재하기 때문이다. 벤더 이름은 서로 다른 두 사람이 각각 igorw/json과 seldaek/json으로 json이라는 같은 이름의 라이브러리를 생성할 수 있도록 한다.

우리는 여기서 monolog/monolog를 요구하고 있고 벤더 이름은 프로젝트의 이름과 동일하다. 고유한 프로젝트 이름을 사용하는 것이 좋다. 나중에 같은 네임스페이스 아래서 연관된 프로젝트를 많이 추가할 수 있기 때문이다. 여러분이 라이브러리를 유지한다면 더 작은 부분으로 나누기 쉬울 것이다.

패키지 버전

이전 예제에서 우리는 모놀로그 버전 1.0.* 을 요청했다. 이는 1.0 개발 브랜치의 버전을 의미한다. 그 버전은 >=1.0<1.1과 일치하는 버전에 해당한다.

버전 제약은 몇 가지 방법으로 지정할 수 있고 이 주제에 대한 자세한 정보는 버전 문서를 참조하라.

안정성

기본적으로 안정된 릴리즈만 대상으로 한다. 만약 의존성의 RC, 베타, 알파, 개발 버전을 얻으려면 안정성 플래그를 사용하여 얻을 수 있다. 의존성 하나당 수행하는 것 대신 모든 패키지를 변경하려면 여러분은 최소 안정성 설정을 사용할 수 있다.

의존성 설치

프로젝트에서 정의된 의존성을 설치하려면 그저 install 명령어를 실행하면 된다.

php composer.phar install

이 명령어는 제공된 버전 제약과 일치하는 monolog/monolog의 최신 버전을 찾고 vendor 디렉토리로 다운로드 한다. 이것은 vendor라는 디렉토리로 외부 코드를 놓는 규약이다. 모놀로그의 경우 vendor/monolog/monolog로 놓는다.
팁: 여러분의 프로젝트가 git을 사용한다면 아마 vendor를 .gitignore에 추가해야 한다. 절대 저장소의 모든 코드를 추가하면 안된다.

여러분은 install 명령이 composer.lock 파일도 만들었다는 것을 알 수 있다.

composer.lock - 잠금파일

의존성 설치 후 컴포저는 composer.lock 파일에 설치해야 할 정확한 버전 리스트를 작성할 것이다. 이것은 특정 버전으로 프로젝트를 고정한다.

버전 컨트롤에 애플리케이션의 (composer.json과 함께) composer.lock을 커밋한다.

이 내용은 중요하다. 왜냐하면 잠금파일이 존재하면 install 명령어는 체크하여 그곳에 (composer.json에 뭐라고 적혀있든지) 지정된 버전을 다운로드 하기 때문이다.

잠금 파일을 커밋하는 것은 프로젝트를 설정하는 그 누구도 의존성에서 정확히 같은 버전을 다운로드 하지 않을 것을 의미한다. 여러분의 CI 서버, 생산 기기, 여러분 팀의 다른 개발자, 모든 것과 모두는 구축하는 일부에 영향을 미치는 버그를 완화하는 동일한 의존성에서 실행한다. 심지어 여러분이 프로젝트 재설치로 6달 동안 혼자 개발할 때도 새로운 버전으로 많이 릴리즈 되더라도 설치된 의존성은 여전히 동작한다고 느낄 수 있다.

만약에 composer.lock 파일이 없으면 컴포저는 composer.json에서 의존성과 버전을 읽고 update와 install 명령어를 실행한 후에 잠금 파일을 만들 것이다.

잠금 파일을 만든다는 것은 의존성의 새로운 버전이 나오더라도 여러분은 자동으로 업데이트 받지 않는다는 것을 의미한다. 새로운 버전으로 업데이트 하려면 update 명령어를 사용한다. 그러면 매칭되는 (여러분의 composer.json 파일에 따라서) 최근 버전을 받을 것이고 새로운 버전으로 잠금파일을 갱신할 것이다.

php composer.phar update

참고: composer.lock과 composer.json 파일이 동기화되어 있지 않으면 install 명령어를 실행할 때 경고를 표시할 것이다.

만약 의존성 하나에만 설치나 업데이트를 원한다면 허용 목록에 추가할 수 있다.

php composer.phar update monolog/monolog [...]

참고: 라이브러리의 경우 잠금 파일을 반드시 커밋할 필요는 없다.
라이브러리-잠금파일 참고

패키지스트

패키지스트는 메인 컴포저 저장소이다. 컴포저 저장소는 기본적으로 패키지를 얻을 수 있는 곳인 패키지 소스이다. 패키지스트는 모두가 사용하는 중앙 저장소가 되는 것이 목표이다. 이것은 사용 가능한 어떤 패키지든 자동으로 require할 수 있다는 것을 의미한다.

패키지스트 웹사이트를 방문하면 여러분은 패키지를 둘러보고 검색할 수 있다.

컴포저를 사용하는 어떤 오픈 소스 프로젝트도 자신의 패키지를 패키지스트에 발행하는 것이 좋다. 라이브러리는 컴포저가 사용하는 패키지스트에 있을 필요는 없지만 다른 개발자들이 더 빠르게 탐색하고 도입할 수 있게 해준다.

오토로딩

컴포저는 자동으로 로드하는 정보를 지정한 라이브러리의 경우에 vendor/autoload.php 파일을 생성한다. 여러분은 간단하게 이 파일을 포함하고 자유롭게 오토로딩을 할 수 있다.

require 'vendor/autoload.php';

이 코드는 실제로 외부 코드를 사용하기 쉽게 해준다. 예를 들면 프로젝트가 모놀로그에 의존하고 있다면 여러분은 그저 클래스를 사용하면 자동으로 클래스를 불러온다.

$log = new Monolog\Logger('name');
$log->pushHandler(new Monolog\Handler\StreamHandler('app.log', Monolog\Logger::WARNING));

$log->addWarning('Foo');

여러분은 심지어 composer.json에서 autoload 항목을 추가하는 것으로 오토로더를 여러분의 코드에 추가할 수 있다.

{
    "autoload": {
        "psr-4": {"Acme\\": "src/"}
    }
}

컴포저는 Acme 네임스페이스로 PSR-4 오토로더를 등록할 것이다.

여러분은 디렉토리에서 네임스페이스 매핑을 정의한다. src 디렉토리는 여러분의 프로젝트 루트에서 vendor 디렉토리와 같은 단계가 될 것이다. 예제 파일이름은 Acme\Foo 클래스를 포함한 src/Foo.php가 될 것이다.

autoload 항목을 추가한 후에 여러분은 vendor/autoload.php 파일을 다시 생성하기 위해 dump-autoload를 재실행 해야한다.

해당 파일을 포함하는 것 또한 오토로더 인스턴스를 반환합니다, 그래서 여러분은 변수에 해당 반환값을 저장하고 네임스페이스를 더 추가할 수 있다. 예를 들어 이 예제는 테스트 프로그램에서 클래스를 자동으로 불러오는 데에 유용할 수 있다.

$loader = require 'vendor/autoload.php';
$loader->add('Acme\\Test\\', __DIR__);

PSR-4 오토로드에 추가적으로 컴포저에는 클래스 맵과 파일 오토로드인 PSR-0이 지원된다. 더 자세한 내용은 autoload 를 참조하면 된다.

참고: 컴포저는 자신의 오토로드를 제공한다. 만약 여러분이 제공하는 것을 사용하고 싶지 않다면 자신의 오토로드를 구성할 수 있도록 연관배열을 반환하는 vendor/composer/autoload_*.php 파일을 포함하면 된다.

continue reading [번역] 의존성 관리 도구 컴포저 - 기본 사용법(Basic usage)

[번역] 의존성 관리 도구 컴포저 시작하기 - 소개(Intro)

컴포저에 대해서 소개글을 읽다보니 해석하느라 내용이 눈에 잘 안들어와서 번역 해 보았습니다. 시간 나면 다음 것도 번역해볼까 하지만, 발 번역이라 컴포저에 대한 국문 내용이 필요하신 분들께 죄송하네요. 이 글은 그냥 참고용으로만...

* url: https://getcomposer.org/doc/00-intro.md

소개s

컴포저는 PHP 의존성 관리 도구이다. 프로젝트에서 요구하는 의존 라이브러리를 선언하고 프로젝트에 설치하는 것을 도와준다.

의존성 관리

컴포저는 패키지 관리자가 아니다. 그렇다, "패키지"나 라이브러리를 다루기는 하지만 프로젝트 단위로 관리하고 프로젝트 디렉토리 (예: vendor) 안에서 설치 한다. 기본적으로 절대 전역 설치하지는 않는다. 그래서 의존성 관리자이다.

이 아이디어는 새로운 것은 아니며 컴포저는 nodejs의 npm이나 루비의 bundler에서 크게 영향을 받았다. 그러나 그 당시 PHP를 위한 도구같은 건 없었다.

컴포저는 다음과 같은 문제를 해결 해 준다.

a) 몇몇 라이브러리에 의존하는 프로젝트가 있다.
b) 어떤 라이브러리는 다른 라이브러리에 의존적이다.
c) 의존성을 선언한다.
d) 컴포저는 설치에 필요한 패키지의 버전을 찾아서 설치한다 (프로젝트에 다운 받는 것을 의미한다).

의존성 선언

프로젝트를 생성하고 로그 기록하는 라이브러리가 필요하다고 해보자. 여러분은 monolog를 사용하기로 결정했다. 프로젝트에 추가하기 위해 해야 할 일은 composer.json 파일에 프로젝트 의존성을 선언하는 것이다.

{
 "require": {
  "monolog/monolog": "1.2.*"
 }
}

우리는 프로젝트가 어떤 monolog/monolg 패키지를 요구하는지 간단하게 작성했다. 모든 버전은 1.2로 시작한다.

시스템 요구

컴포저는 PHP 5.3.2 이상이어야 동작한다. 몇몇 세심한 PHP 설정과 컴파일 표시가 필요하지만 설치 프로그램을 진행할 때 호환성에 대한 경고가 표시 된다.
간단한 zip 아카이브 대신에 소스 패키지를 설치하려면 패키지 버전 컨트롤에 따라 git, svn, hg가 필요하다.
컴포저는 멀티 플랫폼을 지원하고 우리는 윈도우, 리눅스, OSX에서 똑같이 동작하도록 노력하고 있다.

설치 - 리눅스 / 유닉스 / OSX

실행 가능 한 컴포저 다운로드

짧지만 컴포저를 설치하는데 2가지 방법이 있다. 프로젝트의 일부분으로서 지역적으로 또는 어디에서나 실행가능하도록 전역적으로 설치하는 방법이 있다.

지역 설치 (Locally)

컴포저 지역 설치는 그냥 프로젝트 디렉토리 안에서 실행하면 된다.

curl -sS https://getcomposer.org/installer | php

참고: 어떠한 이유로 실패하면 php 대신에 인스톨러를 다운받을 수 있다.

php -r "readfile('https://getcomposer.org/installer');" | php

인스톨러는 몇몇 PHP 설정을 체크하고 작업 디렉토리에 composer.phar 를 다운받을 것이다. 이 파일은 컴포저 바이너리 파일이다. PHAR (PHP 아카이브) 라고 하는데 다른 것들 사이에서 명령줄로 실행할 수 있는 PHP 아카이브 형식이다.

--install-dir 옵션을 사용하여 지정 디렉토리(절대 경로나 상대 경로일 수 있다)를 제공하는 것으로 컴포저를 특정 디렉토리에 설치할 수 있다.

curl -sS https://getcomposer.org/installer | php -- --install-dir=bin

전역 설치 (Globally)

여러분은 이 파일을 여러분이 원하는 어디에나 놓을 수 있다. 시스템 속성 PATH에 설정하면 여러분은 전역적으로 접근할 수 있다. 유닉스 시스템에서 심지어 php 없이 실행가능하게 하고 호출 할 수 있다.

여러분은 시스템 어디에나 쉽게 composer에 접근하기 위해서 이 명령어를 실행할 수 있다.

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

참고: 권한 때문에 실패했다면 sudo 권한으로 mv 줄을 다시 실행하라.

참고: 요세미티 OSX에서 /usr 디렉토리는 기본적으로 존재하지 않는다.  "/usr/local/bin/composer: No such file or directory" 라는 에러가 나면  진행하기 전에 /usr/local/bin/ 폴더를 수동으로 생성한다.

그리고 나서 컴포저를 실행하기 위해 php phpcomposer.phar 명령 대신에 composer 명령을 실행한다.

설치 - 윈도우즈

인스톨러 이용하기

이 방법은 가장 쉽게 컴포저를 설정할 수 있는 방법이다.

Composer-Setup.exe를 다운로드 받고 실행한다. 최신 컴포저 버전을 설치하고 PATH 를 세팅하면 어느 디렉토리에서나 명령 줄로 composer 명령을 그냥 실행하는 것으로 호출할 수 있다.

참고: 현재 터미널을 닫는다. 새로운 터미널로 사용 테스트를 한다. 터미널 시작할 때 경로만 로드하기 때문에 중요하다.

수동 설치

환경변수 PATH 디렉토리를 변경하고 composer.phar를 다운 받을 수 있는 설치 조각을 실행한다.

C:\Users\username>cd C:\bin
C:\bin>php -r "readfile('https://getcomposer.org/installer');" | php

노트: 위의 readfile 때문에 실패한다면 http 주소를 사용하거나 php.ini에서 php_openssl.dll을 사용 설정 한다.

composer.phar 파일로 새 composer.bat 파일을 만든다.

C:\bin>echo @php "%~dp0composer.phar" %*>composer.bat

아직 설정되어 있지 않으면 환경변수 PATH에 디렉토리를 추가한다. 현재 터미널을 닫는다. 그리고 새 터미널을 열어서 테스트 한다.

C:\Users\username>composer -V
Composer version 27d8904

컴포저 이용하기

우리는 이제 컴포저로 프로젝트 의존성 설치할 것이다. 현재 디렉토리에 composer.json 파일이 없다면 기본 사용법 부분을 넘어가도 된다.

의존성을 해결하고 다운로드하기 위해서 install 명령어를 실행한다.

php composer.phar install

만약 전역 설치를 했고 그 디렉토리에 phar가 없다면 이 명령어를 실행하라

composer install

위의 의존성 선언 예제를 따라서 vendor/monolog/monolog 디렉토리로 monolog를 다운로드 받을 것이다.

오토로딩

라이브러리를 다운로드 받는 것 외에 컴포저는 다운로드한 라이브러리의 어떤 클래스든 자동으로 불러올 수 있는 오토로드 파일을 준비한다. 컴포저를 사용하기 위해서는 그냥 코드의 부트 스트랩 과정에 저 줄을 따라서 추가해주면 된다.

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

와우! 이제 monolog를 사용할 수 있다! 컴포저에 대해서 더 배우고 싶으면 "기본 사용법" 장을 계속 읽으면 된다.

continue reading [번역] 의존성 관리 도구 컴포저 시작하기 - 소개(Intro)