옵션 모듈 imagick을 설치하지 않았거나 비활성화했습니다 설치방법

워드프레스 사이트 상태를 보다 보면 옵션 모듈 imagick을 설치하지 않았거나 비활성화했습니다라는 문구가 떠서 괜히 신경 쓰일 때가 있습니다. 처음 보면 큰 장애처럼 느껴지지만, 실제 의미는 조금 다릅니다. 이 문구는 사이트가 당장 멈췄다는 뜻이 아니라 이미지 처리를 더 안정적으로 맡아줄 PHP 확장 모듈이 현재 연결되지 않았다는 쪽에 가깝습니다.

저 역시 처음에는 그냥 지나가도 되는 경고인지, 아니면 바로 잡아야 하는 문제인지 헷갈렸습니다. 결론부터 말하면 글 위주 사이트는 당장 급하지 않을 수 있지만, 이미지가 많거나 썸네일 생성이 잦은 워드프레스라면 한 번은 제대로 확인해두는 편이 낫습니다. 특히 리뷰형 블로그, 쇼핑몰, 부동산 매물 사이트처럼 사진 비중이 높은 경우라면 체감 차이가 꽤 납니다.

imagick 오류 뜻

이 오류는 워드프레스가 PHP에서 imagick 확장을 찾지 못할 때 표시됩니다.

워드프레스 건강 상태에 하나이상의 모듈을 누락했습니다. imagick 설치되지 않거나 비활성화 상태

쉽게 말하면 워드프레스가 서버에 이미지 처리 기능을 요청했는데, 현재 그 기능을 불러올 수 없는 상태라는 뜻입니다.

여기서 많이 헷갈리는 부분이 있습니다. ImageMagick과 imagick은 이름이 비슷하지만 완전히 같은 것은 아닙니다. ImageMagick은 서버 쪽 이미지 처리 도구이고, imagick은 PHP가 그 기능을 사용할 수 있게 연결해주는 확장 모듈입니다. 그래서 서버에 ImageMagick 관련 패키지가 있어도 PHP imagick 확장이 없으면 워드프레스에서는 여전히 경고가 뜰 수 있습니다.

imagick이 하는 일

imagick은 워드프레스에서 이미지 관련 작업을 맡는 경우가 많습니다.

대표적으로는 이미지 크기 조절, 썸네일 생성, 회전, 자르기, 압축 처리, 일부 포맷 변환에 관여합니다. 사이트를 운영하다 보면 별것 아닌 것처럼 보여도, 실제로는 대표이미지 표시나 본문 썸네일 품질에 은근히 영향을 줍니다.

또한 일부 서버 환경에서는 PDF 미리보기 생성, 고해상도 이미지 처리, WebP 관련 작업에서도 imagick이 더 유리하게 동작합니다. 사진을 자주 올리는 블로그라면 이런 차이가 누적되면서 업로드 이후 처리 속도나 결과물의 안정성에서 차이가 보일 수 있습니다.

항목	역할	체감되는 부분
썸네일 생성	업로드 이미지 여러 크기 자동 생성	대표이미지와 목록 이미지 출력 안정성
리사이즈	큰 이미지를 줄여 저장	과하게 큰 파일 업로드 시 부담 완화
자르기와 회전	이미지 편집 처리	일부 플러그인과 편집 기능 호환
특수 포맷 처리	PDF, WebP 등 일부 작업 보조	미리보기 생성이나 변환 시 편리

꼭 설치해야 하는지

이 부분이 가장 궁금한 경우가 많습니다. 결론은 무조건 필수는 아닙니다. 워드프레스는 imagick이 없어도 돌아갑니다.

다만 이미지 비중이 높은 사이트라면 없는 상태로 계속 운영하는 것이 아쉬울 수 있습니다.

예를 들어 텍스트 위주의 정보성 블로그나 단순 회사 소개 사이트라면 imagick이 없어도 큰 불편 없이 운영되는 경우가 많습니다.

반대로 상품 이미지가 많은 쇼핑몰, 대표사진이 많은 리뷰 블로그, 매물 사진이 자주 바뀌는 부동산 사이트는 imagick이 있는 편이 훨씬 낫습니다. 제 기준에서는 이미지 업로드 빈도가 높다면 설치하는 쪽이 더 편했습니다.

사이트 유형	권장 정도	이유
텍스트 중심 블로그	보통	이미지 처리량이 많지 않음
리뷰 블로그	높음	대표사진과 썸네일 생성이 자주 발생
쇼핑몰	높음	상품 이미지 관리 비중이 큼
부동산 사이트	높음	매물 사진 수가 많고 갱신도 잦음

이 오류가 뜨는 이유

실제 서버에서는 단순 미설치보다 조금 더 복잡하게 갈리는 경우가 많습니다.

PHP imagick 확장이 아예 설치되지 않았을 수도 있고, 설치는 됐지만 php.ini 또는 php.d 설정 파일이 깨졌을 수도 있습니다. PHP 8.2에는 들어갔는데 PHP 8.3에는 빠져 있는 식으로 버전별 차이도 자주 생깁니다.

특히 cPanel, WHM, Bluehost, AlmaLinux 계열에서는 저장소 패키지가 바로 잡히지 않거나, PECL로 설치했는데 ini 파일이 잘못 들어가면서 경고가 남는 경우도 있습니다.

그래서 단순히 설치 명령 하나 넣고 끝내기보다는 실제로 현재 사이트 PHP 버전에서 imagick이 로드되는지 확인하는 과정이 더 중요합니다.

설치 전 확인 명령어

설치부터 바로 하지 말고, 먼저 현재 서버에서 imagick이 정말 없는지 확인하는 편이 좋습니다.

특히 여러 PHP 버전을 같이 쓰는 서버라면 더 그렇습니다.

아래 명령어로 현재 로드 상태를 먼저 볼 수 있습니다.

php -m | grep -i imagick
/opt/cpanel/ea-php83/root/usr/bin/php -m | grep -i imagick
/opt/cpanel/ea-php82/root/usr/bin/php -m | grep -i imagick

아무 결과가 나오지 않으면 아직 로드되지 않은 상태입니다.

워드프레스 사이트 상태에 경고가 뜨는 경우라면 대부분 여기서 비어 있는 경우가 많습니다.

패키지 저장소 확인 명령어

서버 저장소에서 바로 설치 가능한 imagick 패키지가 있는지도 확인해보는 것이 좋습니다.

이 부분은 서버 환경마다 차이가 있어서 어떤 서버는 한 줄로 끝나고, 어떤 서버는 패키지가 아예 보이지 않습니다.

dnf list available '*imagick*'
dnf search imagick
repoquery -a | grep -i imagick

여기서 설치 후보가 나오면 패키지 방식으로 진행하면 되고, No match나 No matches found가 뜨면 PECL 방식으로 가는 편이 현실적입니다.

기본 패키지 설치 명령어

먼저 서버 쪽 ImageMagick 관련 도구와 빌드에 필요한 패키지를 준비합니다. 아래 명령어는 보통 cPanel 계열 서버에서 많이 쓰는 쪽입니다.

dnf install -y ImageMagick ImageMagick-devel gcc make autoconf

이 단계는 PHP imagick 확장 그 자체가 아니라, 그 확장을 빌드하고 연결하는 데 필요한 기반을 준비하는 쪽에 가깝습니다.

PECL 설치 명령어

저장소 패키지가 안 잡히는 환경이라면 PECL 설치가 가장 많이 쓰입니다. cPanel EA4 기준으로는 PHP 버전별로 각각 설치하는 식이 안전합니다.

/opt/cpanel/ea-php83/root/usr/bin/pecl install imagick
/opt/cpanel/ea-php82/root/usr/bin/pecl install imagick

설치가 끝났는데 php.ini does not exist 같은 문구가 보이면 놀랄 필요는 없습니다.

그런 경우는 보통 모듈 파일은 잘 설치됐지만, 확장 로드용 ini 파일을 직접 만들어야 하는 상황이 많습니다.

ini 파일 등록 명령어

PECL 설치 후에는 PHP가 imagick 모듈을 읽을 수 있게 ini 파일을 만들어주는 과정이 필요할 수 있습니다. 아래처럼 PHP 8.3과 8.2에 각각 넣어주면 됩니다.

printf "extension=imagick.so\n" > /opt/cpanel/ea-php83/root/etc/php.d/20-imagick.ini
printf "extension=imagick.so\n" > /opt/cpanel/ea-php82/root/etc/php.d/20-imagick.ini

간단해 보이지만 이 단계에서 오타가 나면 ini 문법 오류 때문에 imagick이 안 올라올 수 있습니다. 괄호나 이상한 문자, 줄바꿈이 잘못 들어가지 않았는지 한 번 더 보는 편이 좋습니다.

웹서버 재시작 명령어

설정만 넣고 끝내면 안 되고, Apache와 PHP-FPM을 다시 읽혀줘야 실제 반영됩니다. 보통은 아래 순서로 많이 처리합니다.

systemctl restart httpd
/scripts/restartsrv_apache_php_fpm

재시작 후에는 실제로 PHP가 imagick을 로드하는지 다시 확인해야 합니다.

설치 완료 확인 명령어

설치가 끝난 뒤 가장 중요한 부분입니다.

아래 명령어에서 imagick이 출력되면 로드 성공입니다.

/opt/cpanel/ea-php83/root/usr/bin/php -m | grep -i imagick
/opt/cpanel/ea-php82/root/usr/bin/php -m | grep -i imagick

좀 더 확실하게 보고 싶다면 아래처럼 확인해도 됩니다.

/opt/cpanel/ea-php83/root/usr/bin/php -r 'var_dump(extension_loaded("imagick"));'
/opt/cpanel/ea-php82/root/usr/bin/php -r 'var_dump(extension_loaded("imagick"));'

여기서 bool(true)가 나오면 정상입니다.

ini 문법 오류가 날 때 확인 명령어

설치 후에도 갑자기 syntax error가 뜨는 경우가 있습니다. 이런 경우는 imagick 자체보다 ini 파일이 깨진 경우가 많습니다. 그럴 때는 아래처럼 파일 내용을 줄 번호와 함께 확인해보면 원인을 빨리 찾을 수 있습니다.

nl -ba /opt/cpanel/ea-php83/root/etc/php.d/20-imagick.ini | sed -n '1,80p'
nl -ba /opt/cpanel/ea-php82/root/etc/php.d/20-imagick.ini | sed -n '1,80p'

문제가 있으면 해당 ini 파일을 지우고 한 줄로 다시 만드는 쪽이 더 빠를 때가 많습니다.

rm -f /opt/cpanel/ea-php83/root/etc/php.d/20-imagick.ini
printf "extension=imagick.so\n" > /opt/cpanel/ea-php83/root/etc/php.d/20-imagick.ini

rm -f /opt/cpanel/ea-php82/root/etc/php.d/20-imagick.ini
printf "extension=imagick.so\n" > /opt/cpanel/ea-php82/root/etc/php.d/20-imagick.ini

모듈 파일 존재 여부 확인

ini는 맞게 넣었는데도 imagick이 안 잡히면 실제 모듈 파일이 있는지 확인해보면 됩니다.

ls -l /opt/cpanel/ea-php83/root/usr/lib64/php/modules/imagick.so
ls -l /opt/cpanel/ea-php82/root/usr/lib64/php/modules/imagick.so

여기서 파일이 없으면 해당 PHP 버전은 설치가 덜 된 상태라고 보면 됩니다. 반대로 파일이 있는데 로드가 안 되면 대부분 ini 또는 재시작 문제로 좁혀집니다.

설치가 필요한 경우와 아닌 경우

업로드한 대표이미지가 이상하게 잘리거나, 썸네일이 일부만 생성되거나, 이미지 최적화 플러그인에서 오류가 나는 경우라면 imagick을 그냥 넘기기보다 한 번 점검해보는 편이 낫습니다.

고해상도 사진을 자주 올리는 사이트, PDF 미리보기 기능을 쓰는 사이트, WebP 변환 기능을 자주 돌리는 사이트도 imagick 쪽이 더 잘 맞는 경우가 많습니다.

• [IT 리뷰/블로그 SEO] - 워드프레스 성능 개선 3가지 - 하나 이상의 필수모듈 누락 예정된 이벤트, 지속적인 객체캐시 사용
• [IT 리뷰/블로그 SEO] - 워드프레스 & WHM 보안 서치콘솔 오류부터 외부 유입 차단까지
• [IT 리뷰/블로그 SEO] - 워드프레스 SEO 최적화 속도측정 및 페이지 크기 압축

반대로 이미지 몇 장 없는 단순 사이트라면 경고가 떠도 당장 운영이 불가능해지는 것은 아닙니다. 다만 이런 상태를 오래 두면 나중에 썸네일 누락이나 특정 플러그인 충돌이 생겼을 때 원인 파악이 번거로워질 수 있습니다.

서버 부담은 어느 정도인지

imagick이 있으면 서버가 무조건 무거워진다고 생각하는 경우도 있는데, 실제로는 모듈 존재 자체보다 어떤 이미지를 얼마나 자주 처리하느냐가 훨씬 더 중요합니다. 즉 imagick이 설치되어 있다고 해서 사이트가 갑자기 느려지는 것은 아닙니다.

참고 : 워드프레스 서버 10년 간 쌓인 찌꺼기 데이터 정리 - 고어크론 예약 및 안쓰는 이미지 제거

다만 초고해상도 이미지, 대량 썸네일 재생성, 이미지 최적화 플러그인의 반복 작업이 겹치면 CPU와 메모리 사용량이 올라갈 수 있습니다.

저라면 이런 작업은 방문이 적은 시간에 돌리는 편이 더 낫다고 봅니다. 특히 서버 메모리가 넉넉하지 않다면 무거운 이미지 작업은 시간대를 나눠서 처리하는 쪽이 안전합니다.

워드프레스 기준 정리

정리하면 imagick은 워드프레스가 이미지 작업을 좀 더 안정적으로 처리하도록 도와주는 PHP 확장 모듈입니다. 글 위주 사이트라면 당장 급하지 않을 수 있지만, 이미지가 많고 썸네일 생성이 중요한 사이트라면 설치해두는 편이 훨씬 편합니다.

개인적으로는 이런 종류의 경고는 그냥 보기 싫어서 지우는 것보다, 내 사이트에서 실제로 어떤 기능에 영향을 주는지 먼저 보고 판단하는 쪽이 더 맞다고 생각합니다. 워드프레스는 겉으로 멀쩡해 보여도 이미지 처리에서 작은 차이가 쌓이면 나중에 관리가 번거로워질 수 있기 때문입니다.

한눈에 정리

imagick 경고는 워드프레스가 당장 멈췄다는 뜻이 아닙니다. 다만 이미지 처리, 썸네일 생성, 일부 플러그인 호환에 영향을 줄 수 있어서 사진이 많은 사이트라면 설치해두는 편이 더 안정적입니다. 설치는 보통 사전 확인 → PECL 설치 → ini 등록 → Apache 및 PHP-FPM 재시작 → 로드 확인 순서로 진행하면 됩니다.

자주 묻는 질문

Q. imagick이 없으면 워드프레스가 작동하지 않나요?

아닙니다. 워드프레스는 imagick이 없어도 동작합니다. 다만 이미지 처리 방식이 단순해지거나 일부 플러그인 기능이 기대와 다르게 보일 수 있습니다.

Q. ImageMagick만 설치되어 있으면 끝난 것 아닌가요?

그렇지 않습니다. ImageMagick과 PHP imagick 확장은 별개입니다. 서버 패키지만 있다고 해서 워드프레스가 자동으로 인식하는 것은 아닙니다.

Q. imagick 설치 후에도 경고가 계속 뜨는 이유는 뭔가요?

PHP 버전별 설치 누락, ini 파일 문법 오류, PHP-FPM 재시작 누락, 서버 캐시 문제 때문에 이런 일이 생깁니다. 설치 여부보다 실제 로드 여부를 확인하는 편이 정확합니다.

Q. 공유호스팅도 직접 설치할 수 있나요?

공유호스팅은 직접 설치 권한이 없는 경우가 많습니다. 이런 경우는 호스팅사에서 imagick 지원 여부를 먼저 확인하는 것이 가장 빠릅니다.