Docker 세팅에서 Xdebug 사용하기

Xdebug 버전 확인

https://www.php.net/supported-versions.php

Docker에서 Xdebug 다운받기

# Dockerfile.php82 -> 현재 사용중인 docker 기준으로 작성

# php8.2 Xdebug 설치
RUN pecl install xdebug-3.2.1 && docker-php-ext-enable xdebug

PhpStorm에서 설정하기

Settings -> PHP

1. … 버튼을 클릭하여 CLI Interpreters를 생성
2. "+" 버튼을 눌러서 From Docker, Vargrent … 클릭
   
3. Image name에 docker 이미지를 선택하고 확인 버튼
   
4. 사용하는 버전이 맞는지 체크하고 Apply
   
5. CLI Interpreter에 위에서 생성한 duse-admin을 선택
6. 바로 아래에 Path mappings 오른쪽 폴더 버튼을 클릭 후 Local Path에 local project path를 적고 Remote Path에 docker path를 적어줌
7. 또 바로 아래 Docker container도 오른쪽 폴더 버튼을 클릭 후 Host Path에 local project path를 적고 Container path에 docker path를 적어줌
8. Apply

---

Settings -> PHP -> Servers

1. + 버튼으로 클릭
2. Name에 사용할 이름을 입력
3. Host에 현재 docker에 설정된 Host를 입력
4. Port에 현재 docker에 설정된 Port를 입력
5. Use path mappings … 체크박스 선택
6. File/Directory에 현재 local에서 사용중인 Project Path를 입력
7. Absolute path on the server에 docker 컨테이너 내부에 설치되어 있는 Project Path를 입력

---

Settings -> PHP -> Debug

1. Xdebug 라인에 Can accept external connections 체크박스 선택
2. Debug port가 9003이 되어있는지 확인

---

1. command + shift + A 로 액션 검색 (config) 검색후 'Edit ConfigUrations...' 선택
   
2. 앞서 만든 Interpreter로 설정한 후 Apply
   
3. 이제 PhpStorm 우측 상단에 phpunit.xml로 선택 후 Run 버튼으로 테스트 시작
   
4. 완료