ServBay에서 웹사이트 및 스크립트의 PHP 버전 지정하기

웹 개발자라면 서로 다른 PHP 버전을 사용하는 여러 프로젝트를 동시에 다루거나, 특정 PHP 버전에서 코드 호환성을 테스트해야 할 경우가 많습니다. 강력한 로컬 개발 환경 도구인 ServBay는 PHP 버전의 관리와 전환을 매우 유연하게 지원합니다. 이 문서에서는 ServBay에서 프로젝트 단위, PHP 스크립트별, 전체 웹사이트 대상으로 PHP 실행 환경을 지정하는 다양한 방법을 자세히 안내합니다.

프로젝트에 특정 PHP 버전 지정하기

ServBay는 프로젝트 단위로 PHP 실행 환경을 지정하는 기능을 제공합니다. 프로젝트의 루트 디렉터리에 .servbay.config라는 파일을 생성해 원하는 PHP 버전을 지정할 수 있습니다.

특정 PHP 버전을 설정한 .servbay.config 파일 예시는 아래와 같습니다:

bash

PHP_VERSION=8.0

참고: .servbay.config 파일은 반드시 프로젝트의 루트 디렉터리에 위치해야 합니다. 일반적으로 이는 ServBay에서 웹사이트를 설정할 때 지정하는 폴더입니다. 예를 들어, 웹사이트 루트가 /Applications/ServBay/www/my-project라면, .servbay.config 파일의 위치는 /Applications/ServBay/www/my-project/.servbay.config가 됩니다.

자세한 설정 방법과 사용법은 ServBay 공식 문서의 .servbay.config 파일 섹션을 참고하세요.

PHP 스크립트별로 특정 PHP 버전 지정하기

프로젝트 전체 혹은 웹사이트 전체에 대해 PHP 버전을 고정하고 싶지 않고, 특정 스크립트만 임시로 원하는 PHP 버전으로 실행하고 싶은 경우에는 ServBay의 명령줄 도구를 활용할 수 있습니다.

ServBay의 통합 명령줄 환경에서는 php-<version> 형식의 명령어로 원하는 PHP 버전으로 스크립트를 실행할 수 있습니다. 이는 다양한 PHP 버전에서 스크립트의 동작을 손쉽게 테스트할 때 유용합니다.

예를 들어, PHP 5.6으로 version.php라는 스크립트를 실행하려면 다음과 같이 입력하면 됩니다:

bash

$ php-5.6 version.php
Hello World
PHP Version: 5.6.40

$ php-7.3 version.php
Hello World
PHP Version: 7.3.33

예시 설명

php-5.6 version.php : ServBay에 설치된 PHP 5.6 버전으로 version.php 스크립트를 명확히 실행합니다.
php-7.3 version.php : ServBay에 설치된 PHP 7.3 버전으로 version.php 스크립트를 실행합니다.

이 방법을 활용하면 프로젝트나 웹사이트의 전역 설정을 변경하지 않고도, 다양한 PHP 버전에서 쉽고 유연하게 테스트 및 실행이 가능합니다.

웹사이트 단위로 PHP 버전 지정하기

웹사이트 전체(즉, ServBay에서 설정된 가상 호스트)에 대해 고정된 PHP 버전을 지정하고 싶을 때, ServBay의 그래픽 관리 인터페이스에서 쉽게 설정할 수 있습니다.

이는 특정 사이트가 항상 지정한 PHP 버전에서 동작해야 하거나, 구버전 PHP에 의존하는 프로젝트 또는 신버전 PHP로의 호환성 이전 작업에 적합합니다.

설정 방법

ServBay 관리 인터페이스 열기
ServBay 애플리케이션을 실행하세요.
사이트 설정으로 이동
ServBay 화면의 왼쪽 네비게이션 메뉴에서 사이트를 클릭합니다.
설정할 사이트 선택
사이트 목록에서 원하는 사이트를 찾아 오른쪽에 있는 PHP 버전 드롭다운 메뉴를 클릭하세요.
PHP 버전 선택 및 저장
나타난 PHP 버전 목록에서 해당 사이트에 할당하고자 하는 PHP 버전을 선택합니다. 선택한 PHP 버전이 반드시 ServBay에 설치되어 있고 실행 중이어야 합니다. 선택 후, 화면 상단 또는 하단에 있는 저장 버튼을 눌러 변경 사항을 저장하세요.

유의사항

PHP 버전 설치 및 실행 상태 확인: PHP 버전을 지정하기 전에, ServBay의 ‘소프트웨어 패키지’ 기능을 통해 해당 PHP 버전이 설치되어 있고 ‘실행 중’ 상태인지 반드시 확인하세요. 설치 및 실행이 되지 않았다면 먼저 설치/실행을 완료해야 합니다.
호환성 테스트 권장: PHP 버전 변경 후, 즉시 사이트에 접속하여 모든 핵심 기능의 호환성을 꼼꼼히 점검하는 것이 매우 중요합니다. 모든 컴포넌트 및 코드가 새 PHP 버전에서 정상적으로 동작하는지 확인하세요.
사이트 루트 디렉터리: ServBay에서 웹사이트를 구성할 때는, /Applications/ServBay/www/ 디렉터리 내에 각 사이트별 하위 폴더를 생성해 사이트 파일을 관리하는 것이 좋습니다. 예: /Applications/ServBay/www/servbay.demo. 본 문서의 예시는 이 경로 기준으로 되어 있습니다.

요약

ServBay는 개발자에게 매우 유연하고 손쉬운 PHP 실행 환경 관리 기능을 제공합니다. 다음과 같은 방법을 활용할 수 있습니다:

프로젝트 루트에 .servbay.config 파일을 만들어 각 프로젝트별로 PHP 버전을 고정
명령줄 도구 php-<version>을 통해 특정 스크립트만 임시로 원하는 PHP 버전으로 실행
그래픽 관리 인터페이스를 이용해 전체 사이트 단위로 고정 PHP 버전 지정

이와 같이 다층적인 PHP 버전 제어 기능을 통해 ServBay는 구시스템 유지보수, 신규 기능 개발, 호환성 테스트 등 다양한 개발 요구 상황에서 뛰어난 유연성과 효율성을 제공합니다. 로컬 개발 생산성을 극대화하고 프로젝트 관리를 한층 수월하게 만들어줍니다.

ServBay에서 웹사이트 및 스크립트의 PHP 버전 지정하기 ​

프로젝트에 특정 PHP 버전 지정하기 ​

PHP 스크립트별로 특정 PHP 버전 지정하기 ​

예시 설명 ​

웹사이트 단위로 PHP 버전 지정하기 ​

설정 방법 ​

유의사항 ​

요약 ​