サイトを更新しています。 数日間、レイアウトや翻訳に不具合が出ることがあります。ドキュメントは引き続きご利用いただけます。表示が崩れている場合は、後ほど再読み込みしてください。

ホーム image 3.x インストール

インストール

3.x 2026年3月7日

#サーバー要件

インストールを始める前に、サーバー環境が以下の要件を満たしていることを確認してください。

  • PHP >= 8.1
  • Mbstring PHP 拡張
  • 画像処理用 PHP 拡張

必須ではありませんが、Exif PHP 拡張をインストールしておくことを強くおすすめします。これにより、画像の向きを正しく表示するなどの処理が可能になります。

#画像処理拡張

サーバー環境には少なくとも1つの PHP 画像処理拡張がインストールされている必要があります。Intervention Image は現在、最も一般的な3つをサポートしています。

GD はほとんどの PHP インストールに含まれています。しかし、特に大きな画像では Imagick の方が高速で効率的だと考えるため、Imagick の使用を推奨します。libvips のサポートは、ドライバーを アドオンパッケージ としてインストールすることで利用できます。

環境に応じて、適切なドライバーを後で設定する必要があります。

#インストール

次のコマンドを実行して、Composer で Intervention Image をインストールします。

composer require intervention/image

これにより Intervention Image の最新バージョンがインストールされ、composer.json が自動的に更新されます。作成された vendor/autoload.php を読み込むことで、インストールした Composer パッケージのクラスを PSR-4 に従ってオートロードできます。

require './vendor/autoload.php';
 
use Intervention\Image\ImageManager;
use Intervention\Image\Drivers\Imagick\Driver;

// 希望するドライバーで新しいマネージャーのインスタンスを作成
$manager = new ImageManager(new Driver());

インストール後は、イメージマネージャーを設定する画像インスタンスの読み取りまたは作成 に進めます。