[PHP] WordPress REST APIでアイキャッチ画像を設定する

2024-10-092024-12-22

以下は、WordPress REST API + PHPを使って投稿にアイキャッチ画像（サムネイル）を設定する関数のスニペットです。この技術記事では、APIを通じて画像をアップロードし、投稿にアイキャッチ画像を設定する方法を説明します。

WordPress REST APIでアイキャッチ画像を設定する手順

APIトークンの取得
WordPress REST APIにアクセスするためには、認証が必要です。以下のように、アプリケーションパスワードを使用して認証トークンを生成します。

// ベーシック認証のためのユーザー名とアプリケーションパスワード
$username = 'your-username';
$application_password = 'your-application-password';

// ベーシック認証用ヘッダーの作成
$headers = [
    'Authorization' => 'Basic ' . base64_encode($username . ':' . $application_password),
    'Content-Type' => 'application/json',
];

画像をアップロードする
次に、アップロードしたい画像を/wp-json/wp/v2/mediaエンドポイントにPOSTリクエストで送信します。以下は、PHPのcurlを使用してファイルをアップロードする例です。

$upload_url = 'https://example.com/wp-json/wp/v2/media'; // WordPressサイトのURL
$image_path = '/path/to/your/image.jpg'; // ローカルの画像パス
$image_data = file_get_contents($image_path);

// ファイルアップロード用のcURLリクエスト
$ch = curl_init($upload_url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array_merge($headers, [
    'Content-Disposition: attachment; filename="' . basename($image_path) . '"'
]));
curl_setopt($ch, CURLOPT_POSTFIELDS, $image_data);
$response = curl_exec($ch);
curl_close($ch);

// レスポンスをデコードし、画像IDを取得
$media = json_decode($response, true);
$media_id = $media['id'];

投稿にアイキャッチ画像を設定する
画像が正常にアップロードされたら、次にその画像を指定した投稿のアイキャッチ画像として設定します。/wp-json/wp/v2/posts/{post_id}エンドポイントにPOSTリクエストを送信し、featured_mediaにアップロードされた画像のIDを指定します。

$post_id = 123; // アイキャッチ画像を設定する投稿のID
$update_post_url = 'https://example.com/wp-json/wp/v2/posts/' . $post_id;

$post_data = json_encode([
    'featured_media' => $media_id // アップロードされた画像のIDを指定
]);

// 投稿更新用のcURLリクエスト
$ch = curl_init($update_post_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);
$response = curl_exec($ch);
curl_close($ch);

// レスポンス確認
$updated_post = json_decode($response, true);