【第5回】画像生成AIをWebアプリに統合！AlmaLinux 9でのセキュアなストレージ管理と保存処理

テキストの次は「画像」！Webアプリの表現力を爆発させる

こんにちは！「LINUX工房」管理人の「リナックス先生」です。
前回の第4回では、自社データを活用するRAG（検索拡張生成）を実装し、AIの「テキスト処理能力」を極限まで引き出しました。
今回は、いよいよ「画像生成AI」のAPIをサーバーサイドから呼び出し、Webアプリケーションに統合していく手法を解説します。

本記事では、PHPを用いて画像生成APIを呼び出し、生成された画像をAlmaLinux 9サーバー内のディレクトリにダウンロードし、ブラウザ上で表示させるまでの一連の流れを、セキュリティとパフォーマンスの観点から徹底解説します。

---

1. 画像生成APIの仕組み：URL型とBase64型の違い

テキスト生成AI（LLM）は「文字の羅列」を返してきましたが、画像生成AIのAPI（OpenAIのDALL-E 3やStability AIなど）は、主に以下の2つの形式のいずれかで結果を返してきます。

① URL型（テンポラリURL）

AI提供元のサーバー上に画像が一時的に保存され、その画像にアクセスするための「URL」が返ってくる形式です。
メリット： レスポンスのデータ量が軽く、APIの通信が高速。
デメリット： URLには有効期限（例：1時間〜24時間）があるため、Webアプリとして永続的に利用するには、自社サーバー（AlmaLinux 9）側に画像をダウンロードして保存し直す必要があります。

② Base64型

画像データそのものを、文字列（Base64エンコード）に変換してテキストとして返してくる形式です。
メリット： ダウンロードの処理が不要で、すぐにファイルとして保存できる。
デメリット： レスポンスのテキストデータが巨大（数MB）になり、メモリを圧迫する可能性がある。

実運用では、ネットワーク帯域の負荷を分散させるため、「① URL型で受け取り、PHPで自社サーバーに非同期でダウンロードする」という設計が主流です。本記事でもこの方式を採用します。

---

2. AlmaLinux 9のディレクトリ設計と権限（パーミッション）

画像を保存するためには、Web公開領域（DocumentRoot）内に専用のディレクトリを作成する必要があります。
サーバーにSSH接続し、以下のコマンドを実行しましょう。

# 画像保存用ディレクトリの作成
sudo mkdir -p /var/www/html/ai_images

# 所有者をApache実行ユーザー（apache）に変更する
sudo chown apache:apache /var/www/html/ai_images

# 権限（パーミッション）を755（所有者はフルコントロール、他は読み取り/実行のみ）に設定
sudo chmod 755 /var/www/html/ai_images

---

3. 【鬼門】SELinuxによる書き込み制限の解除

所有者と権限を正しく設定しても、AlmaLinux 9環境でPHPスクリプトからファイルを作成しようとすると、ほぼ確実に「Permission denied（書き込み拒否）」のエラーが発生します。

これは、AlmaLinuxの強固なセキュリティ機能であるSELinuxが、Webサーバー（httpd）プロセスによるファイル書き込みをデフォルトでブロックしているためです。
これを回避するために、SELinuxを無効化するのではなく、特定のディレクトリにのみ書き込みを許可する「コンテキストの変更」を行います。

# semanageコマンドを使用するために必要なツールをインストール
sudo dnf install -y policycoreutils-python-utils

# ai_imagesディレクトリに対し、httpdが読み書きできるコンテキストを定義
sudo semanage fcontext -a -t httpd_sys_rw_content_t "/var/www/html/ai_images(/.*)?"

# 定義したコンテキストをディレクトリに適用する（リストア）
sudo restorecon -Rv /var/www/html/ai_images/

このコマンドを実行することで、SELinuxの防御力を維持したまま、PHP（Apache）が ai_images ディレクトリ内に画像を保存できるようになります。これはインフラエンジニアの必須スキルです。

---

4. PHPで実装：API呼び出しからサーバーへの保存まで

環境が整いました。ユーザーからのプロンプトを受け取り、画像生成APIを呼び出し、生成された画像URLからデータをダウンロードして自社サーバーに保存する一連のPHPスクリプトを実装します。

<?php
// /var/www/html/generate_image.php
header('Content-Type: application/json; charset=UTF-8');

$api_key = "あなたの_API_KEY"; // 厳重に管理すること
$api_url = "https://api.example.com/v1/images/generations"; // 各AI提供元のエンドポイント

// POSTデータの受け取り
$inputJSON = file_get_contents('php://input');
$input = json_decode($inputJSON, TRUE);
$prompt = $input['prompt'] ?? 'cyberpunk style hacker terminal, neon green';

// 1. APIへのリクエストデータ構築
$post_data = json_encode([
    "model" => "image-generation-model",
    "prompt" => $prompt,
    "n" => 1,
    "size" => "1024x1024",
    "response_format" => "url" // URLで結果を受け取る
]);

// 2. cURLでAPIを呼び出す
$ch = curl_init($api_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Bearer ' . $api_key
]);

$response = curl_exec($ch);
$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($http_code === 200) {
    $result = json_decode($response, true);
    // AI提供元のテンポラリURLを取得
    $remote_image_url = $result['data'][0]['url'];
    
    // 3. テンポラリURLから画像データを自社サーバー（PHP）でダウンロード
    $image_data = file_get_contents($remote_image_url);
    
    if ($image_data !== false) {
        // 4. ユニークなファイル名を生成して保存
        $save_dir = __DIR__ . '/ai_images/';
        // uniqid()を使って、ファイル名の重複を防ぐ
        $filename = uniqid('ai_gen_') . '.png';
        $save_path = $save_dir . $filename;
        
        // サーバーのストレージに書き込み
        if (file_put_contents($save_path, $image_data)) {
            // クライアント（ブラウザ）には、自社サーバーのURLを返す
            $local_url = "/ai_images/" . $filename;
            echo json_encode([
                "status" => "success",
                "message" => "画像を生成し、保存しました。",
                "image_url" => $local_url
            ]);
        } else {
            echo json_encode(["status" => "error", "message" => "画像の保存に失敗しました。権限とSELinuxを確認してください。"]);
        }
    } else {
        echo json_encode(["status" => "error", "message" => "リモートURLからの画像取得に失敗しました。"]);
    }
} else {
    echo json_encode(["status" => "error", "message" => "API通信エラー: HTTPステータス $http_code"]);
}
?>

フロントエンド（ブラウザ）からは、このPHPファイルを叩くだけで、外部タブへ飛ばされることなく、自社サーバー内に安全に保存された画像（/ai_images/ai_gen_xxxxx.png）を同一画面内でインライン表示することができます。

---

5. ストレージ圧迫を防ぐ設計とセキュリティ対策

画像生成機能は非常に強力ですが、サーバーのディスク容量（ストレージ）を猛烈な勢いで消費します。AlmaLinux 9上で安定稼働させるためのプロの設計手法をいくつか紹介します。

画像サイズの最適化

AIが生成する1024×1024ピクセルのPNG画像は、1枚あたり数MBになることがあります。Webアプリケーション上でプレビュー表示するだけなら、PHPのGDライブラリやImageMagickを使用して、保存時に自動でリサイズ（トリミング）や、より軽量なWebP形式へ変換する処理を挟むのが定石です。

ディレクトリトラバーサルの防止

今回は uniqid() を使ってサーバー側でファイル名を生成したため安全ですが、もし「ユーザーが入力した文字列」をファイル名に利用する場合は、ディレクトリトラバーサル攻撃（../../etc/passwd などを指定して重要ファイルを上書きする攻撃）の標的になります。ファイル名は必ずサーバー側で安全に生成・制御してください。

定期的なクリーンアップ

一時的に生成されたサムネイル画像などが無限に溜まり続けると、サーバーが停止します。古い不要な画像を自動で削除する仕組みが必要ですが、これについては第7回の「バッチ処理とCron」で詳しく解説します。

---

総まとめ：画像を制する者がWebアプリを制す

第5回の解説、お疲れ様でした。

テキストと違い、画像を扱う場合はサーバーのファイルシステム、権限、そしてSELinuxといったOSレベルの知識が直に求められます。しかし、これを突破できれば、リッチなUIを持つAIアプリケーションや、画像のPDF化ツールなど、開発できるサービスの幅が劇的に広がります。

次回、【第6回】セキュアなAPI運用：レート制限とエラーハンドリング では、アプリが人気になった際にAPIの課金が暴走しないための「レート制限（Rate Limiting）」や、システムダウンを防ぐ高度なエラーハンドリングについて解説します。商用サービスを立ち上げるなら必見の内容です！
お楽しみに！LINUX工房の「リナックス先生」でした。