この記事では、CodeIgniter 4のHooksについて以下の観点から詳しく解説します。

• フックの基本概念と役割
• 使用できるイベントの一覧とタイミング
• 実用的なサンプルコード
• サービスプロバイダを活用した高度なフック管理
• 実運用における注意点とベストプラクティス

初心者の方はもちろん、すでにCodeIgniter 4を業務で利用している中級者以上の方にも、実践的な活用のヒントとなる内容を網羅的に解説します。

フックとは何か？CodeIgniterにおける位置づけ

フックとは、CodeIgniterのライフサイクルの特定ポイントに処理を追加できる仕組みです。たとえば、「すべてのリクエストが来る前にIP制限をかけたい」「コントローラが実行される直前にログ出力したい」といったニーズに対して、コアコードを汚さずスマートに対応できます。

CodeIgniter 3では、application/config/hooks.phpに配列形式で記述するややレガシーな形式でしたが、CodeIgniter 4ではよりモダンに、イベントベースでの登録が可能になりました。これにより、PHPのオブジェクト指向的な設計とも親和性が高まり、テスト可能なコード設計も容易になります。

利用可能なイベント一覧と活用例

CodeIgniter 4では、以下のようなイベントが用意されており、アプリケーションの特定のタイミングで処理を挟むことが可能です。

これらのイベントに対してフックを登録することで、アプリケーション全体の挙動を柔軟にカスタマイズできます。

実践：IPアドレスによるアクセス制限のフックを実装

以下に、特定のIP以外からのアクセスを拒否するシンプルなフックの例を紹介します。

app/Hooks/CheckIPHook.php

namespace App\Hooks;

class CheckIPHook
{
    public static function check()
    {
        $allowedIPs = ['127.0.0.1', '192.168.0.1'];
        $clientIP = $_SERVER['REMOTE_ADDR'] ?? '0.0.0.0';

        if (!in_array($clientIP, $allowedIPs)) {
            http_response_code(403);
            exit('Access denied for IP: ' . $clientIP);
        }
    }
}

このフックをイベントに登録します：

app/Config/Events.php

use App\Hooks\CheckIPHook;
use CodeIgniter\Events\Events;

Events::on('pre_system', [CheckIPHook::class, 'check']);

このように登録することで、アプリケーション全体でIP制限が適用されます。

実践：すべてのレスポンスにカスタムヘッダーを追加

X-App-Versionという独自ヘッダーをレスポンスに追加する例です。

app/Hooks/AddHeaderHook.php

namespace App\Hooks;

class AddHeaderHook
{
    public static function apply()
    {
        header('X-App-Version: 1.0.0');
    }
}

app/Config/Events.php

use App\Hooks\AddHeaderHook;

Events::on('post_system', [AddHeaderHook::class, 'apply']);

応用：サービスプロバイダでのフック登録

イベント登録をEvents.phpにベタ書きするのではなく、サービスプロバイダを使うことで管理しやすくなります。

app/Providers/HookEventProvider.php

namespace App\Providers;

use CodeIgniter\Events\EventsInterface;
use CodeIgniter\Service\ServiceProvider;
use App\Hooks\CheckIPHook;
use App\Hooks\AddHeaderHook;

class HookEventProvider extends ServiceProvider
{
    public function register(): void {}

    public function boot(EventsInterface $events): void
    {
        $events->on('pre_system', [CheckIPHook::class, 'check']);
        $events->on('post_system', [AddHeaderHook::class, 'apply']);
    }
}

このファイルを作成後、Autoload.phpの$psr4に追加すれば自動で読み込まれます。

注意点とベストプラクティス

注意点

• pre_systemではLoggerやConfigが使えません。
• header系の出力処理はpost_system以前に行う必要があります。
• 無限ループを招くような処理やエラーハンドリングには慎重な設計が必要です。

ベストプラクティス

• 責任の明確な単機能クラス設計（1フック = 1責務）
• 名前空間で機能ごとに整理する
• 環境（開発／本番）に応じた動作切り替えを意識する
• テスト用・開発用フックは明示的にON/OFF制御できるようにする

まとめ

CodeIgniter 4のHooks機能は、フレームワークの処理に柔軟に介入する強力な仕組みです。Filterのようなルーティングベースの仕組みよりも、より低レベルでの制御が可能なため、セキュリティ・ロギング・バージョン管理・外部連携などさまざまなニーズに対応できます。

うまく使えば、処理の重複を避けてDRYなコードを実現できますが、設計や依存の整理を怠るとトラブルの原因にもなります。責任範囲を明確にしたフック設計を心がけ、CodeIgniterの柔軟なイベントシステムを最大限活用していきましょう。