Image

인증된 제출자

intervention/image

제출자 이우진

최신 v4.2.1라이센스 MIT배포 2026년 8월 9일

PHP 이미지 처리

GitHub

Intervention Image

PHP 이미지 처리 라이브러리

Intervention Image는 PHP에서 이미지를 생성·편집·합성하는 작업을 간결하고 표현력 있는 코드로 처리할 수 있는 PHP 이미지 처리 라이브러리입니다. GD, Imagick, libvips 중 원하는 드라이버를 선택해 사용할 수 있으며, 어떤 드라이버를 선택하더라도 동일한 API 인터페이스로 동작합니다.

주요 특징

이미지 편집 작업을 위한 플루언트(Fluent) 인터페이스 제공
GD, Imagick, libvips 를 지원하는 교체 가능한 드라이버 아키텍처
모든 드라이버에서 애니메이션 이미지 지원
특정 프레임워크에 종속되지 않는 범용 라이브러리

설치

Composer를 사용해 패키지를 설치합니다.

composer require intervention/image

시작하기

기본 사용법은 공식 문서의 인스턴스 생성 가이드에서 확인할 수 있으며, 전체 문서는 공식 문서 사이트를 참고하세요.

코드 예제

다음은 이미지를 불러와 크기를 조정하고, 워터마크를 삽입한 뒤 다른 포맷으로 저장하는 기본적인 사용 예입니다.

use Intervention\Image\ImageManager;
use Intervention\Image\Drivers\Gd\Driver as GdDriver;
use Intervention\Image\Alignment;
use Intervention\Image\Color;
use Intervention\Image\Format;

// GD 드라이버를 사용해 ImageManager 인스턴스 생성
$manager = ImageManager::usingDriver(GdDriver::class);

// 경로에서 이미지 데이터 읽기
$image = $manager->decodePath('images/example.webp');

// 높이 기준으로 이미지 크기 조정
$image->scale(height: 300);

// 워터마크 삽입 (오른쪽 하단 정렬)
$image->insert('images/watermark.png', alignment: Alignment::BOTTOM_RIGHT);

// JPEG 포맷으로 인코딩 (품질: 65)
$encoded = $image->encodeUsingFormat(Format::JPEG, quality: 65);

// 인코딩된 이미지 저장
$encoded->save('images/example.jpg');

요구 사항

설치 전에 서버 환경이 다음 요건을 충족하는지 확인하세요.

PHP >= 8.3
Mbstring PHP 확장 모듈
이미지 처리 PHP 확장 모듈 (GD, Imagick, libvips 중 하나)

지원 이미지 라이브러리

환경에 따라 아래 세 가지 이미지 처리 확장 모듈 중 하나를 선택해 사용할 수 있습니다.

GD Library
Imagick PHP 확장 모듈
libvips

NOTE

공유 호스팅 환경에서는 GD가 기본으로 제공되는 경우가 많습니다. 고성능이나 대용량 이미지 처리가 필요한 경우에는 Imagick 또는 libvips 사용을 검토하세요.

보안

보안 관련 취약점을 발견한 경우, GitHub 이슈 대신 oliver@intervention.io 로 직접 이메일을 보내주세요.

만든 사람

이 라이브러리는 Oliver Vogel이 개발·유지 관리하고 있습니다.

프로젝트 개선에 기여해 주신 모든 기여자 분들께 감사드립니다.

라이선스

Intervention Image는 MIT 라이선스로 배포됩니다.