Composer 설치 및 중국 내 미러 소스로 전환

최근 이 사이트에 Flarum beta11을 사용하고 싶은데 어떻게 다운로드하는지 모르겠다는 댓글이 하나 달렸습니다. Flarum이라고 하면 저도 정말 오랫동안 사용하지 않았는데, 주된 이유는 업데이트 진행이 느리고 몇 년이 지나도 정식 버전이 나오지 않았기 때문입니다(사실 beta 버전도 매우 안정적입니다).

예전에는 Meto 님의 Flarum CV 버전을 계속 사용했는데, 이후 그분이 프로젝트를 그만두면서 CV 버전도 결국 0.7.4에 머물렀습니다.

{cat_insidepost id="96"}

오랜만에 Flarum을 다시 검색해 보니, 몇몇 Flarum 중국어 사이트가 Flarum 중국어 번역 프로젝트 개발을 중단한 것을 발견했습니다. 다행히 공식 커뮤니티는 여전히 꽤 활발했고, 최근에는 beta11 버전까지 업데이트되었습니다. 이렇게 여러 버전이 지나면서 중국어 지원도 훨씬 좋아진 것 같아 더 이상 중국어 버전을 찾지 않고 바로 공식 버전을 사용하기로 했습니다. 공식적으로 권장하는 설치 방법은 Composer를 사용하는 것이므로, 먼저 Composer를 설치해 보겠습니다.

Composer 다운로드

먼저 PHP 환경이 이미 설치되어 있고 명령줄에서 사용할 수 있는지 확인해야 합니다. PHP 5.3 이상의 버전이 필요하며 OpenSSL을 활성화해야 합니다. 임의의 디렉터리에서 php -v를 입력해 PHP-CLI를 사용할 수 있는지 확인합니다

이렇게 나오면 사용할 수 있는 것입니다. 이제 Composer 다운로드를 시작합니다:

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
# 설치 스크립트 다운로드
php composer-setup.php
# 설치 과정 실행
php -r "unlink('composer-setup.php');"
# 설치 스크립트 삭제

Composer 설치

로컬 설치

위의 Composer 다운로드 과정이 정상적으로 완료되면 composer.phar 파일을 임의의 디렉터리(예: 프로젝트 루트 디렉터리)에 복사한 다음 php composer.phar 명령어를 통해 Composer를 사용할 수 있습니다.

전역 설치(권장)

전역 설치는 Composer를 시스템 환경 변수 PATH에 포함된 경로에 설치하는 방식입니다. 그러면 명령줄 창에서 바로 composer 명령어를 실행할 수 있습니다:

mv composer.phar /usr/local/bin/composer

설치가 끝난 후 composer --version을 사용해 버전 번호가 정상적으로 출력되는지 확인합니다. Composer를 항상 최신 버전으로 유지하려면 composer self-update를 자주 실행하는 것도 잊지 마세요!

미러 소스 변경

Composer는 기본적으로 packagist.org의 소스를 사용하기 때문에 중국 내 서버에서 접속할 때 특히 느립니다. 몇 년 전 Composer가 아직 그렇게 널리 사용되지 않았을 때는 중국 내에 Composer 중국어 사이트 하나만 중국 내 미러 소스를 제공했습니다.

시험 삼아 사용해 보았는데, 현재는 공식 소스보다 접속 속도가 더 느려 정말 사용할 수 없는 수준입니다. 하지만 Composer가 발전하면서 많은 대형 업체가 Composer 미러 소스에 참여하게 되었으니, 이제 Composer의 기본 소스를 변경해 보겠습니다.

알리바바 클라우드 Composer 미러
https://mirrors.aliyun.com/composer/
텐센트 클라우드 Composer 미러
https://mirrors.cloud.tencent.com/composer/
화웨이 클라우드 Composer 미러
https://repo.huaweicloud.com/repository/php/
안창 클라우드 Composer 미러
https://php.cnpkg.org

동기화 빈도가 빠르고 속도도 매우 안정적인 알리바바 클라우드 사용을 강력히 추천합니다.

전역 설정(권장)

모든 프로젝트에서 이 미러 주소를 사용하게 됩니다:

composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

설정 취소:

composer config -g --unset repos.packagist

프로젝트 설정

현재 프로젝트의 설정만 변경하며, 현재 프로젝트에서만 이 미러 주소를 사용할 수 있습니다:

composer config repo.packagist composer https://mirrors.aliyun.com/composer/

설정 취소:

composer config --unset repos.packagist

오늘은 여기까지 하겠습니다. 내일 다시 Composer를 사용해 Flarum beta11을 설치하는 방법을 작성하겠습니다.