Docker ERROR RUN pecl install xdebug php버전 지원 대상 오류

=> ERROR [project-name] RUN pecl install xdebug                                                                                           
 > [project-name] RUN pecl install xdebug:
#0 3.858 pecl/xdebug requires PHP (version >= 8.0.0, version <= 8.2.99), installed version is 7.4.33
#0 3.858 No valid packages found
#0 3.858 install failed

✏️ 개요

환경 구축 과정에서 docker-compose up을 실행했을 때, 버전의 차이로 빌드가 실패했을 경우입니다.
Xdebug는 php8 이상이 아니면 안된다는 의미의 오류입니다.

---

🔎 원인

Xdebug 최신 버전은 php7을 지원 대상에서 제외했기 때문에 php7 환경을 구축할 때는 Xdebug는 3.1.6 이전을 지정해야 합니다.

---

📖 해결방법 (Docker+pecl의 경우)

RUN pecl install xdebug-3.1.6

pecl install는 버전 지정이 가능합니다. xdebug 뒤에 하이픈 + 버전을 명시해주면 오류를 해결할 수 있습니다.