Skip to main content

GD 함수 미지원 오류 해결 (CentOS/Ubuntu)

요약 정리

  • GD 라이브러리는 이미지 처리에 필요한 라이브러리입니다.
  • 이미지가 보이지 않거나 “GD 함수 미지원” 오류가 나면 OS에 맞는 패키지를 설치하세요.
  • CentOS: libpng-devel → freetype-devel → libjpeg-devel → gd → gd-devel → php-gd 순서로 설치합니다.
  • Ubuntu: php-gd 패키지를 설치합니다.
  • 설치 후 rpm -qi 또는 dpkg -s 명령으로 설치 여부를 확인합니다.

1. 증상과 원인

  • 사이트에서 이미지가 정상적으로 출력되지 않거나, PHP에서 GD 관련 함수가 동작하지 않을 수 있습니다.
  • APM을 RPM으로 설치한 환경에서 GD 함수가 지원되지 않는 경우가 있습니다.
  • 이때 OS별로 GD 및 이미지 관련 패키지를 설치하면 문제를 해결할 수 있습니다.

2. CentOS: 이미지/GD 관련 패키지 설치

아래 순서대로 설치하세요. 반드시 번호 순서대로 진행하면 의존성 문제를 줄일 수 있습니다.

  1. libpng-devel 설치
yum install libpng-devel
  1. freetype-devel 설치
yum install freetype-devel
  1. libjpeg-devel 설치
yum install libjpeg-devel
  1. gd 설치
yum install gd
  1. gd-devel 설치
yum install gd-devel
  1. php-gd 설치
yum install php-gd

설치 확인 방법 (CentOS)

  • 패키지 설치 여부 확인:
rpm -qi 패키지명
  • 예시:
rpm -qi gd-devel

3. Ubuntu: GD 패키지 설치

  1. php-gd 설치
sudo apt-get install php-gd

설치 확인 방법 (Ubuntu)

  • 패키지 설치 여부 확인:
sudo dpkg -s 패키지명
  • 예시:
sudo dpkg -s php-gd