PHP 버전 확인 옵션 (-v)

PHP -v 옵션은 ‘Version’의 머리글자에서 가져온 가장 친숙하고 기초적인 명령어 옵션입니다.

단순히 PHP 버전이 몇 번인지 숫자를 확인해 주는 역할뿐만 아니라, 컴파일 빌드 당시의 프로세서 아키텍처, 스레드 지원 유무, 사용된 컴파일러 도구 및 Zend VM 가상머신 최적화 사양까지 한눈에 판독할 수 있는 다각적인 시스템 정보를 내포하고 있습니다.

1. 사용법 및 출력 사양 상세 분석

터미널 콘솔창에 옵션을 실행하여 출력을 덤프합니다.

$ php -v
PHP 8.3.6 (cli) (built: Apr 15 2026 18:22:10) ( NTS Visual C++ 2019 x64 )
Copyright (c) The PHP Group
Zend Engine v4.3.6, Copyright (c) Zend Technologies
    with Zend OPcache v8.3.6, Copyright (c) Zend Technologies

출력되는 텍스트 정보를 라인별로 정교하게 쪼개 분석하면 아래와 같은 사양을 식별해 낼 수 있습니다.

1) 첫 번째 행: PHP 코어 및 빌드 명세

• PHP 8.3.6: 현재 작동 중인 PHP 엔진의 메이저.마이너.패치 버전 정보입니다.
• (cli): 이 실행 파일이 웹 연동용 CGI나 FPM이 아니라 콘솔 터미널 전용 인터페이스 SAPI(CLI) 모드로 조립되었음을 보여줍니다.
• (built: ...): 패키지가 컴파일되어 최종 릴리즈 패키징이 만들어진 타임스탬프 시점입니다.
• NTS (또는 ZTS):
  • NTS: Non-Thread Safe 스키마로 컴파일된 상태입니다. 멀티 프로세스 가동에 특화되어 속도가 더 빠릅니다.
  • ZTS / TS: Zend Thread Safe로 컴파일된 사양입니다. 스레드 동시성 데이터 잠금 방어 코드가 들어가 있습니다.
• Visual C++ 2019: 빌드 시 사용된 윈도우용 컴파일러 엔진 규격입니다. (Windows 사양 한정)
• x64 (또는 x86): 64비트 가상 메모리 주소 체계를 점유하여 구동하는 이진 바이너리임을 보여줍니다.

2) 세 번째 행: 가상머신 엔진 및 부가 가속기 탑재 사양

• Zend Engine v4.3.6: PHP 코드를 바이트 코드로 구문 분석해 명령을 실행하는 핵심 코어 가상머신 엔진 버전입니다.
• with Zend OPcache ...: 캐시 컴파일 가속기인 OPcache 모듈이 연동 탑재되어 켜져 있음을 보여줍니다. 여기에 with JIT 표시가 추가되어 있다면, 최신 가속 엔진인 JIT 컴파일러가 실시간 동작 중인 사양임을 교차 확인할 수 있습니다.

2. 실무에서의 버전 확인의 가치

• Composer 패키지 종속성 검증: 타사 오픈소스 라이브러리를 다운로드해 얹기 위해 패키지 매니저(Composer)를 실행할 때, 내 로컬 환경의 PHP 엔진 버전과 확장 모듈 아키텍처가 라이브러리 최소 요구 조건에 만족하는지 버전을 검사하고 대조하는 기초 용도로 널리 사용됩니다.
• 확장 모듈(DLL) 수동 매칭: 윈도우 환경 등에서 타사 데이터베이스 드라이버나 확장 모듈(.dll 파일)을 추가하여 php.ini에 얹으려 할 때, 파일 이름에 적힌 버전 규칙(예: php_redis-5.3.4-8.3-nts-vc16-x64.zip)이 php -v로 판독한 사양(버전 8.3, NTS, x64)과 한 치의 오차도 없이 1:1로 일치해야만 시스템 로딩 에러가 발생하지 않습니다.