PHP CLI 버전 불일치 수정하는 법

보내주신 이미지를 보니 PHP CLI 버전 불일치(웹: 8.3.30, CLI: ?) 경고가 뜨고 있네요!

이 경고는 웹 브라우저가 사용하는 PHP 버전(8.3.30)과 윈도우 시스템 터미널(CMD/PowerShell)이 바라보는 PHP 버전이 서로 다르거나, 터미널 쪽 설정(CLI)이 시스템에 제대로 잡히지 않아 그누보드가 버전을 읽지 못할 때 발생합니다.

라라벨 기반인 그누보드7은 터미널 명령어를 자주 쓰기 때문에 이 설정을 맞춰주는 것이 좋습니다. Laragon 환경에서 가장 빠르고 확실하게 해결하는 방법 2가지를 알려드릴게요.

🛠️ 해결 방법 1: Laragon 내장 터미널 사용하기 (가장 추천)

윈도우 자체 CMD나 PowerShell 대신 Laragon이 제공하는 터미널을 사용하면 별도의 환경 변수 설정 없이 이 문제가 즉시 해결됩니다. Laragon 내장 터미널은 웹 서버와 동일한 PHP 버전을 자동으로 공유하기 때문입니다.

1. Laragon 프로그램 창에서 [터미널 (Terminal)] 버튼을 클릭합니다.
2. 새까만 터미널 창이 뜨면, 그누보드가 설치된 폴더로 이동합니다.
3. Bash

    

   cd C:\laragon\www\bbs
   

4. 이 상태에서 설치 페이지를 새로고침(F5) 해보세요. 라라곤 터미널이 켜져 있는 동안에는 CLI 버전을 올바르게 인식하여 경고가 사라집니다.

🛠️ 해결 방법 2: 윈도우 시스템 환경 변수(Path) 수정하기

만약 VS Code 터미널이나 윈도우 기본 CMD를 계속 쓰고 싶으시다면, 시스템 환경 변수에 등록된 PHP 경로를 Laragon의 PHP 8.3.30 경로로 업데이트해 주어야 합니다.

1. Laragon 프로그램 빈 곳을 마우스 우클릭합니다.
2. [Tools] ➔ [Path] ➔ [Add Laragon to PATH]를 클릭합니다.
   • 이 기능은 Laragon이 가지고 있는 PHP 8.3.30 경로를 윈도우 시스템에 자동으로 등록해 줍니다.
3. 윈도우 권한 승인 창이 뜨면 [예]를 누릅니다.
4. 설정이 끝났다면, 기존에 열려 있던 모든 에디터(VS Code 등)와 터미널 창을 완전히 종료했다가 다시 실행합니다.
5. 새로 연 터미널에 php -v를 입력했을 때 PHP 8.3.30이 정상적으로 출력되는지 확인하고 설치 페이지를 새로고침(F5) 합니다.

⚠️ 참고 항목 (선택 버튼) 우측의 [선택] 버튼은 필수 사항이 아닌 '권장 사항'일 때 주로 활성화됩니다. 만약 방법 1이나 2를 적용했는데도 여전히 노란색 경고가 남아있다면, 오른쪽의 [선택] 버튼을 눌러 강제로 다음 단계로 넘어가셔도 초기 설치 및 구동에는 문제가 없습니다. 편하신 방법으로 진행해 보세요!