PHP 확장 모듈 목록 및 관리(ServBay 내장)

ServBay는 강력한 로컬 웹 개발 환경으로, 각 PHP 버전마다 자주 사용되는 PHP 확장 모듈을 사전 설치해 제공합니다. ServBay는 직관적인 그래픽 사용자 인터페이스(GUI)를 제공하여, 더 이상 php.ini 파일을 직접 수정하지 않고도 내장 확장 모듈을 손쉽게 활성화 또는 비활성화할 수 있습니다. 이를 통해 PHP 개발 환경 구성 과정을 크게 단순화할 수 있습니다.

ServBay에서 내장 PHP 확장 모듈 관리 방법

ServBay의 GUI를 통해 PHP 확장 모듈을 관리하면, 다양한 프로젝트의 요구 사항에 맞게 환경을 빠르게 조정할 수 있습니다.

확장 관리 화면 접속 방법

원하는 PHP 버전의 확장 관리 패널을 열려면 다음 단계를 따라 주세요:

1. ServBay 애플리케이션을 실행합니다.
2. ServBay 메인 화면의 왼쪽 내비게이션 바에서 **소프트웨어 패키지(Packages)**를 클릭합니다.
3. 오른쪽에 표시되는 패키지 리스트에서 구성할 PHP 버전(예: PHP 8.3)을 찾아 선택하세요.
4. 해당 PHP 버전을 클릭하여 상세 설정 영역을 펼치고, Extension 탭으로 이동합니다.

주요 내장 확장 소개

Extension 탭에는 선택한 PHP 버전에 내장된 관리 가능한 확장이 나열되어 있습니다. 아래는 많이 사용하는 확장 모듈과 그 간단한 설명입니다:

• MongoDB: PHP에서 MongoDB 데이터베이스와 연동할 수 있게 해줍니다.
• OPcache: 컴파일된 스크립트 바이트코드를 공유 메모리에 저장하여 PHP 스크립트 실행 성능을 크게 향상시킵니다. 활성화 시 메모리 제한, 파일 수 등의 매개변수를 설정할 수 있습니다.
• Phalcon: C 확장으로 구현된 고성능 풀스택 PHP 프레임워크입니다.
• Redis: PHP와 Redis 키-값 저장 시스템 간에 통신 기능을 제공합니다.
• SCWS: 중국어 형태소 분석을 위한 PHP 확장입니다.
• Swoole: 고성능 비동기 이벤트 드리븐 네트워크 프레임워크입니다.
• Xdebug: 강력한 PHP 디버깅, 성능 분석, 코드 커버리지 도구입니다. 활성화 후에는 디버깅 모드, 클라이언트 포트 등 파라미터를 추가로 설정해 디버거 연결을 할 수 있습니다.

참고: 사용 가능한 내장 확장 리스트 및 세부 설정 옵션은 선택한 PHP 버전과 ServBay 업데이트에 따라 다를 수 있습니다.

확장 활성화 및 비활성화

Extension 탭에서 확장을 직관적으로 관리할 수 있습니다.

1. 활성화 또는 비활성화하고자 하는 확장 모듈을 찾으세요.
2. 각 확장 옆에는 토글 스위치가 있습니다.
   • 스위치를 눌러 **파란색(혹은 채워진 상태)**가 되면 해당 확장이 활성화된 것입니다.
   • 스위치를 눌러 **회색(혹은 비어있는 상태)**가 되면 해당 확장이 비활성화된 것입니다.

확장 매개변수 설정(해당하는 경우)

OPcache, Xdebug와 같이 일부 확장은 활성화 후 우측에 추가 설정 옵션이 나타납니다.

• ServBay 인터페이스에서 OPcache 공유 메모리 크기, Xdebug 디버깅 포트와 모드 등 다양한 파라미터를 직접 조정할 수 있습니다.

변경사항 저장 및 자동 적용

• 확장의 활성화 상태 또는 매개변수를 수정한 뒤에는 화면 우측 하단의 Save 버튼을 반드시 클릭해야 합니다.
• 중요: Save 클릭 시, ServBay가 자동으로 관련 PHP 서비스(보통 PHP-FPM 또는 Apache/Nginx 모듈; 설정에 따라 다름)를 재로드 또는 재시작해 변경 사항을 즉시 적용합니다. 수동으로 서비스를 중지/시작할 필요가 없습니다.

변경사항 적용 여부 확인

ServBay가 변경 사항을 자동 적용하긴 하지만, 아래 방법으로 확장이 정상적으로 활성화 또는 비활성화되었는지 직접 확인할 수 있습니다:

1. phpinfo() 함수 사용: 웹사이트 루트 디렉토리(예: /Applications/ServBay/www 아래의 특정 프로젝트 폴더)에 <?php phpinfo(); ?>를 내용으로 하는 PHP 파일을 만들고, 웹 브라우저로 접속하세요. 생성된 페이지에서 활성화 또는 비활성화한 확장 이름을 검색하면 관련 설정 정보를 확인할 수 있습니다.
2. 명령줄에서 확인: 터미널을 열고 아래 명령어를 실행하면 현재 PHP 버전에 로드된 모든 모듈을 볼 수 있습니다(경로의 8.3 부분을 실제 설정한 ServBay PHP 버전으로 바꿔 사용).

   /Applications/ServBay/package/php/8.3/current/bin/php -m

   출력된 목록에서 변경한 확장 이름이 존재하는지 확인하면 됩니다.

중요: 내장 확장과 서드파티(제3자) 확장의 차이점

• ServBay의 Extension 탭은 ServBay가 미리 컴파일·통합한 내장 확장만 관리합니다.
• 서드파티 PHP 확장(예: 특정 ionCube Loader 버전, ServBay 기본 내장에 없는 .so 파일)을 추가하고 싶다면, ServBay 문서의 “커스텀 PHP 확장 모듈 로드하기” 가이드를 참고해야 합니다. 보통 직접 확장 파일을 지정 디렉토리에 넣고, PHP 버전 설정 페이지의 Additional Parameters 영역에 extension= 또는 zend_extension= 지시문을 수동 추가해야 합니다. 직접 설정이 끝난 뒤에도 Save 버튼을 눌러야 ServBay가 서비스를 자동 재시작해 해당 확장이 적용됩니다.

ServBay 내장 PHP 확장 모듈 전체 목록

ServBay는 현재 아래 PHP 확장 모듈을 내장하고 있습니다. 실제 지원 모듈과 버전은 ServBay 및 선택한 PHP 버전에 따라 다를 수 있습니다. 각 PHP 버전에 대한 최신 내장 모듈 리스트는 ServBay 공식 패키지 페이지를 참고하시기 바랍니다.

ServBay에 기본 포함된 주요 PHP 확장 모듈은 다음과 같습니다:

• apcu
• bcmath
• bz2
• calendar
• Core
• ctype
• curl
• date
• dba
• dom
• exif
• fileinfo
• filter
• ftp
• gd
• gettext
• gmp
• hash
• iconv
• imagick
• imap
• intl
• json
• ldap
• libxml
• mbstring
• memcache
• memcached
• mongodb
• mysqli
• mysqlnd
• openssl
• pcntl
• pcre
• PDO
• pdo_mysql
• pdo_pgsql
• pdo_sqlite
• pgsql
• phalcon
• Phar
• posix
• random
• readline
• redis
• Reflection
• scws
• session
• shmop
• SimpleXML
• soap
• sockets
• sodium
• SPL
• sqlite3
• standard
• swoole
• sysvsem
• sysvshm
• tidy
• tokenizer
• xdebug
• xml
• xmlreader
• xmlwriter
• xsl
• Zend OPcache
• zip
• zlib

ServBay를 이용하면 로컬 개발 프로젝트에 최적화된 PHP 환경을 손쉽게 구성하고, 이와 같은 강력한 확장 모듈을 빠르게 활성화·비활성화하여 개발 효율성과 환경의 유연성을 높일 수 있습니다.