[Error] The following PHP extensions are not available in your PHP configuration! dom

PHP 프로젝트(Composer로 패키지 설치 등)를 진행할 때 이런 오류를 만나는 경우가 있습니다.

The following PHP extensions are not available in your PHP configuration!
  dom

원인

dom 확장은 PHP에서 XML/HTML 문서를 다루는 모듈로, php-xml 패키지에 포함되어 있습니다. PHP를 최소 구성으로 설치하면 이 모듈이 빠져 있어, dom을 요구하는 라이브러리가 동작하지 않습니다.

해결 — php-xml 설치

# Debian/Ubuntu
sudo apt install php-xml

# CentOS/RHEL
sudo yum install php-xml

# 설치 후 웹서버 재시작
sudo systemctl restart apache2   # 또는 php-fpm

참고

• 설치 후 php -m | grep dom으로 모듈이 로드됐는지 확인할 수 있습니다.
• 같은 php-xml 패키지에 SimpleXML, xml, xmlwriter 등도 함께 들어 있어, 이들 관련 오류도 함께 해결됩니다.
• 특정 PHP 버전을 쓴다면 버전을 명시하세요 — 예: sudo apt install php8.1-xml
• 유사 사례로 utf8_encode() 오류도 같은 php-xml 설치로 해결됩니다.