Image

인증된 제출자

intervention/image

제출자 이우진

최신 v4.3.4라이센스 MIT배포 2026년 10월 4일

PHP 이미지 처리

GitHub

Intervention Image: PHP 이미지 처리

PHP 이미지 처리

Intervention Image는 이미지를 생성하고 편집하며 합성할 수 있는 PHP 이미지 처리 라이브러리입니다. 간결하고 표현력 있는 API를 제공하며, 널리 쓰이는 PHP 이미지 처리 확장에 공통 인터페이스로 접근할 수 있습니다. 모든 이미지 처리 작업의 기반으로 GD 라이브러리, Imagick 또는 libvips를 선택할 수 있습니다.

일반적인 이미지 편집 작업을 위한 플루언트 인터페이스
GD, Imagick, libvips를 지원하며 드라이버를 교체할 수 있는 구조
모든 드라이버에서 애니메이션 이미지 지원
특정 프레임워크에 종속되지 않음

설치

설치 전에 아래의 서버 환경 요구 사항을 확인하세요. 이 라이브러리는 Composer로 설치할 수 있습니다.

composer require intervention/image

시작하기

Intervention Image의 사용 방법은 기본 사용법에서 시작하세요. 더 자세한 내용은 공식 문서에서 확인할 수 있습니다.

코드 예제

다음 예제는 GD 드라이버로 이미지 매니저를 만들고, 이미지를 읽어 크기를 조정한 뒤 워터마크를 추가합니다. 편집 결과를 JPEG로 인코딩하고 파일로 저장하는 과정까지 보여줍니다.

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

// 원하는 드라이버로 이미지 매니저 인스턴스 생성
$manager = ImageManager::usingDriver(GdDriver::class);

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

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

// 워터마크 삽입
$image->insert('images/watermark.png', alignment: Alignment::BOTTOM_RIGHT);

// 편집한 이미지 인코딩
$encoded = $image->encodeUsingFormat(Format::JPEG, quality: 65);

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

요구 사항

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

PHP >= 8.3
Mbstring PHP 확장
이미지 처리 PHP 확장: GD, Imagick 또는 libvips

지원하는 이미지 라이브러리

실행 환경에 맞춰 사용할 이미지 처리 확장을 선택할 수 있습니다.

GD 라이브러리
Imagick PHP 확장
libvips

보안

보안 관련 문제를 발견하면 oliver@intervention.io로 직접 이메일을 보내주세요.

개발자

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

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

라이선스

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