ServBay 명령줄 도구: 설치, 설정 및 사용 가이드

ServBay는 직관적인 그래픽 사용자 인터페이스(GUI)를 통해 로컬 개발 환경을 관리할 수 있을 뿐만 아니라, 강력한 명령줄 도구도 제공합니다. 터미널(bash 또는 zsh 등)에 ServBay 명령줄 도구를 설치하면, CLI에서 ServBay가 통합한 각종 개발 툴과 패키지를 명령어로 바로 실행할 수 있어 개발 효율성과 유연성을 극대화할 수 있습니다.

사전 준비

ServBay 명령줄 도구를 사용하기 전에 ServBay가 정상적으로 설치·실행되고 있는지 확인하세요.

ServBay 명령줄 도구 설치 방법

아래는 ServBay 명령줄 도구를 터미널 환경에 설치하는 상세 단계입니다:

ServBay 애플리케이션을 실행합니다.
ServBay 좌측 내비게이션 바에서 설정 옵션을 클릭합니다.
열린 설정 페이지에서 명령줄 도구 섹션을 찾습니다.
현재 사용 중인 터미널 환경에 따라(예: macOS 기본 터미널은 bash, 그 외 zsh 가능), 다음 버튼을 클릭하세요:
- zsh를 사용 중이라면 CLI 도구를 zsh에 설치 버튼 클릭
- bash를 사용 중이라면 CLI 도구를 bash에 설치 버튼 클릭
설치 중 시스템 환경 파일(예: .zshrc 또는 .bash_profile)을 수정하기 위해 관리자 비밀번호 입력을 요청할 수 있습니다. 설치를 허용해 주세요.
설치가 완료되면, 반드시 터미널 창을 닫았다가 다시 여세요. ServBay 명령줄 도구가 새로운 터미널 세션에서 적용됩니다.

기본 패키지 버전 설정

ServBay에서는 자주 사용하는 패키지(PHP, Node.js, MySQL 또는 MariaDB 등)의 전역 기본 버전을 설정할 수 있습니다. 이 설정을 하면 터미널에서 php, node, mysql 등 명령어를 입력할 때, ServBay GUI에서 지정한 기본 버전(또는 명령줄에서 선택한 버전)이 자동으로 적용됩니다.

전역 기본 버전 설정 방법에 대한 자세한 안내는 기본 버전 설정하기 문서를 참고하세요.

프로젝트별 명령줄 버전 지정

프로젝트별로 각기 다른 패키지 버전이 필요할 때, ServBay는 프로젝트 루트 디렉터리에 .servbay.config 파일을 생성해 프로젝트 단위로 PHP와 Node.js 버전을 지정하는 기능을 지원합니다. 이 방식은 전역 기본 설정을 덮어쓰며, 프로젝트마다 지정한 패키지 버전을 일관성 있게 사용할 수 있어 버전 충돌을 방지합니다.

.servbay.config 파일을 활용하면 PHP와 Node.js 버전뿐 아니라, Node.js 런타임, 패키지 저장소 주소, 캐시 디렉터리 등 프로젝트별 고유 설정도 가능해집니다.

자세한 설정 및 사용법은 .servbay.config 파일 사용법 문서를 참고하세요.

특정 버전의 패키지 바로 실행하기

기본 버전 또는 프로젝트별 버전 설정과 별개로, ServBay는 설치된 주요 패키지(PHP, Node.js 등) 각 버전의 실행 파일을 시스템 PATH에 직접 추가하며, 버전명을 접미사로 사용합니다(예: php-7.4, php-8.1, php-8.3). 이 덕분에 어떤 터미널 창에서도 별도의 전역/프로젝트 설정 변경 없이 특정 버전 실행 파일을 곧바로 호출할 수 있습니다.

자주 사용하는 명령어 예시

ServBay 명령줄 도구 설치 후에는 다양한 통합 툴과 명령어를 터미널에서 바로 사용할 수 있습니다. 주요 활용 예시는 다음과 같습니다:

현재 시스템 기본 PHP 버전 확인:
bash
```
php -v
```
1
현재 시스템 기본 Node.js 버전 확인:
bash
```
node -v
```
1
특정 PHP 버전으로 스크립트 실행:
bash
```
php-8.3 your_script.php
```
1
여기서 php-8.3 대신, ServBay에 설치된 다른 PHP 버전(php-7.4, php-8.1 등)으로 자유롭게 변경할 수 있습니다.
특정 버전의 phpize 도구 사용:
bash
```
phpize-8.3
```
1
phpize는 PHP 확장 모듈 빌드 환경을 준비하는 도구입니다.
PostgreSQL 데이터베이스 연결:
bash
```
psql -h localhost -U your_user -d your_database
```
1
your_user와 your_database 부분을 실제 데이터베이스의 사용자명과 데이터베이스명으로 바꿔 입력하세요.
MySQL 데이터베이스 연결:
bash
```
mysql -h localhost -u your_user -p your_database
```
1
your_user와 your_database를 실제 환경에 맞게 입력하면 됩니다. 명령어 실행 후 비밀번호 입력을 요청받습니다.
SQL 쿼리 실행 예시:
bash
```
psql -h localhost -U your_user -d your_database -c "SELECT * FROM your_table;"
```
1
-c 옵션을 사용하면 명령줄에서 직접 SQL 문장을 실행할 수 있습니다.
Redis 서비스 상태 확인:
bash
```
redis-cli info stats
```
1

이와 같은 명령어 예시를 사용해, 명령줄에서 ServBay가 제공하는 다양한 패키지와 서비스를 편리하게 이용하며 개발과 디버깅 업무의 효율성을 높일 수 있습니다.

유의 사항

명령줄 도구 설치 이후 터미널을 꼭 다시 시작해야 새 환경 변수 설정이 반영됩니다.
ServBay 내 패키지 설치 경로를 변경한 경우, 명령줄 도구를 다시 설치해야 할 수 있습니다.

요약

ServBay 명령줄 도구는 ServBay의 강력한 핵심 기능 중 하나로, 개발자에게 로컬 환경 내 다양한 툴과 패키지를 빠르고 효율적으로 관리·활용할 수 있는 방식을 제공합니다. 간단한 설치만으로 터미널에서 PHP, Node.js, 데이터베이스 등의 서비스에 쉽고 빠르게 접근할 수 있고, 기본/프로젝트별 버전 지정 등 다양한 개발 요구사항도 충족할 수 있습니다. ServBay 명령줄 도구 사용법을 잘 익히면 로컬 개발 워크플로우가 크게 향상될 것입니다.

ServBay 명령줄 도구: 설치, 설정 및 사용 가이드 ​

사전 준비 ​

ServBay 명령줄 도구 설치 방법 ​

기본 패키지 버전 설정 ​

프로젝트별 명령줄 버전 지정 ​

특정 버전의 패키지 바로 실행하기 ​

자주 사용하는 명령어 예시 ​

유의 사항 ​

요약 ​