Rocky Linux 8에 PHP Composer 설치하는 방법

PHP Composer는 PHP에서 가장 많이 사용되는 의존성 관리 도구입니다. 프로젝트에 필요한 의존성을 선언할 수 있으며, 이를 관리(설치/업데이트)해 줍니다.

의존성을 다운로드하고 설치하고 업데이트하는 것은 번거로울 수 있으며, 실제로 코드를 작성하는 데서 주의를 분산시킬 수 있습니다. 의존성 관리 도구는 이를 처리하여 개발자로서의 삶을 더 쉽게 만들어 줍니다.

Composer가 있기 전에는 PEAR 및 PHP 패키지 관리자와 같은 몇 가지 다른 옵션이 있었습니다. 현재 Composer는 PHP에서 의존성 관리의 사실상 표준이 되었습니다.

여전히 PEAR 또는 PHP 패키지 관리자를 사용하고 있다면, 변경할 때가 되었을 수 있습니다. Composer를 사용해야 하는 몇 가지 이유가 있습니다:

• PHP로 작성되어 있으며 추가 소프트웨어 설치가 필요 없습니다(예: Python)
• 글로벌 및 로컬/개인 패키지를 모두 지원합니다
• 수천 개의 라이브러리와 애플리케이션이 이미 이를 의존하고 있으므로 Composer를 사용하면 패키지와 업데이트를 쉽게 찾을 수 있습니다.

전제 조건

Rocky Linux 8.4에 PHP Composer를 설치하려면 다음이 필요합니다:

• 시스템에 PHP 버전 5.3 이상이 설치되어 있어야 하며(Phar 확장을 실행할 수 있어야 함).
• 설치를 위해 루트 접근 권한이 필요합니다.

시스템 업데이트

다른 작업을 하기 전에 시스템의 패키지가 최신인지 확인하십시오. 다음 명령어를 실행하여 시스템 패키지를 업데이트하십시오.

sudo dnf check-update

sudo dnf update -y

Rocky Linux 8.4에 PHP 설치하기

Composer를 설치하기 전에 시스템에 PHP와 PHP 인터프리터가 설치되어 있어야 합니다.

기본적으로 AppStream 저장소에는 PHP 7.2, 7.3 및 7.4가 포함되어 있습니다. 아래 명령어를 실행하여 사용 가능한 모든 PHP 버전을 나열할 수 있습니다.

sudo dnf module list php

아래와 같은 출력이 표시됩니다.

이 가이드에서는 PHP 7.4를 설치합니다. 필요에 맞는 PHP 버전을 선택해야 하지만, 이 가이드뿐만 아니라 호환성 보고서를 기반으로 결정을 내리십시오.

다음 명령어를 실행하여 PHP 7.4를 활성화하고 설치하십시오.

sudo dnf module enable php:7.4

sudo dnf install php php-cli php-gd php-curl php-zip -y

sudo dnf install php-mbstring php-opcache php-intl php-mysqlnd -y

이제 다음 명령어를 실행하여 PHP가 올바르게 설치되었는지 확인할 수 있습니다.

php -v

다음과 같은 출력을 얻어야 합니다.

Rocky Linux 8.4에 PHP Composer 설치하기

이제 시스템에 PHP 버전이 설치되었으므로 이를 사용하여 Composer 바이너리를 다운로드하고 설치할 수 있습니다.

먼저, 다음 명령어를 실행하여 Composer의 최신 버전을 다운로드하십시오.

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"

다음으로, 다운로드한 파일이 손상되지 않았는지 확인합니다. 다운로드한 파일이 손상되지 않았는지 항상 확인해야 합니다. Composer는 매우 민감할 수 있으며, 오류가 발생하면 Composer 사용에 문제가 생길 수 있습니다. 다음 코드를 실행하여 설치 파일이 손상되지 않았는지 확인하십시오.

HASH=`curl -sS https://composer.github.io/installer.sig`

echo $HASH

php -r "if (hash_file('SHA384', '/tmp/composer-setup.php') === '$HASH') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"

검증이 성공하면 아래와 같이 “Installer verified”라는 텍스트가 표시됩니다. 예상 출력이 나오지 않으면 파일이 손상되었을 가능성이 높으므로 다시 다운로드해 보십시오. 그런 다음 예상되는 “Installer verified” 출력을 얻을 때까지 검증 과정을 반복하십시오.

이제 시스템에 Composer를 설치할 수 있는 두 가지 옵션이 있습니다.

옵션 1은 Composer를 시스템에 전역적으로 설치하는 것입니다. 즉, 시스템의 모든 디렉토리에서 접근할 수 있으며 어디에서나 사용할 수 있습니다. Composer를 PHP 프로젝트의 의존성 관리 도구로만 사용하지 않고 명령줄 도구로 사용하려는 경우 이 옵션을 사용하십시오.

이 옵션을 선택하면 다음 명령어를 실행하십시오.

sudo php composer-installer.php --filename=composer --install-dir=/usr/local/bin 

위 명령어는 /usr/local/bin에 composer라는 이름으로 Composer를 전역적으로 설치합니다.

이제 다음 명령어를 실행하여 Composer가 올바르게 설치되었는지 확인할 수 있습니다.

composer

다음과 같은 출력을 얻어야 합니다.

옵션 2는 현재 디렉토리에 Composer를 로컬로 설치하여 이 특정 프로젝트에서만 사용하도록 하는 것입니다.

Composer를 로컬로 설치하려면 다음 명령어를 실행하십시오.

sudo php composer-setup.php

위 명령어는 현재 디렉토리에 Composer를 로컬로 설치하여 이 특정 프로젝트에서만 사용하도록 합니다. ./composer.phar 를 실행하여 Composer를 사용할 수 있습니다.

PHP Composer 테스트하기

이제 Composer를 설치했으므로 이를 사용하여 Composer 설치를 테스트할 수 있는 새 프로젝트를 생성할 수 있습니다.

작업하는 모든 프로젝트에 대해 항상 별도의 디렉토리를 생성하는 것이 좋습니다. 다음 명령어를 실행하여 테스트 프로젝트를 위한 새 디렉토리를 만들고 새로 생성된 디렉토리로 이동하십시오.

cd && mkdir php-composer-test && cd php-composer-test

이제 다음 명령어를 실행하여 Composer로 새 프로젝트를 초기화할 수 있습니다.

composer init

위 명령어는 선택한 모든 세부정보로 새 프로젝트를 초기화합니다.

composer init 명령어는 아래와 같이 현재 디렉토리에 새 composer.json 파일도 생성합니다. 이 파일은 프로젝트 요구 사항을 포함하는 JSON 형식의 파일입니다. Composer는 이 파일을 사용하여 프로젝트에 필요한 의존성을 설치합니다.

이제 프로젝트에 패키지를 로드할 시간입니다. https://packagist.org로 이동하여 프로젝트에 설치할 패키지를 검색하십시오.

예를 들어, 문자열에서 불용어를 제거하는 데 도움이 되는 Remove Stop Words 패키지를 설치하려는 경우 Packagist에서 “Remove Stop Words”라는 용어를 검색하면 다음과 같은 결과가 표시됩니다.

새 패키지를 추가하려면 composer require 명령어를 실행하고 현재 프로젝트에 로드할 패키지를 선택하십시오(버전 없이).

composer require rap2hpoutre/remove-stop-words

Composer는 사용할 패키지 버전을 자동으로 결정합니다. Composer는 Packagist에서 현재 디렉토리로 패키지를 다운로드하고 이 패키지의 내용을 추출합니다.

또한 composer.json 파일을 이 새로운 패키지에 대한 세부정보로 업데이트합니다. composer.lock이라는 새 파일과 아래와 같은 새 vendor 디렉토리도 생성합니다.

composer.lock 파일은 Composer가 현재 프로젝트에 설치된 패키지 버전을 고정하는 데 사용됩니다. 이 파일은 동일한 패키지의 다른 설치와 충돌을 피하기 위해 사용되며, 프로젝트를 복제할 때도 사용됩니다. vendor 디렉토리에는 프로젝트의 모든 의존성이 포함되어 있습니다.

프로젝트 의존성을 업데이트하려면 composer update 명령어를 실행하십시오. Composer는 먼저 composer.lock 파일을 확인하여 이미 설치된 패키지 버전을 확인한 다음, Packagist에서 사용 가능한 최신 버전으로 이 패키지를 업데이트합니다.

composer update

샘플 출력:

특정 패키지를 업데이트하려면 다음 명령어를 실행하십시오.

composer update vendor/package

특정 패키지를 제거하려면 다음 명령어를 실행하십시오.

composer remove vendor/package

예를 들어, 더 이상 Remove Stop Words 패키지가 필요하지 않은 경우 다음 명령어를 실행하여 프로젝트에서 제거할 수 있습니다.

composer remove rap2hpoutre/remove-stop-words

샘플 출력:

참고: 애플리케이션을 실행하는 데 필요한 모든 의존성이 Composer로 설치되기 때문에 vendor 디렉토리나 그 내용을 삭제하지 않는 것이 좋습니다.

결론

이 기사에서는 Rocky Linux 8.4에 PHP Composer PHP 의존성 관리 도구를 설치하여 새 프로젝트를 초기화하고, 새 패키지를 로드하고, 기존 패키지를 업데이트하거나 프로젝트에서 제거하는 방법을 배웠습니다. 또한 프로젝트의 의존성을 관리하는 데 사용되는 몇 가지 기본 Composer 명령어도 배웠습니다.

질문이나 피드백이 있으면 아래에 댓글을 남겨주세요.