웹사이트 검색

Ubuntu 14.04에서 Composer를 설치하고 사용하는 방법


소개

Composer는 널리 사용되는 PHP용 종속성 관리 도구로, 주로 프로젝트 종속성에 대한 설치 및 업데이트를 용이하게 하기 위해 만들어졌습니다. 특정 프로젝트가 의존하는 다른 패키지를 확인하고 프로젝트 요구 사항에 따라 적절한 버전을 사용하여 설치합니다.

이 튜토리얼은 Ubuntu 14.04 서버에서 Composer를 설치하고 시작하는 방법을 보여줍니다.

전제 조건

이 자습서에서는 다음이 필요합니다.

  • Ubuntu 14.04를 실행하는 서버
  • sudo 권한이 있는 일반 사용자로 서버에 액세스

1단계 - 종속성 설치

Composer를 다운로드하고 설치하기 전에 서버에 모든 종속성이 설치되어 있는지 확인해야 합니다.

먼저 다음을 실행하여 패키지 관리자 캐시를 업데이트합니다.

  1. sudo apt-get update

이제 종속성을 설치하겠습니다. Composer를 다운로드하려면 curl이 필요하고 설치 및 실행을 위해서는 php5-cli가 필요합니다. git은 Composer에서 프로젝트 종속성을 다운로드하는 데 사용됩니다. 다음 명령으로 모든 것을 설치할 수 있습니다.

  1. sudo apt-get install curl php5-cli git

이제 다음 단계로 진행할 수 있습니다.

2단계 - Composer 다운로드 및 설치

Composer 설치는 정말 간단하며 단일 명령으로 수행할 수 있습니다.

  1. curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer

이렇게 하면 Composer가 /usr/local/bin 아래에 composer라는 시스템 전체 명령으로 다운로드 및 설치됩니다. 출력은 다음과 같아야 합니다.

Output
#!/usr/bin/env php All settings correct for using Composer Downloading... Composer successfully installed to: /usr/local/bin/composer Use it: php /usr/local/bin/composer

설치를 테스트하려면 다음을 실행하십시오.

  1. composer

그러면 다음과 유사한 출력이 표시됩니다.

Output
______ / ____/___ ____ ___ ____ ____ ________ _____ / / / __ \/ __ `__ \/ __ \/ __ \/ ___/ _ \/ ___/ / /___/ /_/ / / / / / / /_/ / /_/ (__ ) __/ / \____/\____/_/ /_/ /_/ .___/\____/____/\___/_/ /_/ Composer version 1.0-dev (9859859f1082d94e546aa75746867df127aa0d9e) 2015-08-17 14:57:00 Usage: command [options] [arguments] Options: --help (-h) Display this help message --quiet (-q) Do not output any message --verbose (-v|vv|vvv) Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug --version (-V) Display this application version --ansi Force ANSI output --no-ansi Disable ANSI output --no-interaction (-n) Do not ask any interactive question --profile Display timing and memory usage information --working-dir (-d) If specified, use the given directory as working directory. . . .

이는 Composer가 시스템에 성공적으로 설치되었음을 의미합니다.

이 서버에서 호스팅할 수 있는 각 프로젝트에 대해 별도의 Composer 실행 파일을 갖고 싶다면 프로젝트별로 로컬에 간단히 설치할 수 있습니다. 이 방법은 시스템 사용자에게 시스템 전체에 소프트웨어를 설치할 수 있는 권한이 없는 경우에도 유용합니다. 이 경우 curl -sS https://getcomposer.org/installer | php - 현재 디렉토리에 composer.phar 파일을 생성하며 php composer.phar [command]로 실행할 수 있습니다.

3단계 - composer.json 파일 생성

프로젝트에서 Composer를 사용하려면 composer.json 파일이 필요합니다. composer.json 파일은 기본적으로 Composer에게 프로젝트에 대해 다운로드해야 하는 종속성과 설치가 허용된 각 패키지의 버전을 알려줍니다. 이것은 프로젝트의 일관성을 유지하고 이전 버전과의 호환성 문제를 일으킬 수 있는 불안정한 버전의 설치를 피하는 데 매우 중요합니다.

이 파일을 수동으로 만들 필요가 없습니다. 그렇게 하면 구문 오류가 발생하기 쉽습니다. Composer는 require 명령을 사용하여 프로젝트에 종속성을 추가할 때 composer.json 파일을 자동으로 생성합니다. 이 파일을 수동으로 편집할 필요 없이 동일한 방식으로 추가 종속성을 추가할 수도 있습니다.

Composer를 사용하여 패키지를 프로젝트의 종속성으로 설치하는 프로세스에는 일반적으로 다음 단계가 포함됩니다.

  • 애플리케이션에 필요한 라이브러리 종류 식별
  • Composer의 공식 저장소인 Packagist.org에서 적합한 오픈 소스 라이브러리를 조사합니다.
  • 의존하려는 패키지를 선택하십시오
  • composer require를 실행하여 composer.json 파일에 종속성을 포함하고 패키지를 설치합니다.

간단한 데모 애플리케이션을 통해 이것이 실제로 어떻게 작동하는지 살펴보겠습니다.

이 애플리케이션의 목표는 주어진 문장을 URL에 친숙한 문자열인 슬러그로 변환하는 것입니다. 이것은 일반적으로 페이지 제목을 URL 경로로 변환하는 데 사용됩니다(예: 이 자습서의 URL 마지막 부분).

프로젝트를 위한 디렉토리를 생성하는 것부터 시작하겠습니다. 우리는 그것을 slugify라고 부를 것입니다:

  1. cd ~
  2. mkdir slugify
  3. cd slugify

Packagist에서 패키지 검색

이제 Packagist.org에서 슬러그 생성에 도움이 되는 패키지를 검색할 차례입니다. Packagist에서 "slug\라는 용어를 검색하면 다음과 유사한 결과를 얻을 수 있습니다.

목록의 각 패키지 오른쪽에 두 개의 숫자가 표시됩니다. 상단의 숫자는 패키지가 설치된 횟수를 나타내고 하단의 숫자는 패키지가 GitHub에서 별표 표시된 횟수를 나타냅니다. 이 숫자를 기준으로 검색 결과를 재정렬할 수 있습니다(검색 표시줄 오른쪽에 있는 두 개의 아이콘을 찾으십시오). 일반적으로 더 많은 설치와 더 많은 별이 있는 패키지는 더 많은 사람들이 사용하기 때문에 더 안정적인 경향이 있습니다. 관련성에 대한 패키지 설명을 확인하는 것도 중요합니다. 정말 당신이 찾고 있는 것입니까?

우리에게 필요한 것은 간단한 string-to-slug 변환기입니다. 검색 결과에서 패키지 cocur/slugify는 적당한 양의 설치와 별점으로 잘 일치하는 것 같습니다. (패키지는 스크린샷에 표시된 것보다 페이지에서 약간 더 아래에 있습니다.)

Packagist의 패키지에는 공급업체 이름과 패키지 이름이 있음을 알 수 있습니다. 각 패키지에는 Github가 리포지토리에 사용하는 것과 동일한 형식인 vendor/package의 고유 식별자(네임스페이스)가 있습니다. 설치하려는 라이브러리는 네임스페이스 cocur/slugify를 사용합니다. 네임스페이스는 프로젝트에서 패키지를 요구하기 위해 필요한 것입니다.

패키지 필요

이제 설치하려는 패키지를 정확히 알았으므로 composer require를 실행하여 패키지를 종속성으로 포함하고 프로젝트에 대한 composer.json 파일도 생성할 수 있습니다.

  1. composer require cocur/slugify
Output
Using version ^1.3 for cocur/slugify ./composer.json has been created Loading composer repositories with package information Updating dependencies (including require-dev) - Installing cocur/slugify (v1.3) Downloading: 100% Writing lock file Generating autoload files

출력에서 볼 수 있듯이 Composer는 사용할 패키지 버전을 자동으로 결정했습니다. 지금 프로젝트의 디렉토리를 확인하면 composer.jsoncomposer.lockvendor 디렉토리라는 두 개의 새 파일이 포함됩니다.

  1. ls -l
Output
total 12 -rw-rw-r-- 1 sammy sammy 59 Sep 9 16:22 composer.json -rw-rw-r-- 1 sammy sammy 2835 Sep 9 16:22 composer.lock drwxrwxr-x 4 sammy sammy 4096 Sep 9 16:22 vendor

composer.lock 파일은 설치된 각 패키지의 버전에 대한 정보를 저장하고 다른 사람이 프로젝트를 복제하고 종속 항목을 설치하는 경우 동일한 버전이 사용되는지 확인하는 데 사용됩니다. vendor 디렉토리는 프로젝트 종속성이 있는 위치입니다. vendor 폴더는 버전 관리에 커밋하면 안 됩니다. composer.json 및 composer.lock 파일만 포함하면 됩니다.

이미 composer.json 파일이 포함된 프로젝트를 설치할 때 프로젝트의 종속 항목을 다운로드하려면 composer install을 실행해야 합니다.

버전 제약 이해

composer.json 파일의 내용을 확인하면 다음과 같은 내용이 표시됩니다.

  1. cat composer.json
  1. {
  2. "require": {
  3. "cocur/slugify": "^1.3"
  4. }
  5. }

composer.json의 버전 번호 앞에 특수 문자 ^가 있는 것을 볼 수 있습니다. Composer는 유연성을 제공하는 동시에 프로젝트를 안정적으로 유지하기 위해 필요한 패키지 버전을 정의하기 위한 여러 가지 제약 조건과 형식을 지원합니다. 자동 생성된 composer.json 파일에서 사용하는 캐럿(^) 연산자는 시맨틱 버전 관리에 따라 최대 상호 운용성을 위해 권장되는 연산자입니다. 이 경우 1.3을 최소 호환 버전으로 정의하고 2.0 미만의 향후 버전에 대한 업데이트를 허용합니다.

일반적으로 composer.json 파일의 버전 제약을 변경할 필요가 없습니다. 그러나 일부 상황에서는 제약 조건을 수동으로 편집해야 할 수 있습니다. 예를 들어 필요한 라이브러리의 주요 새 버전이 출시되어 업그레이드하려는 경우 또는 사용하려는 라이브러리가 시맨틱 버전 관리를 따르지 않는 경우입니다.

다음은 Composer 버전 제약 조건의 작동 방식을 더 잘 이해할 수 있는 몇 가지 예입니다.

Constraint Meaning Example Versions Allowed
^1.0 >= 1.0 < 2.0 1.0, 1.2.3, 1.9.9
^1.1.0 >= 1.1.0 < 2.0 1.1.0, 1.5.6, 1.9.9
~1.0 >= 1.0 < 2.0.0 1.0, 1.4.1, 1.9.9
~1.0.0 >= 1.0.0 < 1.1 1.0.0, 1.0.4, 1.0.9
1.2.1 1.2.1 1.2.1
1.* >= 1.0 < 2.0 1.0.0, 1.4.5, 1.9.9
1.2.* >= 1.2 < 1.3 1.2.0, 1.2.3, 1.2.9

Composer 버전 제약에 대한 자세한 내용은 해당 공식 문서를 확인하세요.

4단계 - 자동 로드 스크립트 포함

Composer는 또한 프로젝트에 포함하여 무료로 자동 로드할 수 있는 자동 로드 스크립트를 제공합니다. 이렇게 하면 종속 항목으로 작업하고 고유한 네임스페이스를 정의하는 것이 훨씬 쉬워집니다.

클래스 인스턴스화 전에 PHP 스크립트에 vendor/autoload.php 파일을 포함하기만 하면 됩니다.

slugify 예제 애플리케이션으로 돌아가 봅시다. cocur/slugify 라이브러리를 사용할 test.php 스크립트를 생성합니다.

  1. vim test.php
  1. <?php
  2. require __DIR__ . '/vendor/autoload.php';
  3. use Cocur\Slugify\Slugify;
  4. $slugify = new Slugify();
  5. echo $slugify->slugify('Hello World, this is a long sentence and I need to make a slug from it!');

다음을 사용하여 명령줄에서 스크립트를 실행할 수 있습니다.

  1. php test.php

이렇게 하면 hello-world-this-is-a-long-sentence-and-i-need-to-make-a-slug-from-it 출력이 생성됩니다.

5단계 - 프로젝트 종속성 업데이트

프로젝트 종속성을 업데이트할 때마다 update 명령을 실행하기만 하면 됩니다.

  1. composer update

이렇게 하면 프로젝트에 필요한 최신 버전의 라이브러리가 있는지 확인합니다. 최신 버전이 발견되고 composer.json 파일에 정의된 버전 제약 조건과 호환되는 경우 설치된 이전 버전을 대체합니다. composer.lock 파일은 이러한 변경 사항을 반영하도록 업데이트됩니다.

다음을 실행하여 하나 이상의 특정 라이브러리를 업데이트할 수도 있습니다.

  1. composer update vendor/package vendor2/package2

결론

Composer는 모든 PHP 개발자의 유틸리티 벨트에 있어야 하는 강력한 도구입니다.

프로젝트 종속성을 관리하기 위한 쉽고 안정적인 방법을 제공하는 것 외에도 커뮤니티에서 생성된 PHP 패키지를 공유하고 검색하기 위한 새로운 사실상의 표준을 설정합니다.

이 튜토리얼에서는 Ubuntu 14.04에서 Composer를 시작하기 위한 필수 사항을 다뤘습니다.