XAMPP 설치 후 macOS에서 'PHP를 찾을 수 없음' 오류를 수정하는 방법

macOS 개발자가 XAMPP를 사용하여 로컬 개발 환경을 설정할 때 종종 "PHP를 찾을 수 없음" 오류가 발생합니다. XAMPP가 PHP와 함께 제공되더라도 터미널은 여전히 ​​php 명령을 인식하지 못할 수 있습니다.

이 문서에서는 이 문제를 해결하고 시스템이 PHP를 찾을 수 있는지 확인하는 방법을 단계별로 안내합니다.

오류 이해

다음 명령을 실행하세요:

<code class="language-bash">php -v</code>

다음과 같은 오류 메시지가 표시되는 경우:

<code>php not found</code>

이는 시스템 셸(예: zsh 또는 bash)이 해당 환경에서 PHP 실행 파일을 찾을 수 없음을 의미합니다. XAMPP에 자체 PHP 바이너리가 포함되어 있어도 이러한 현상이 발생합니다. PHP가 포함된 디렉터리가 셸의 $PATH에 포함되어 있지 않기 때문입니다.

이 문제를 해결해 보겠습니다!

1단계: XAMPP 설치에서 PHP 찾기

XAMPP에는 자체 PHP 설치가 포함되어 있으며 일반적으로 다음 디렉터리에 있습니다.

<code class="language-bash">/Applications/XAMPP/xamppfiles/bin/php</code>

이 위치에 PHP 실행 파일이 있는지 확인하려면 다음을 실행하세요.

<code class="language-bash">ls /Applications/XAMPP/xamppfiles/bin/php</code>

이 명령이 PHP 파일을 나열한다면 올바른 방향으로 가고 있는 것입니다.

2단계: XAMPP의 PHP를 셸의 PATH에 추가

PHP 실행 파일을 전역적으로 사용할 수 있게 하려면 XAMPP PHP 디렉터리를 셸의 $PATH에 추가해야 합니다.

Zsh 사용자(macOS 기본 셸)

macOS Catalina부터는 zsh가 기본 셸입니다. $PATH를 업데이트하려면 다음 단계를 따르세요.

1. .zshrc 파일을 엽니다.

<code class="language-bash">nano ~/.zshrc</code>

2. 파일 끝에 다음 줄을 추가하세요.

<code class="language-bash">export PATH="/Applications/XAMPP/xamppfiles/bin:$PATH"</code>

3. Ctrl O를 누른 다음 Enter를 누르고 마지막으로 Ctrl X를 눌러 파일을 저장하고 닫습니다.

4. 다음 명령을 실행하여 변경 사항을 즉시 적용하세요.

<code class="language-bash">source ~/.zshrc</code>

Bash 사용자

아직 bash를 셸로 사용하고 있다면 .bash_profile을 편집하세요.

<code class="language-bash">nano ~/.bash_profile</code>

같은 줄 추가:

<code class="language-bash">export PATH="/Applications/XAMPP/xamppfiles/bin:$PATH"</code>

다음을 사용하여 변경 사항을 저장하고 적용합니다.

<code class="language-bash">source ~/.bash_profile</code>

3단계: PHP 설치 확인

$PATH를 업데이트한 후 php 명령이 작동하는지 테스트합니다.

<code class="language-bash">php -v</code>

XAMPP와 함께 제공되는 PHP 버전이 표시되어야 합니다. 예를 들면 다음과 같습니다.

<code>PHP 8.2.4 (cli) (built: Apr  6 2023 04:12:41) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.2.4, Copyright (c) Zend Technologies</code>

성공했다면 축하드립니다! 이제 시스템이 php 명령을 인식합니다.

4단계: 터미널 다시 시작(선택 사항)

위 단계가 즉시 적용되지 않으면 터미널을 다시 시작하고 php -v를 다시 실행해 보세요. 경우에 따라 셸 구성 파일에 대한 변경 사항을 적용하려면 터미널을 다시 시작해야 합니다.

대안: Homebrew를 사용하여 PHP 설치

번들 버전의 XAMPP를 사용하는 대신 시스템 전체 PHP 설치를 선호하는 경우 Homebrew를 사용하여 PHP를 설치할 수 있습니다.

1. 아직 Homebrew를 설치하지 않았다면 설치하세요:

<code class="language-bash">/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"</code>

2. PHP 설치:

<code class="language-bash">brew install php</code>

3. 설치 확인:

<code class="language-bash">php -v</code>

이렇게 하면 최신 버전의 PHP가 설치되고 $PATH가 자동으로 구성됩니다.

결론

"PHP를 찾을 수 없음" 오류는 셸의 $PATH 작동 방식을 이해하면 빠르게 수정할 수 있습니다. XAMPP의 PHP를 PATH에 추가하든, Homebrew를 선택하든 이 가이드를 통해 즉시 실행이 가능하도록 도와드립니다. 이제 가장 중요한 일인 훌륭한 앱 개발에 집중할 수 있습니다!

이 가이드가 도움이 되었는지 댓글로 알려주시거나 macOS에서 PHP를 관리하기 위한 팁을 공유해 주세요!

위 내용은 XAMPP 설치 후 macOS에서 'PHP를 찾을 수 없음' 오류를 수정하는 방법의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!