맥에서 phpStorm Xdebug 연동

Xdebug란 php 디버깅을 위한 툴 

 

 

로컬 서버에 xdebug를 연동하는 방법

기존 php가 설치되어 있는경우 xdebug연동이 제대로 안될 수 있으니 확인 후 진행해야 함

 

1. php가 설치되어 있는 경로 확인 

brew list php

brew로 php 설치가 안되어 있을 경우 설치를 진행한다

 

 이럴 경우

brew uninstall php

php를 삭제한뒤 재설치를 권장한다 

brew install php

 

2. xdebug 설치 

homebrew로 설치 했을 경우 pecl이 자동적으로 설치 되어있다 

  ** pecl : PHP 확장 저장소 시스템 (PHP Extension Community Library)

               PHP 확장을 관리 및 배포 하는 도구

pecl install xdebug

 

 

3. php.ini에 설정 추가 

php --ini

php.ini 파일 경로 확인후 

FILE PATH : /usr/local/etc/php/[php version]/php.ini 파일을 연다

파일에 설정 추가 

[xdebug]
zend_extension="xdebug.so"
xdebug.remote_enable=1
xdebug.remote_host=127.0.0.1
xdebug.remote_port=9000
xdebug.profiler_enable=1
xdebug.profiler_output_dir=“diectory path”
xdebug.idekey=PHPSTORM
xdebug.remote_autostart=1

* diectory path는 xdebug 캐시 파일이 저장될 디렉토리를 설정하면 된다

   ex) xdebug.profiler_output_dir=“/Users/[사용자계정]/Documents/phpstorm_temp”

* xdebug는 9000번 포트를 기본값으로 사용 

* remote_host는 xdebug의 리모트 디버깅이 시작 됐을 때 디버거가 위치하는 클라이언트의 IP를 지정한다. xdebug는 이 IP를 통해서 Xdebug 클라이언트와 통신하게 된다.  

 

실제로 php.ini파일에 설정 적용

 

[2020.11.30 수정]

xdebug의 버전이 2 -> 3으로 변경되면서 설정 키값들이 변경 되었다.

xdebug.remote_enable	-> xdebug.mode
xdebug.profiler_enable
xdebug.remote_autostart (삭제됨)	-> 대체 xdebug.start_with_request
xdebug.remote_host	-> xdebug.client_host
xdebug.remote_port	-> xdebug.client_post
xdebug.profiler_output_dir	-> xdebug.ouput_dir

 

php.ini 파일 변경된 xdebug 설정

 

xdebug 설치 참고 : xdebug.org/docs/install

xdebug 설정 참고 : xdebug.org/docs/upgrade_guide#changed-xdebug

 

 

3-1. xdebug 설치 확인

php --version

 위의 명령어를 이용하여 php가 설치된 경로, xdebug가 정상적으로 설치되었는지 확인한다

 

4. phpStrom 연동 

  settings -> PHP 설정으로 이동

4-1 CLI 설정

php 설치 경로 확인 

brew list php

 

 

 

4-2 phpstrom debug 설정 

     -  로컬 서버를 구동한 상태에서 설정 

체크리스트가 X로 나올경우

1. 구동한 서버 주소가 맞는지 확인

2. php.ini를 로드하는 경로가 맞는지 확인 

3. php.ini에 xdebug 설정이 들어가있는지 확인

   또는 xdebug가 설치되어있는지 확인 (/usr/local/Cellar/php/7.4.0/pecl/20190902/xdebug.so)

4. 구동한 서버 주소가 맞는지 확인

5. xdebug 포트 확인

6. php.ini에 xdebug.remote_enable=1  가 있는지 확인

7. 좀더 찾아 봐야 함

 

 

*** phpStorm을 연동할 php.ini에  zend_extension="xdebug.so" 문장이 자동으로 추가 될 경우가 있음 

 

 

php.ini 파일에 

zend_extension="xdebug.so" 

문장이 중복되었는지 확인 후  

중복 제거 

 

4-3 debug할 서버 설정 

    - xdebug가 listen할 서버 

5 . php Debug 하기 

  - 서버가 구동되어 있을때 통화 아이콘이 온으로 되어있어야 debug가 가능해 진다