호스팅어 SSH 환경에서 Composer 2 설치가 필요한 이유

Drupal이나 Laravel 같은 PHP 기반 프레임워크를 제대로 설치하고 관리하려면 Composer가 반드시 필요합니다. 특히 Drupal에서는 Composer 2.x 이상이 권장되며, 호스팅어(Hostinger)처럼 GUI 기반 패널 위주인 호스팅 환경에서도 SSH 기능을 활용하면 Composer를 직접 설치해 활용할 수 있습니다. 이 글에서는 호스팅어에서 SSH 접속 후 Composer 2.x를 설치하는 방법을 차근차근 설명합니다.

1. SSH 접속 후 준비 작업

먼저 SSH로 호스팅어 서버에 접속해야 합니다. SSH 접속 방법은 호스팅어의 '고급' → 'SSH 접근' 메뉴에서 확인할 수 있습니다. 접속이 완료되면 홈 디렉토리로 이동하고 실행 파일을 저장할 bin 디렉토리를 만들어줍니다.

cd ~
mkdir -p ~/bin

2. Composer 설치 스크립트 다운로드

Composer 설치를 위한 공식 스크립트를 다운로드합니다.

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

3. Composer 2.x 설치하기

이제 Composer 2.x를 설치합니다. 설치 경로와 파일명을 지정하여 $HOME/bin/composer라는 이름으로 저장되도록 설정합니다.

php composer-setup.php --2 --filename=composer --install-dir=$HOME/bin

이제 ~/bin/composer에 Composer 2가 설치되며, 직접 실행할 수 있습니다.

4. PATH에 Composer 등록하기

설치한 Composer가 현재 세션에서 인식되도록 환경변수 PATH를 수정합니다.

export PATH="$HOME/bin:$PATH"

설정 후 아래 명령으로 Composer 버전을 확인해 봅니다.

composer --version

Composer version 2.x.x 형식의 메시지가 나오면 정상적으로 설치된 것입니다.

5. 로그인 시마다 자동으로 PATH 인식되게 하기

지금까지 설정한 PATH는 현재 세션에만 적용됩니다. 다음 로그인 시에도 Composer를 사용하려면 .bashrc 또는 .profile 파일에 추가해 줘야 합니다.

echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bashrc
echo 'export PATH="$HOME/bin:$PATH"' >> ~/.profile

• .bashrc는 일반적인 Bash 셸 환경에서 사용되고,
• .profile은 일부 시스템에서 사용됩니다. 둘 다 등록해도 무방합니다.

Composer 2 설치 후 활용 팁

이제 Composer를 통해 Drupal 프로젝트를 설치하거나 모듈, 테마 등을 관리할 수 있습니다. Composer 기반 프로젝트의 버전 충돌이나 종속성 문제를 해결할 때도 Composer 2는 훨씬 더 빠르고 효율적입니다.

Drupal 공식 문서에서는 Composer 기반 설치를 권장하고 있으므로, 이 방법을 통해 호스팅어에서도 개발 환경을 유연하게 운영할 수 있습니다.