2026年6月3日

WordPressで「wp_redirect」が正常に動作しない場合の対処

エラー・白い画面

はじめに

「wp_redirect」は、WordPressの内部関数の一つで、ユーザーを別のページやURLへリダイレクトさせるための重要な機能です。しかし、この関数が予想通りに動作しないと、サイト上のさまざまな問題が発生します。たとえば、正しいリンク設定ができていない場合や、特定の条件下でのみ問題が現れる場合があります。

本記事では、「wp_redirect」が正常に動作しない原因とその解決策について詳しく解説します。この記事を読むことで、WordPressサイトの運用において、安定したユーザー体験を提供することが可能になります。

症状・背景

このテーマが必要になる主な場面:

リダイレクトが意図した通りに行われない
wp_redirect関数を使用しているが、ブラウザに「リダイレクトループ」のエラーメッセージが表示される
WordPressプラグインやカスタムテーマでwp_redirectを実装しようとしているが、期待通りに動作しない
ページ更新後、URLが変更されない

手順・設定方法

ステップ1: wp_redirectの基本的な使用法を確認する

# WordPressのheader.phpやfunctions.phpなどの適切なファイル内で、以下のようにwp_redirectを使用します。
if (isset($_GET['redirect'])) {
    wp_redirect(home_url('/about/'));
    exit;
}

# 重要なのは、wp_redirectの呼び出し後にはexit関数を必ず使用することです。これは、リダイレクトが意図した通りに機能するようにします。

ステップ2: リダイレクト後にページ更新を行う

# 更新処理が必要な場合、まずwp_redirectの呼び出し前にその処理を実行します。
if (isset($_POST['submit'])) {
    // 更新処理をここに記述
}

// 正常に処理が完了したらリダイレクトを行う
if (!empty($post_id)) {
    wp_redirect(get_permalink($post_id));
} else {
    wp_redirect(home_url('/error/'));
}
exit;

ステップ3: リダイレクトループを避ける

# 「wp_redirect」を使用する前に、「is_ssl()」や「$_SERVER['HTTP_X_FORWARDED_PROTO']」などのチェックを加えると、リダイレクトループを防ぐことができます。
if ($_SERVER['HTTPS']) {
    wp_redirect('https://' . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI']);
} else {
    wp_redirect('http://' . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI']);
}
exit;

ステップ4: 定期的なコードレビューとパフォーマンス監視

# WordPressサイトの定期メンテナンスの一環として、wp_redirect関数を含む全てのPHPファイルをレビューします。この際には、リダイレクトループや無限ループが発生しないように注意してください。

注意事項

実装する前に必ずwp_redirectのドキュメントを確認し、正しい使用方法を理解してから実行すること
リダイレクト先のURLは常に絶対パスを使用すること（相対パスでは意図した通りに動作しない可能性がある）
wp_redirectとheader関数を混在させると意図した通りのリダイレクトが行われないため、両者の使用は避けること
リダイレクト処理を行う前に必ずexitやdieなどの終了処理を行うこと

まとめ

1. 基本的な使用法: wp_redirect関数を使用する際には必ずheader()関数の呼び出し後にページを終了させるべきです。

2. リダイレクトループの回避: リダイレクトループが発生しないよう、HTTPSやHTTPなどのプロトコルを適切にチェックします。

3. 更新処理との整合性: 更新処理が必要な場合は、まずその処理を行った後にリダイレクトを行うようにします。

4. コードレビューと監視: 定期的にコードをレビューし、パフォーマンスやセキュリティに問題がないか確認すること

5. ドキュメントの参照: wp_redirect関数について詳しく知りたい場合は、WordPress公式ドキュメントを参照すること

Post Views: 2