管理画面に「AIアシスタント」タブを1つ追加し、そこにチャット欄を置くだけです。

[あなた] UserモデルにSNS連携用のprovider, provider_idカラムを追加するマイグレーションを書いて
[Claude] 以下のマイグレーションを作成しました。中間テーブルではなくusersテーブルへの
         直接追加案です。ユニーク制約は (provider, provider_id) の複合キーにしています…
```php
         class m260714_000000_add_sns_columns_to_users extends Migration { ... }
```
         この設計だと1ユーザーが複数SNS連携する場合に対応できません。もし複数連携を
         想定しているなら中間テーブル案も出せますが、どちらにしますか？
[あなた] 複数連携できるようにして
[Claude] では user_social_accounts テーブルを新設する案に切り替えます…

単発の「コード生成」ではなく、要件を詰めながら会話でコードを育てていくのがポイントです。Claudeはmax_tokensの許す限り会話履歴を保持するので、前の提案を踏まえた修正依頼にも自然に対応できます。

全体構成

Yii2のDI/Componentの仕組みは、LaravelでいうServiceクラスをコンテナに登録するのとほぼ同じ感覚で扱えます。

1. APIキーの設定

config/params.php に追記します（.env を使っている場合はそちら経由で読み込んでください）。

<?php
return [
    'claudeApiKey' => getenv('ANTHROPIC_API_KEY'),
    'claudeModel'  => 'claude-sonnet-5', // コーディング用途はSonnetでバランス良好
];

web.php の components にも登録しておくとコントローラーから Yii::$app->claudeAgent で呼べて便利です。

'components' => [
    // ...既存のコンポーネント
    'claudeAgent' => [
        'class' => 'app\components\ClaudeAgent',
        'apiKey' => $params['claudeApiKey'],
        'model'  => $params['claudeModel'],
    ],
],

2. Claude APIを叩くコンポーネント

Yii2は標準で yii\httpclient\Client（yiisoft/yii2-httpclient）が使えるので、Guzzleを別途入れなくてもOKです。未導入なら composer require yiisoft/yii2-httpclient を実行してください。

<?php
// components/ClaudeAgent.php

namespace app\components;

use yii\base\Component;
use yii\httpclient\Client;
use yii\base\Exception;

class ClaudeAgent extends Component
{
    public string $apiKey;
    public string $model = 'claude-sonnet-5';
    public int $maxTokens = 2048;

    private const API_URL = 'https://api.anthropic.com/v1/messages';
    private const API_VERSION = '2023-06-01';

    /**
     * @param array $history [['role' => 'user'|'assistant', 'content' => string], ...]
     * @param string $systemPrompt Yii2固有の文脈を教えるシステムプロンプト
     * @return string アシスタントの返答テキスト
     */
    public function chat(array $history, string $systemPrompt): string
    {
        $client = new Client(['baseUrl' => '']);

        $response = $client->createRequest()
            ->setMethod('POST')
            ->setUrl(self::API_URL)
            ->setHeaders([
                'x-api-key' => $this->apiKey,
                'anthropic-version' => self::API_VERSION,
                'content-type' => 'application/json',
            ])
            ->setContent(json_encode([
                'model' => $this->model,
                'max_tokens' => $this->maxTokens,
                'system' => $systemPrompt,
                'messages' => $history,
            ]))
            ->send();

        if (!$response->isOk) {
            throw new Exception('Claude API error: ' . $response->content);
        }

        $data = $response->data;
        // content配列からtext種別を連結（tool_use等が混じる場合を考慮）
        $text = '';
        foreach ($data['content'] as $block) {
            if ($block['type'] === 'text') {
                $text .= $block['text'];
            }
        }
        return $text;
    }
}

ポイント

• system パラメータにYii2固有のルール（後述）を書くことで、的外れなLaravel流の回答を防ぎます。
• content を配列でループしているのは、将来ツール実行（tool_use）を組み込む拡張余地を残すためです。

3. 会話履歴を持つコントローラー

会話はDBに残すのが理想ですが、まずは最小構成としてセッション保存にします。

<?php
// controllers/AiAssistantController.php

namespace app\controllers;

use Yii;
use yii\web\Controller;
use yii\web\Response;
use yii\filters\VerbFilter;

class AiAssistantController extends Controller
{
    public function behaviors()
    {
        return [
            'verbs' => [
                'class' => VerbFilter::class,
                'actions' => [
                    'send' => ['post'],
                    'reset' => ['post'],
                ],
            ],
        ];
    }

    public function actionIndex()
    {
        $history = Yii::$app->session->get('ai_chat_history', []);
        return $this->render('index', ['history' => $history]);
    }

    public function actionSend()
    {
        Yii::$app->response->format = Response::FORMAT_JSON;

        $message = Yii::$app->request->post('message', '');
        if (trim($message) === '') {
            return ['error' => 'メッセージが空です'];
        }

        $history = Yii::$app->session->get('ai_chat_history', []);
        $history[] = ['role' => 'user', 'content' => $message];

        $systemPrompt = <<<PROMPT
        あなたはYii2フレームワークの上級エンジニアです。
        - 回答はYii2の作法（ActiveRecord, Widget, Behavior, RBAC等）に従うこと
        - Laravel的な書き方（Eloquentのスコープ記法など）を混ぜないこと
        - コードは動くものを示し、設計判断が分かれる場合は選択肢を提示して確認を取ること
        - 日本語で簡潔に回答すること
        PROMPT;

        try {
            $reply = Yii::$app->claudeAgent->chat($history, $systemPrompt);
        } catch (\Throwable $e) {
            Yii::error($e->getMessage(), 'claude-agent');
            return ['error' => 'AIエージェントとの通信に失敗しました'];
        }

        $history[] = ['role' => 'assistant', 'content' => $reply];
        Yii::$app->session->set('ai_chat_history', $history);

        return ['reply' => $reply];
    }

    public function actionReset()
    {
        Yii::$app->session->remove('ai_chat_history');
        Yii::$app->response->format = Response::FORMAT_JSON;
        return ['status' => 'ok'];
    }
}

system プロンプトで「Yii2の作法に従う」「設計判断が割れる場合は確認を取る」と明示しているのが、単なるコード生成器と対話型エージェントを分ける最大のポイントです。

4. チャットUI（View）

Bootstrap 5（Yii2 basic templateに標準搭載）+ 素のFetch APIだけで組めます。Reactなどは不要です。

<?php
// views/ai-assistant/index.php
/** @var array $history */
use yii\helpers\Html;
use yii\helpers\Url;

$this->title = 'AIコーディングアシスタント';
?>
<div class="ai-assistant-index">
    <h1><?= Html::encode($this->title) ?></h1>

    <div id="chat-log" class="border rounded p-3 mb-3" style="height: 480px; overflow-y: auto; background:#fafafa;">
        <?php foreach ($history as $msg): ?>
            <div class="mb-3 <?= $msg['role'] === 'user' ? 'text-end' : '' ?>">
                <span class="badge <?= $msg['role'] === 'user' ? 'bg-primary' : 'bg-secondary' ?> mb-1">
                    <?= $msg['role'] === 'user' ? 'あなた' : 'Claude' ?>
                </span>
                <pre class="bg-white border rounded p-2" style="white-space: pre-wrap;"><?= Html::encode($msg['content']) ?></pre>
            </div>
        <?php endforeach; ?>
    </div>

    <form id="chat-form" class="d-flex gap-2">
        <input type="text" id="chat-input" class="form-control"
               placeholder="例: UserモデルにSNS連携カラムを追加したい" autocomplete="off">
        <button type="submit" class="btn btn-primary">送信</button>
        <button type="button" id="chat-reset" class="btn btn-outline-secondary">リセット</button>
    </form>
</div>

<?php
$sendUrl = Url::to(['ai-assistant/send']);
$resetUrl = Url::to(['ai-assistant/reset']);
$csrfParam = Yii::$app->request->csrfParam;
$csrfToken = Yii::$app->request->csrfToken;

$js = <<<JS
const chatLog = document.getElementById('chat-log');
const form = document.getElementById('chat-form');
const input = document.getElementById('chat-input');

function appendBubble(role, text) {
    const wrap = document.createElement('div');
    wrap.className = 'mb-3' + (role === 'user' ? ' text-end' : '');
    wrap.innerHTML = `
        <span class="badge \${role === 'user' ? 'bg-primary' : 'bg-secondary'} mb-1">
            \${role === 'user' ? 'あなた' : 'Claude'}
        </span>
        <pre class="bg-white border rounded p-2" style="white-space: pre-wrap;"></pre>
    `;
    wrap.querySelector('pre').textContent = text;
    chatLog.appendChild(wrap);
    chatLog.scrollTop = chatLog.scrollHeight;
}

form.addEventListener('submit', async (e) => {
    e.preventDefault();
    const message = input.value.trim();
    if (!message) return;

    appendBubble('user', message);
    input.value = '';

    const res = await fetch('$sendUrl', {
        method: 'POST',
        headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
        body: new URLSearchParams({ message: message, '$csrfParam': '$csrfToken' }),
    });
    const data = await res.json();
    appendBubble('assistant', data.reply || ('エラー: ' + data.error));
});

document.getElementById('chat-reset').addEventListener('click', async () => {
    await fetch('$resetUrl', {
        method: 'POST',
        headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
        body: new URLSearchParams({ '$csrfParam': '$csrfToken' }),
    });
    chatLog.innerHTML = '';
});
JS;
$this->registerJs($js);
?>

5. 動作イメージ

SiteController のメニューか、AppAsset のナビバーに以下を追加すればアクセスできます。

['label' => 'AIアシスタント', 'url' => ['/ai-assistant/index']],

実際にブラウザで「Userモデルに論理削除を追加して」と送ると、Claudeは

1. deleted_at カラム追加のマイグレーション
2. SoftDeleteBehavior（Yii2公式の yii2tech/ar-softdelete or 自前Behavior）の実装案
3. 既存クエリへの影響（デフォルトスコープの扱い）についての確認質問

という順で、コードと一緒に「次にどうしたいか」を聞き返してくる会話になります。これがChatGPT的な単発生成との一番の違いです。

この記事は 「そのままコピペで動く」 を重視しています。

事前準備とディレクトリ構成

以下のフォルダを作成します。

C:\Work\Workspace\Docker\example.com\
├─ htdocs\ ← Yii2のアプリ本体が入る（後で自動生成）
├─ docker\
│ ├─ php\
│ │ ├─ Dockerfile
│ │ └─ php.ini
│ └─ nginx\
│ └─ default.conf
└─ docker-compose.yml

docker-compose.yml の作成

ファイル: C:\Work\Workspace\Docker\example.com\docker-compose.yml

services:
  nginx:
    image: nginx:1.27-alpine
    container_name: example_nginx
    ports:
      - "8080:80" # Web → http://localhost:8080
    volumes:
      - ./htdocs:/var/www/html
      - ./docker/nginx/default.conf:/etc/nginx/conf.d/default.conf:ro
    depends_on:
      - php
    networks:
      - appnet

  php:
    build:
      context: ./docker/php
      dockerfile: Dockerfile
    container_name: example_php
    volumes:
      - ./htdocs:/var/www/html
    environment:
      PHP_MEMORY_LIMIT: 512M
      PHP_MAX_EXECUTION_TIME: 120
    networks:
      - appnet
  db:
    image: mysql:8.0
    container_name: example_db
    command: ["mysqld", "--default-authentication-plugin=mysql_native_password", "--character-set-server=utf8mb4", "--collation-server=utf8mb4_0900_ai_ci"]
    environment:
      MYSQL_ROOT_PASSWORD: root
      MYSQL_DATABASE: example
      MYSQL_USER: app
      MYSQL_PASSWORD: apppass
      TZ: Asia/Tokyo
    ports:
      - "3307:3306" # ローカルMySQLと衝突回避したい場合は3307→3306
    volumes:
      - dbdata:/var/lib/mysql
    networks:
      - appnet

  phpmyadmin:
    image: phpmyadmin:5-apache
    container_name: example_pma
    environment:
      PMA_HOST: db
      PMA_USER: root
      PMA_PASSWORD: root
    ports:
      - "8081:80" # phpMyAdmin → http://localhost:8081
    depends_on:
      - db
    networks:
      - appnet

  mailpit:
    image: axllent/mailpit:latest
    container_name: example_mailpit
    ports:
      - "1025:1025" # SMTP (アプリからの送信先)
      - "8025:8025" # Web UI → http://localhost:8025
    networks:
      - appnet

volumes:
  dbdata:

networks:
  appnet:
    driver: bridge

PHP（php-fpm）用 Dockerfile と設定

ファイル: C:\Work\Workspace\Docker\example.com\docker\php\Dockerfile

FROM php:8.3-fpm-alpine

# 必要拡張の導入
RUN apk add --no-cache \
    git zip unzip icu-dev oniguruma-dev libpng-dev libjpeg-turbo-dev libwebp-dev libzip-dev autoconf build-base \
 && docker-php-ext-configure gd --with-jpeg --with-webp \
 && docker-php-ext-install -j$(nproc) pdo_mysql intl mbstring gd zip exif bcmath opcache

# Composer
COPY --from=composer:2 /usr/bin/composer /usr/bin/composer

WORKDIR /var/www/html

Nginx の設定

ファイル: C:\Work\Workspace\Docker\example.com\docker\nginx\default.conf

server {
  listen 80;
  server_name example.com localhost;

  root /var/www/html/web;
  index index.php index.html;

  location / {
    try_files $uri $uri/ /index.php?$args;
  }

  location ~ \.php$ {
    include       fastcgi_params;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    fastcgi_pass php:9000;
    fastcgi_buffers 16 16k;
    fastcgi_buffer_size 32k;
  }

  location ~* \.(jpg|jpeg|png|gif|ico|css|js|svg|woff2?|ttf)$ {
    expires 7d;
    add_header Cache-Control "public";
  }
}

php.ini の最低限の調整

ファイル: C:\Work\Workspace\Docker\example.com\docker\php\php.ini

memory_limit = ${PHP_MEMORY_LIMIT}
max_execution_time = ${PHP_MAX_EXECUTION_TIME}
upload_max_filesize = 32M
post_max_size = 32M
date.timezone = Asia/Tokyo

コンテナの起動と初期化

PowerShell で次を実行します。

cd C:\Work\Workspace\Docker\example.com
# 初回ビルド＆起動
docker compose up -d --build

# 状態確認
docker compose ps

• http://localhost:8080 → Nginx（Yii2はまだ未導入なので404/エラー想定）
• http://localhost:8081 → phpMyAdmin（root / root、サーバ: db でログイン可）
• http://localhost:8025 → Mailpit（受信ボックスUI）

Yii2 のインストール（コンテナ内でComposer実行）

htdocs に Yii2 Basic を展開します。

# PHPコンテナに入る
docker compose exec php sh

# コンテナ内で実行（/var/www/html）
composer create-project yiisoft/yii2-app-basic .
exit

作成後、Windows側では C:\Work\Workspace\Docker\example.com\htdocs にファイルが展開されます。Nginx の root は /web 配下なので、web/index.php が入口になります。

DB接続設定（.env と Yii2設定）

Yii2 Basic はデフォルトで .env はありませんが、設定を分けたい場合は導入も可能です。ここではシンプルに config/db.php を直接編集します。

ファイル: htdocs\config\db.php

<?php
return [
  'class' => 'yii\db\Connection',
  'dsn' => 'mysql:host=db;port=3306;dbname=example',
  'username' => 'app',
  'password' => 'apppass',
  'charset' => 'utf8mb4',
  'attributes' => [
    PDO::ATTR_EMULATE_PREPARES => false,
    PDO::ATTR_STRINGIFY_FETCHES => false,
  ],
];

host は db（docker-compose のサービス名）を指定します。ホストOSから直接接続する場合は localhost:3307 です。

初期テーブルを作る例として、マイグレーションを1本作ってみます（任意）。

# PHPコンテナに入る
docker compose exec php sh

# マイグレーション作成
php yii migrate/create create_post_table

# 生成されたファイル(例: migrations/mYYYYMMDD_HHMMSS_create_post_table.php)を編集
exit

サンプル（生成ファイルを編集）

public function safeUp()
{
  $this->createTable('{{%post}}', [
    'id' => $this->primaryKey(),
    'title' => $this->string()->notNull(),
    'body' => $this->text(),
    'created_at' => $this->dateTime()->defaultExpression('CURRENT_TIMESTAMP'),
  ]);
}


public function safeDown()
{
  $this->dropTable('{{%post}}');
}

# もう一度入って実行
docker compose exec php sh
php yii migrate --interactive=0
exit

Mailpit（メール送信テスト）設定

開発中のメールは 本当に送らない のが安全です。Mailpit に流してUIで確認しましょう。

ファイル: htdocs\config\web.php（components に mailer を追記）

'components' => [
  // ... 既存設定 ...
  'mailer' => [
    'class' => 'yii\swiftmailer\Mailer',
    'useFileTransport' => false, // falseでSMTPへ送信
    'transport' => [
      'class' => 'Swift_SmtpTransport',
      'host' => 'mailpit',
      'port' => 1025,
      'encryption' => null,
    ],
  ],
],

もし Yii2 を yiisoft/mailer に置き換える場合は適宜設定を読み替えてください（SwiftMailerは非推奨化済みですが、Yii2 Basic既定の形のままでもMailpit連携は可能です）。

テスト送信例（コントローラやコンソールから）

Yii::$app->mailer->compose()
         ->setFrom('no-reply@example.com')
         ->setTo('test@example.com')
         ->setSubject('Mailpit送信テスト')
         ->setTextBody('これはテスト本文です')
         ->send();

http://localhost:8025 を開くと、受信メールが一覧表示されます。

動作確認（Web・DB・Mail）

1. Web
   http://localhost:8080 にアクセスして Yii2 のトップが表示されること。
2. DB
   http://localhost:8081 → phpMyAdmin に root/root でログイン。example データベースに post テーブルができていること。
3. Mail
   サンプルコードを実行し、http://localhost:8025 の受信箱にメールが入ること。

トラブルシューティング

ポート競合

8080/8081/8025/1025/3307 が使用中 → docker-compose.yml の ports 左側（ホスト側）を変更。

MySQLへ接続できない

• host は db（Docker内部）か、ホスト接続では localhost:3307 を指定。
• 初回起動直後はDBの立ち上がり待ちが必要。数秒待って再試行。

Windows で権限由来の書き込みエラー

htdocs/runtime と htdocs/web/assets の書き込み権限が必要。コンテナ側で chmod -R 777 runtime web/assets（開発用途限定）。

ファイルの改行コード

Nginxやシェル用ファイルは LF を推奨。VS Codeで LF へ変換。

古いコンテナやイメージの削除でエラー

例: Error response from daemon: conflict: unable to delete ... image is being used by stopped container ...

docker ps -a # 停止中を含め一覧
docker rm <CONTAINER_ID> # 停止中コンテナを削除
docker rmi <IMAGE_ID> # 参照がなくなったらイメージ削除
# 一括停止・削除（このプロジェクト内）
docker compose down -v # コンテナ・ネットワーク・ボリューム削除
docker system prune -f # 不要なリソース掃除

Composerが遅い/タイムアウト

一時的に -vvv で状況確認。社内プロキシ下では環境変数の設定を。

よく使うコマンド集

# 起動・ビルド
cd C:\Work\Workspace\Docker\example.com
docker compose up -d --build

# 停止
docker compose down

# 停止＋ボリュームごと削除（DB初期化したいとき）
docker compose down -v

# ログ参照
docker compose logs -f nginx
docker compose logs -f php
docker compose logs -f db

# コンテナに入る
docker compose exec php sh

# 権限（開発用）
docker compose exec php sh -c "chmod -R 777 runtime web/assets"

あとがき

ここまでで、Windows + Docker 上に Yii2 + MySQL + phpMyAdmin + Mailpit の開発環境が整いました。実運用では Mailpit の代わりに本番SMTPを使いますが、開発段階では誤送信防止のため Mailpit固定 を強くおすすめします。また、MySQLのパスワードや公開ポートは本番用に必ず見直してください。必要に応じて SSL や Xdebug の導入、Nginxのキャッシュ/セキュリティヘッダ の調整などを行うと、より快適で安全な環境になります。

本記事では、Yii3で何が変わったのか、Yii2との違いやディレクトリ構造、実際にデータベースを使ったミニサンプルも交えて、実用的に解説します。

https://yii3.netlify.app/guide.html

yii3.netlify.app

Yii2との主な違い・進化ポイント

Yii3では、近年のPHP界のトレンドであるPSR準拠を徹底しており、モダンPHPと高い互換性を持ちながら設計されています。

Yii3のディレクトリ構成

Yii3の標準的なアプリケーション構造は以下のようになります。

myapp/
├── config/          ← アプリ設定（DIやルーティングなど）
├── public/          ← Web公開ディレクトリ（index.php）
├── runtime/         ← ログやキャッシュなどの一時ファイル
├── src/             ← アプリケーションの本体コード
│   └── Controller/
│   └── Middleware/
│   └── View/
├── tests/           ← PHPUnitベースのテストコード
├── vendor/          ← Composer依存
└── composer.json

「config」や「src」にアプリロジックが集約されており、明確にMVCが分離されています。

Yii3での簡単なデータベース操作サンプル（MVC構成で作成）

このサンプルでは、次の機能を実装します。

「post テーブルの全件を取得して、一覧表示するWebページ」

ディレクトリ構成とファイル配置

まず、以下のようにディレクトリ構成を整理します。Yii3では、src/ がアプリケーションコードの中核です。

myapp/
├── config/
│   └── params.php
│   └── routes.php         ← ルーティング設定
│   └── web.php            ← DI・アプリ設定
├── src/
│   ├── Controller/
│   │   └── SiteController.php   ← コントローラ（C）
│   ├── Model/
│   │   └── Post.php             ← モデル（M）
│   ├── View/
│   │   └── site/
│   │       └── index.php        ← ビュー（V）
├── public/
│   └── index.php          ← フロントコントローラ
├── vendor/                ← Composer依存
└── composer.json

モデル（M） – src/Model/Post.php

ActiveRecordを使用して、post テーブルに対応したモデルクラスを作成します。

<?php
namespace App\Model;

use Yiisoft\ActiveRecord\ActiveRecord;

final class Post extends ActiveRecord
{
    public static function tableName(): string
    {
        return 'post';
    }
}

コントローラ（C） – src/Controller/SiteController.php

データベースからデータを取得し、ビューに渡す役割を担います。

<?php
namespace App\Controller;

use App\Model\Post;
use Yiisoft\Yii\View\ViewRenderer;
use Yiisoft\Router\CurrentRoute;

final class SiteController
{
    private ViewRenderer $view;

    public function __construct(ViewRenderer $view)
    {
        $this->view = $view->withControllerName('site');
    }

    public function index(): string
    {
        $posts = Post::find()->all(); // すべての投稿を取得
        return $this->view->render('index', ['posts' => $posts]);
    }
}

ビュー（V） – src/View/site/index.php

データをHTMLとして整形・表示するテンプレートファイルです。

<h1>記事一覧</h1>

<ul>
<?php foreach ($posts as $post): ?>
    <li>
        <strong><?= htmlspecialchars($post->title) ?></strong><br>
        <?= nl2br(htmlspecialchars($post->content)) ?>
    </li>
<?php endforeach; ?>
</ul>

ルーティング設定 – config/routes.php

リクエストURLとコントローラの対応関係を定義します。

<?php

use Yiisoft\Router\Route;
use App\Controller\SiteController;

return [
    Route::get('/')
        ->action([SiteController::class, 'index'])
];

アプリ設定 – config/web.php

必要なパッケージや設定を読み込むファイルです。ここでDB接続なども設定します。

<?php

use Yiisoft\Db\Connection\ConnectionInterface;
use Yiisoft\Db\Mysql\Connection;

return [
    ConnectionInterface::class => static function () {
        return new Connection(
            dsn: 'mysql:host=localhost;dbname=yii3_demo',
            username: 'root',
            password: 'your_password',
        );
    },
];

フロントコントローラ – public/index.php

アプリケーションのエントリーポイントです。

<?php

declare(strict_types=1);

require dirname(__DIR__) . '/vendor/autoload.php';

use Yiisoft\Yii\Web\Application;
use Yiisoft\Yii\Web\Emitter\SapiEmitter;

$container = require dirname(__DIR__) . '/config/web.php';

$app = new Application($container);

$response = $app->handle(
    $_SERVER['REQUEST_METHOD'],
    $_SERVER['REQUEST_URI']
);

(new SapiEmitter())->emit($response);

MySQL テーブル定義

CREATE TABLE post (
    id INT AUTO_INCREMENT PRIMARY KEY,
    title VARCHAR(255) NOT NULL,
    content TEXT NOT NULL
);

実行までの流れまとめ

1. MySQLで post テーブルを作成する
2. composer install で依存パッケージを取得
3. php -S localhost:8080 -t public で開発サーバを起動
4. ブラウザで http://localhost:8080 にアクセス

補足：Yii3は「自由度の高いMVC」

Yii3は、Laravelのような「レールに乗った」MVCよりも、より柔軟で明示的なアーキテクチャを採用しています。自分で組み立てる分、学習コストはやや高いかもしれませんが、カスタマイズ性と保守性に優れた構成です。

この構成に沿えば、MVCモデルの設計思想を維持しつつ、Yii3のモダンな利点を活かしたWebアプリを構築できます。
今後はフォームバリデーション、APIレスポンス、ログイン機能など、より実践的なトピックも記事化していきます。

この記事では、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の柔軟なイベントシステムを最大限活用していきましょう。

本記事では、Symfony7をより深く理解し、日々の開発業務を効率化するための便利な技を厳選してご紹介します。これらのテクニックを活用することで、コードの可読性、保守性、そして開発速度を飛躍的に向上させることができるでしょう。

Attribute（属性）の活用でアノテーションから脱却！

PHP8から導入されたAttribute（属性）は、Symfonyでも積極的に採用されています。コントローラーのルーティング定義やバリデーション、サービス定義など、これまでアノテーションで行っていた設定を、より直感的で可読性の高いAttributeで記述できます。

例：ルーティング定義

// アノテーションの場合 (Symfony 5/6)
/**
 * @Route("/users/{id}", name="user_show", methods={"GET"})
 */
public function show(User $user): Response
{
    // ...
}

// Attributeの場合 (Symfony 7)
#[Route('/users/{id}', name: 'user_show', methods: ['GET'])]
public function show(User $user): Response
{
    // ...
}

Attributeを使用することで、クラス定義と設定がより近くに配置され、コードの意図が明確になります。

型付きプロパティとコンストラクタープロモーションでボイラープレートを削減

PHP7.4で導入された型付きプロパティと、PHP8.0のコンストラクタープロモーションを活用することで、クラスのプロパティ定義とコンストラクターの引数への代入処理を簡潔に記述できます。

例：サービスオブジェクト

// 従来の書き方
class UserService
{
    private UserRepository $userRepository;
    private LoggerInterface $logger;

    public function __construct(UserRepository $userRepository, LoggerInterface $logger)
    {
        $this->userRepository = $userRepository;
        $this->logger = $logger;
    }

    // ...
}

// コンストラクタープロモーションを使った書き方 (Symfony 7)
class UserService
{
    public function __construct(
        private UserRepository $userRepository,
        private LoggerInterface $logger
    ) {
    }

    // ...
}

これにより、冗長なプロパティ定義と代入処理が不要になり、より重要なロジックに集中できます。

Enumerable（列挙型）をエンティティで活用する

PHP8.1で導入されたEnumerable（列挙型）は、エンティティの状態管理や定数管理をより安全かつ型安全に行うために役立ちます。Symfony Doctrine Bridgeとの連携もスムーズです。

例：ユーザーのステータス管理

// PHP 8.1 Enumerable
enum UserStatus: string
{
    case PENDING = 'pending';
    case ACTIVE = 'active';
    case INACTIVE = 'inactive';
}

// エンティティでの利用
#[ORM\Entity]
class User
{
    // ...

    #[ORM\Column(type: 'string', enumType: UserStatus::class)]
    private UserStatus $status = UserStatus::PENDING;

    public function getStatus(): UserStatus
    {
        return $this->status;
    }

    public function setStatus(UserStatus $status): self
    {
        $this->status = $status;
        return $this;
    }
}

Enumerableを使用することで、マジックナンバーや文字列による比較を防ぎ、コードの可読性と保守性を向上させます。

Messengerコンポーネントで非同期処理をスマートに

SymfonyのMessengerコンポーネントは、メッセージキューイングシステムと連携し、時間のかかる処理をバックグラウンドで非同期的に実行するための強力なツールです。メール送信、画像処理、API連携などを非同期化することで、ユーザー体験を向上させることができます。

基本的な流れ

1. メッセージクラスの作成
   実行したい処理の内容を表すシンプルなPHPクラスを作成します。
2. メッセージハンドラーの作成
   メッセージを受け取り、実際の処理を実行するクラスを作成します。
3. メッセージのディスパッチ
   コントローラーやサービスからメッセージをMessengerに送信します。
4. ワーカーの起動
   バックグラウンドでメッセージキューを監視し、処理を実行するワーカーを起動します。

Messengerを活用することで、アプリケーションの応答性を高め、より複雑な処理を効率的に管理できます。

HttpClientコンポーネントで外部API連携を簡単に

SymfonyのHttpClientコンポーネントは、外部APIとの連携をシンプルかつ強力にサポートします。HTTPリクエストの送信、レスポンスの処理、認証、タイムアウト設定などを柔軟に行うことができます。

基本的な使い方

use Symfony\Contracts\HttpClient\HttpClientInterface;

class ApiService
{
    private HttpClientInterface $client;

    public function __construct(HttpClientInterface $client)
    {
        $this->client = $client;
    }

    public function fetchUserData(int $userId): array
    {
        $response = $this->client->request(
            'GET',
            'https://api.example.com/users/' . $userId,
            [
                'headers' => [
                    'Authorization' => 'Bearer YOUR_API_KEY',
                ],
            ]
        );

        return $response->toArray();
    }
}

HttpClientを使用することで、様々な外部サービスとの連携をスムーズに行うことができます。

Serializerコンポーネントでデータ変換を自由自在に

SymfonyのSerializerコンポーネントは、PHPオブジェクトと様々なデータ形式（JSON、XML、YAMLなど）との相互変換を簡単に行うことができます。API開発やデータインポート/エクスポート処理などで非常に役立ちます。

基本的な使い方

use Symfony\Component\Serializer\SerializerInterface;

class DataConverter
{
    private SerializerInterface $serializer;

    public function __construct(SerializerInterface $serializer)
    {
        $this->serializer = $serializer;
    }

    public function serializeToJson(object $data): string
    {
        return $this->serializer->serialize($data, 'json');
    }

    public function deserializeJson(string $jsonData, string $type): object
    {
        return $this->serializer->deserialize($jsonData, $type, 'json');
    }
}

Serializerを活用することで、データ形式に依存しない柔軟なアプリケーション開発が可能になります。

Formコンポーネントの進化とカスタマイズ

SymfonyのFormコンポーネントは、ユーザーからの入力を安全かつ効率的に処理するための強力なツールです。Symfony7では、より柔軟なフォームの定義やカスタマイズが可能になっています。

• Attributeベースのフォーム定義
  フォームタイプクラス内でもAttributeを利用してフィールドを定義できます。
• 型付きのフォーム
  フォームデータに型ヒントを設定することで、より安全なデータ処理を実現できます。
• イベントリスナーとデータトランスフォーマー
  複雑なフォームのロジックやデータ変換を柔軟に実装できます。

Formコンポーネントを深く理解することで、複雑な入力フォームも効率的に開発できます。

Securityコンポーネントの強力な認証・認可機能

SymfonyのSecurityコンポーネントは、アプリケーションのセキュリティを強固にするための認証（ユーザーの識別）と認可（ユーザーのアクセス権限の管理）機能を提供します。

• ガード認証
  より柔軟な認証フローを実装できます。
• Attributeベースのアクセス制御
  コントローラーやメソッドレベルでアクセス制御をAttributeで定義できます。
• Role階層
  複雑な権限管理を効率的に行えます。

Securityコンポーネントを適切に設定することで、アプリケーションを様々な脅威から守ることができます。

Cacheコンポーネントによるパフォーマンス向上

SymfonyのCacheコンポーネントは、アプリケーションのパフォーマンスを向上させるための様々なキャッシュ機構を提供します。HTTPキャッシュ、アプリケーションレベルのキャッシュなど、用途に応じたキャッシュ戦略を簡単に実装できます。

• PSR-6/PSR-16準拠
  標準化されたインターフェースで様々なキャッシュバックエンドを利用できます。
• タグ付きキャッシュ
  関連するキャッシュアイテムをまとめて削除できます。
• HTTPキャッシュの活用
  ブラウザやプロキシによるキャッシュを効率的に利用できます。

Cacheコンポーネントを活用することで、アプリケーションの応答速度を大幅に改善できます。

Profilerとデバッグツールの活用

SymfonyのProfilerは、リクエストの処理過程で発生した様々な情報を収集し、開発者がアプリケーションの動作を詳細に分析するための強力なツールです。データベースクエリ、HTTPリクエスト、イベント、ログなどを視覚的に確認できます。

また、dump()関数やdd()関数などのデバッグツールを活用することで、変数の内容やプログラムの流れを簡単に確認できます。

これらのツールを使いこなすことで、問題の特定やパフォーマンスのボトルネックの発見が容易になります。

まとめ

Symfony7には、開発者の生産性を向上させ、より堅牢で保守性の高いアプリケーションを構築するための多くの便利な機能が搭載されています。今回ご紹介した技はほんの一部ですが、これらを活用することで、Symfony7での開発がより快適になるはずです。

ぜひ、これらのテクニックを日々の開発に取り入れて、Symfony7のパワーを最大限に引き出してください。

Entityの存在意義と役割

Entityとは？

CodeIgniter4のEntityは、データベースから取得したデータをオブジェクト指向的に操作するための仕組みです。単なる配列やstdClassではなく、データのバリデーション・整形・ミューテーションを簡単に行えるのが特徴です。

なぜEntityを使うのか？

• データの一貫性を保つ
  直接データを変更するのではなく、Entityを介して操作することで、バリデーションや加工処理を統一できる。
• getter/setterの活用で安全性を向上
  getFullName() のようなカスタムメソッドを作成できるため、ロジックを一元管理しやすい。
• データのミューテーション（変換）
  setPassword() でパスワードのハッシュ化を自動化するなど、データ変換を簡単に実装できる。

Entityの使用例

Entityクラスの作成

まずは、app/Entities/User.php にEntityクラスを作成します。

namespace App\Entities;

use CodeIgniter\Entity\Entity;

class User extends Entity
{
    // 自動的にキャストするフィールド
    protected $attributes = [
        'id'       => null,
        'username' => null,
        'email'    => null,
        'password' => null,
    ];

    // パスワードのハッシュ化
    public function setPassword(string $password)
    {
        $this->attributes['password'] = password_hash($password, PASSWORD_DEFAULT);
        return $this;
    }

    // フルネームを取得する例（仮）
    public function getFullName()
    {
        return $this->attributes['first_name'] . ' ' . $this->attributes['last_name'];
    }
}

Entityをモデルと組み合わせる

次に、Entityを利用するために、UserModel にEntityクラスを設定します。

namespace App\Models;

use CodeIgniter\Model;

class UserModel extends Model
{
    protected $table = 'users';
    protected $primaryKey = 'id';
    
    protected $returnType = 'App\Entities\User'; // ここでEntityを指定する
    protected $allowedFields = ['username', 'email', 'password'];

    // 自動的にタイムスタンプを更新
    protected $useTimestamps = true;
}

コントローラーでの使用例

use App\Models\UserModel;
use App\Entities\User;

$userModel = new UserModel();

// 新しいユーザーの作成
$user = new User();
$user->username = 'testuser';
$user->email = 'test@example.com';
$user->setPassword('securepassword');

$userModel->save($user);

setPassword() を呼ぶことで、自動的にパスワードをハッシュ化できます。

データ取得時の活用

$user = $userModel->find(1);
echo $user->getFullName(); // フルネームを取得

Entityを使わない場合との比較

Entityなし（配列ベースの管理）

$data = [
    'username' => 'testuser',
    'email' => 'test@example.com',
    'password' => password_hash('securepassword', PASSWORD_DEFAULT),
];

$userModel->insert($data);

この方法でも保存は可能ですが、ロジックをコントローラーに書いてしまうため、コードの再利用性や可読性が低下します。

Entityあり

Entityを使用すると、バリデーションやデータ変換を統一でき、オブジェクト指向的に管理できるため、スッキリしたコードが書けます。

まとめ

Entityを使うことで、データをオブジェクトとして扱い、バリデーションや整形を一元管理できるため、よりクリーンなコードを実現できます！

１．必要な環境の準備

Linuxサーバの前提

• OS
  Ubuntu、CentOS、Debianなど
• PHP
  Symfony4はPHP 7.1以上が必要です
  ※ php -v コマンドでバージョンを確認してください
• Composer
  PHPパッケージ管理ツール
• Webサーバ
  ApacheまたはNginx（ここではApacheの例を示します

ドメイン設定

• DNSで「www.example.com」が対象サーバのIPを指していることを確認してください
  

２．Apacheによるドメイン設定

ApacheでのVirtualHost設定例（/etc/apache2/sites-available/example.com.conf）

<VirtualHost *:80>
    ServerName www.example.com
    DocumentRoot /var/www/example.com/public

    <Directory /var/www/example.com/public>
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

設定後、以下のコマンドで有効化と再起動を行います

sudo a2ensite example.com
sudo a2enmod rewrite
sudo systemctl reload apache2

３．Symfony4プロジェクトの作成と配置

１．プロジェクトディレクトリの作成

Webサーバのドキュメントルート（例：/var/www/example.com）に移動し、ディレクトリを作成

sudo mkdir -p /var/www/example.com
cd /var/www/example.com
sudo chown $(whoami):$(whoami) .

２．Symfony4プロジェクトのインストール

Composerを使ってSymfony4プロジェクトを作成します。今回はDoctrineやセキュリティ機能が含まれるスターターキットを利用

composer create-project symfony/website-skeleton board_project

※ プロジェクトディレクトリ（例：board_project）内にpublicフォルダが作成されます。
※ ApacheのDocumentRootは、このpublicフォルダを指定してください（もしくはVirtualHost設定でパスを調整）。

４．データベース設定とエンティティ作成

掲示板の情報（ユーザ情報、投稿内容など）をデータベースに保存します。ここではMySQLを例にしています。

4.1. データベース接続情報の設定

プロジェクトルートの .env ファイルを編集し、DATABASE_URL を設定してください。

DATABASE_URL=mysql://db_user:db_password@127.0.0.1:3306/db_name

4.2. ユーザエンティティの作成

Symfony MakerBundleを利用してユーザエンティティを作成します。

php bin/console make:user

プロンプトに従い、エンティティ名（例：User）や識別子（メールアドレスまたはユーザ名）、パスワードフィールド、既定のロール（通常ユーザには ROLE_USER、管理者には ROLE_ADMIN）を設定します。

4.3. 掲示板投稿（Post）エンティティの作成

投稿情報を保存するためのエンティティを作成します。

php bin/console make:entity Post

以下のフィールドを追加すると良いでしょう：

• title : string
• content : text
• createdAt : datetime
• user : ManyToOne（Userエンティティとの関連付け、投稿者情報）

4.4. マイグレーションの実行

エンティティ作成後、マイグレーションを作成してデータベースに反映させます

php bin/console make:migration
php bin/console doctrine:migrations:migrate

５．ユーザ認証と管理者機能の実装

Symfonyのセキュリティコンポーネントを利用して、ログイン・登録機能、アクセス制限を実装します。

5.1. ログイン・登録フォームの作成

Symfony MakerBundleを使用して、ログインフォーム認証を生成します

php bin/console make:auth

また、ユーザ登録フォームも作成する場合は

php bin/console make:registration-form

生成されたコントローラーやフォームクラスを適宜編集し、パスワードエンコーディングやCSRF保護の設定を確認してください。

5.2. security.yaml の設定

プロジェクトの config/packages/security.yaml を以下のように設定します。必要に応じてプロバイダやファイアウォールの設定を調整してください。

security:
    encoders:
        App\Entity\User:
            algorithm: bcrypt

    providers:
        app_user_provider:
            entity:
                class: App\Entity\User
                property: email

    firewalls:
        dev:
            pattern: ^/(_(profiler|wdt)|css|images|js)/
            security: false
        main:
            anonymous: true
            lazy: true
            provider: app_user_provider
            form_login:
                login_path: login
                check_path: login
                default_target_path: /
            logout:
                path: logout

    access_control:
        # 管理者エリアへのアクセスはROLE_ADMINに制限
        - { path: ^/admin, roles: ROLE_ADMIN }
        # 投稿作成・編集はログインユーザに制限
        - { path: ^/post/new, roles: ROLE_USER }
        - { path: ^/post/edit, roles: ROLE_USER }

5.3. 管理者権限の付与

ユーザ登録時や管理画面で、管理者ユーザには ROLE_ADMIN を割り当てます。管理エリア用のコントローラー（例：AdminDashboardController）はルートを /admin で始め、上記の access_control により管理者以外はアクセスできないようにします。

６．掲示板機能（BBS）の実装

掲示板の基本機能として、投稿の一覧表示、投稿詳細、投稿作成、編集、削除などの機能を実装します。

6.1. コントローラー作成

例として、BoardController を作成し、以下のようなアクションを実装します。

<?php
// src/Controller/BoardController.php
namespace App\Controller;

use App\Entity\Post;
use App\Repository\PostRepository;
use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Annotation\Route;

class BoardController extends AbstractController
{
    /**
     * @Route("/", name="board_index")
     */
    public function index(PostRepository $postRepository): Response
    {
        $posts = $postRepository->findBy([], ['createdAt' => 'DESC']);
        return $this->render('board/index.html.twig', [
            'posts' => $posts,
        ]);
    }

    /**
     * @Route("/post/{id}", name="board_view", requirements={"id"="\d+"})
     */
    public function view(Post $post): Response
    {
        return $this->render('board/view.html.twig', [
            'post' => $post,
        ]);
    }

    /**
     * @Route("/post/new", name="board_new")
     */
    public function new(Request $request): Response
    {
        // ログインユーザのみ投稿可能
        $this->denyAccessUnlessGranted('ROLE_USER');

        $post = new Post();
        // フォーム作成、リクエストのハンドリング（例：Symfony Formコンポーネントを利用）
        // ※ ここでは簡易例として、フォーム処理の詳細は省略

        // 保存処理
        // $entityManager = $this->getDoctrine()->getManager();
        // $post->setCreatedAt(new \DateTime());
        // $post->setUser($this->getUser());
        // $entityManager->persist($post);
        // $entityManager->flush();

        return $this->render('board/new.html.twig', [
            'post' => $post,
            // 'form' => $form->createView(),
        ]);
    }

    // 編集・削除アクションも必要に応じて実装
}

6.2. Twigテンプレート作成

templates/board/ 配下に各ビュー用テンプレートを作成します。

例：index.html.twig（投稿一覧表示）

{% extends 'base.html.twig' %}

{% block title %}掲示板{% endblock %}

{% block body %}
    <h1>掲示板投稿一覧</h1>
    {% for post in posts %}
        <div class="post">
            <h2><a href="{{ path('board_view', {id: post.id}) }}">{{ post.title }}</a></h2>
            <p>{{ post.content|raw }}</p>
            <small>投稿者: {{ post.user.email }} ・ 投稿日: {{ post.createdAt|date('Y-m-d H:i') }}</small>
        </div>
        <hr>
    {% else %}
        <p>まだ投稿がありません。</p>
    {% endfor %}
    {% if is_granted('ROLE_USER') %}
        <a href="{{ path('board_new') }}">新規投稿</a>
    {% else %}
        <p><a href="{{ path('login') }}">ログイン</a>して投稿しましょう。</p>
    {% endif %}
{% endblock %}

※ 各テンプレートは必要に応じてデザインやレイアウトを調整してください。

７．アクセス制限とセキュリティ対策

アクセス制限

• /admin 以下のルートは ROLE_ADMIN のみアクセス可能とし、security.yaml の access_control で管理
• 投稿作成編集はログインユーザ（ROLE_USER）に限定するため、コントローラー内で denyAccessUnlessGranted() を利用

セキュリティ対策

• フォームにCSRF保護を設定
• ユーザ入力のバリデーションとサニタイズを実施
• パスワードはエンコーダー（例：bcrypt）で暗号化

８．パーミッション設定と本番環境向け最適化

8.1. ディレクトリのパーミッション設定

Symfonyはキャッシュやログを書き込むため、Apache（例：ユーザ www-data）が書き込めるようACLを設定します。

sudo setfacl -R -m u:www-data:rwX -m u:$(whoami):rwX var
sudo setfacl -dR -m u:www-data:rwX -m u:$(whoami):rwX var

8.2. 本番環境向け設定の調整

.env で環境変数を設定（例：APP_ENV=prod, APP_DEBUG=0）

キャッシュのウォームアップ

php bin/console cache:warmup --env=prod

９．テストと動作確認

ローカルでの動作確認

ビルトインサーバを使ってローカルテスト

php bin/console server:run

ブラウザで http://127.0.0.1:8000 にアクセスし、投稿一覧やログイン・登録、投稿作成など各機能を確認してください。

本番サーバでの確認

DNS設定が完了していることを確認した上で、http://www.example.com へアクセスし、各機能が正しく動作するかテストします。

トラブルシューティング

エラーが発生した場合は、var/log/ 内のログファイル（例：prod.log や dev.log）を確認し、エラーメッセージに基づいて対処してください。

１０．まとめ

今回のマニュアルでは、Symfony4を用いた掲示板アプリケーションの作成手順を、以下の要素を中心に解説しました

• ユーザ認証・登録
  ログインフォームの生成とユーザエンティティ作成
• 管理者権限
  ROLE_ADMIN による管理エリアの制限
• アクセス制限
  各アクションへのアクセスをセキュリティコンポーネントで制御
• データベース連携
  Doctrineを利用したユーザ・投稿エンティティの管理
• 掲示板機能
  投稿の一覧表示、詳細表示、投稿作成・編集機能の実装

PHP5時代と比べ、Symfony4は構造化された設計や豊富なコンポーネントにより、拡張性・保守性に優れたアプリケーション開発が可能です。まずは本マニュアルの手順に沿って基本機能を実装し、そこからさらにカスタマイズや機能追加に挑戦してみてください。

背景

現在、私が運用しているプロジェクトは、CodeIgniter3をベースにした中規模なウェブアプリケーションです。初期の頃はMVC構成で十分だったものの、機能追加やページ数の増加とともに、コントローラーやビューが肥大化し、保守性が低下していきました。

特に、ある機能を別の機能でも使い回したいとき、毎回コピペやincludeを駆使するのは面倒で非効率。そんなときに目を付けたのが「HMVCパターン」でした。

しかし、既存のModelはかなり作り込まれており、ゼロから作り直すのは現実的ではありません。そこで、Modelは既存のものをそのまま使用しつつ、HMVCを導入することでコントローラーとビューをモジュール化し、効率的な開発環境を目指すことにしました。

HMVCとは？

HMVC（Hierarchical Model-View-Controller）は、MVCの各要素をモジュール単位で管理するアーキテクチャです。従来のMVCでは、コントローラー、モデル、ビューがそれぞれ一つのディレクトリに配置されますが、HMVCでは「モジュール」ごとにそれらをグループ化できます。

例えば、application/modulesディレクトリ内に以下のような構造でモジュールを配置します。

application/modules/
  blog/
    controllers/
    views/
    models/
  shop/
    controllers/
    views/
    models/

これにより、特定の機能を独立して管理・再利用できるようになります。

導入手順

ライブラリのダウンロード

wiredesignzのcodeigniter-modular-extensions-hmvcをGitHubからダウンロードします。

GitHub - codinghamster/codeigniter-modular-extensions-hmvc

Contribute to codinghamster/codeigniter-modular-extensions-hmvc development by creating an account on GitHub.

github.com

CodeIgniterへの組み込み

ダウンロードしたMXディレクトリをapplication/third_partyに配置します。

次にcoreディレクトリにあるMY_Controller.phpとMY_Router.phpを自プロジェクトのapplication/coreにコピーします。

config.phpを修正

application/config/config.phpを次のように修正します。

$config['modules_locations'] = array(
    APPPATH.'modules/' => '../modules/',
);

モジュールの作成

例えば、ブログ機能をモジュールとして作成する場合

application/modules/blog/controllers/Blog.php

application/modules/blog/views/index.php

※Modelは既存のapplication/models内のものを使用

モジュールの利用

モジュールから別のモジュールを呼び出す際もシンプルです。

$this->load->module('shop/cart');
$this->cart->add_item($item_id);

実装のポイント

• Modelは既存のものをそのまま使用
  新たにModelを作る必要がないため、導入コストを抑えられる。
• 共通機能のモジュール化
  例えば、ログイン処理やフォームバリデーションなど、複数ページで使う機能をモジュール化することで、DRY（Don’t Repeat Yourself）を徹底。
• チーム開発でのメリット
  複数人で開発する場合も、モジュールごとに担当を分けることでコンフリクトを減らせる。

まとめ

CodeIgniter3にHMVCパターンを導入することで、コードの可読性や保守性が劇的に向上しました。特に、既存のModelを活かしつつ導入できたことで、スムーズに移行できたのが大きなポイントです。

「CodeIgniterのMVCが限界かも…」と感じている方は、ぜひHMVCの導入を検討してみてください。

コンポーネントの開発

ディレクトリ・ファイルの作成

アプリケーションディレクトリ内にcomponentsディレクトリを作成します。

次にそのディレクトリの中にMailFetcherComponent.phpのファイルを次の内容で作成します。

ファイルの作成

<?php

namespace app\components;
    
use Yii;
use yii\base\Component;
use yii\base\Exception;

class MailFetcherComponent extends Component
{
    // Kind ( SMTP / IMAP / POP3 ).
    public $kind;
    
    // Mail server.
    public $host;
    
    // Connect post.
    public $port;
    
    // Account user.
    public $username;
    
    // Account password.
    public $password;
    
    // Encrypt type ( PLAIN / LOGIN / CRAM-MD5 ).
    public $encryption;
    
    // Target mail folder.
    public $mailboxFolder = 'INBOX';
    
    // Seaving server directoy for attachments.
    public $attachmentPath = false;
    
    protected $inbox;
    
    public function init()
    {
        parent::init();
        
        if (!$this->host || !$this->username || !$this->password) {
            throw  new \Exception("メールサーバの情報が不足しています。");
        }
        
    }
    
    public function connectOpen($args = [])
    {
        $labels = [ 'kind', 'host', 'port', 
                    'encryption', 'mailboxFolder'];
        
        $connectSource = "{{host}:{port}/{kind}/{encryption}}{mailboxFolder}";
        
        foreach ($labels as $label){
            if (isset($args[$label])) {
                $this->$label = $args[$label];
            }
            if (in_array($label, ['username', 'password'])) continue;
            
            $val = $label == 'mailboxFolder' ? 
                    strtoupper($this->$label) : 
                    strtolower($this->$label); 
            
            $connectSource = str_replace('{'.$label.'}', $val, $connectSource);
        }

        $this->inbox = imap_open($connectSource, $this->username, $this->password);
        
        if (!$this->inbox) {
            echo "IMAP接続に失敗しました: " . imap_last_error();
            return;
        }
        
        if (!$this->attachmentPath) {
            $this->attachmentPath = Yii::getAlias('@runtime/mail_attachments');
        }
        
        if (!is_dir($this->attachmentPath)) {
            mkdir($this->attachmentPath, 0777, true);
        }
    }
    
    public function fetchMails($searchCriteria = 'ALL')
    {
        $sources = [];
        
        $emails = imap_search($this->inbox, $searchCriteria);
        
        if ($emails) 
        {
            rsort($emails); // 最新のメールが最初に表示されるようにソート

            foreach ($emails as $emailNumber) 
            {
                $overview = imap_fetch_overview($this->inbox, $emailNumber, 0);
                
                // サブジェクトのデコード
                $subject = $this->mimeDecode($overview[0]->subject);

                // 差出人のデコード
                $from = $this->mimeDecode($overview[0]->from);
                
                $structure = imap_fetchstructure($this->inbox, $emailNumber);
                $message = '';
                
                
                if ($structure->type == 1) { // マルチパートメールの場合
                    
                    $attachments = array();
                    foreach ($structure->parts as $partNumber => $part) {
                        if ($part->subtype == 'PLAIN') {
                            $message = imap_fetchbody($this->inbox, $emailNumber, $partNumber + 1);

                            if ($part->encoding == 3) { // BASE64
                                $message = base64_decode($message);
                            } elseif ($part->encoding == 4) { // QUOTED-PRINTABLE
                                $message = quoted_printable_decode($message);
                            }
                            break;
                        }
                        
                        // 添付ファイルの取得
                        if (isset($part->disposition) && strtolower($part->disposition) == 'attachment') {
                            $attachment = imap_fetchbody($this->inbox, $emailNumber, $partNumber + 1);

                            if ($part->encoding == 3) { // BASE64
                                $attachment = base64_decode($attachment);
                            } elseif ($part->encoding == 4) { // QUOTED-PRINTABLE
                                $attachment = quoted_printable_decode($attachment);
                            }

                            $filename = 'attachment_' . time() . '_' . ($part->dparameters[0]->value ?? 'unknown');
                            file_put_contents($this->attachmentPath . '/' . $filename, $attachment);
                            $attachments[] = $this->attachmentPath . '/' . $filename;
                            echo "添付ファイルを保存しました: " . $filename . "\n";
                        }
                    }
                } else { // 単一パートメールの場合
                    $message = imap_fetchbody($this->inbox, $emailNumber, 1);

                    // エンコードの処理
                    if ($structure->encoding == 3) { // BASE64
                        $message = base64_decode($message);
                    } elseif ($structure->encoding == 4) { // QUOTED-PRINTABLE
                        $message = quoted_printable_decode($message);
                    }
                }

                $sources[$emailNumber] = [
                    'Subject' => $subject,
                    'From' => $from,
                    'Date' => $overview[0]->date,
                    'Message' => $message,
                ];
            }
        }
        
        imap_close($this->inbox);
        
        return $sources;
    }
    
    private function mimeDecode($str = '')
    {
        $encode_array = isset($str) ? imap_mime_header_decode($str) : [];
        $decoded      = '';
        foreach ($encode_array as $part) {
            $decoded .= $part->text;
        }
        
        return $decoded;
    }   
}

使い方

設定

設定ファイル（config/web.php）に作成したMailFetcherコンポーネントを次のように追加します。

    'components' => [
        'mailFetcher' => [
            'class' => 'app\components\MailFetcherComponent',
            'kind' => 'IMAP',
            'host' => 'メールサーバホスト名',  // IMAPサーバーのホスト名
            'username' => 'アカウントユーザー名',
            'password' => 'パスワード',
            'port' => 'ポート',
            'encryption' => '暗号化タイプ',
            'mailboxFolder' => 'INBOX',  // デフォルトでINBOXを使用
        ],

上記の設定でコンポーネントをコントローラー上で実行できるようになります。

Yii::$app->mailFetcher;

実行例

InboxController

InboxControllerを次のように作成します。

<?php

namespace app\controllers;

use Yii;
use app\models\Account;

class InboxController extends \yii\web\Controller
{
    public function actionIndex()
    {
        $receiver= Yii::$app->mailFetcher;
        
        $receiver->connectOpen();
        
        return $this->render('index', [
            'receiver' => $receiver->fetchMails('ALL'),
        ]);
    }
}

Viewファイル

/views/inbox/index.phpを次にように編集します。

<?php
/** @var yii\web\View $this */
?>
<h1>inbox/index</h1>

<p>
    You may change the content of this page by modifying
    the file <code><?= __FILE__; ?></code>.
</p>
<h2>Receiver Result</h2>

<?php foreach($receiver as $email): ?>

<div style="padding:1em;margin-bottom:3em;border:solid 3px #999;">
    <dl>
        <dt>Date</dt>
        <dd><?php echo $email['Date'] ?></dd>
        <dt>From</dt>
        <dd><?php echo $email['From'] ?></dd>
        <dt>Subject</dt>
        <dd><?php echo $email['Subject'] ?></dd>
        <dt>Message</dt>
        <dd><?php echo nl2br($email['Message']) ?></dd>
    </dl>
</div>
<?php endforeach; ?>

ブラウザで確認

次のURLへアクセスして確認します。

http://ホスト名/index.php?r=inbox/index

メールの受信ボックス情報が確認できれば成功です。

実際、私が.env導入に踏み切ったのは、ローカル・ステージング・本番と複数環境を使い分けるプロジェクトで、ちょっとした設定ミスで本番DBに接続してしまい、ヒヤッとしたことがきっかけでした。

「これはマズイ、何とかしないと…」

Laravelではおなじみの.env。CI3でも使えたら便利だなと思い、試行錯誤の末、無事導入しました。その方法を、同じ悩みを抱える皆さんと共有したいと思います。

.envファイルとは？

.envファイルは、アプリケーションの設定値を”環境変数”として定義・管理するためのファイルです。データベース接続情報やAPIキー、アプリの動作モードなどを、この1つのファイルで切り替え可能にします。

CI3では標準サポートされていませんが、PHPのvlucas/phpdotenvライブラリを活用すれば、簡単に導入できます。

導入で何が変わるのか？

• 設定ミスが減る
  本番・開発で設定を間違えて大惨事…を防げる！
• セキュリティ向上
  APIキーやDBパスワードをコードに直書きしない。
• メンテナンス楽々
  環境追加や設定変更が超簡単。

導入手順

.envファイルを作成

プロジェクトのルートに.envを作ります

CI_ENV=development
DB_HOST=localhost
DB_USER=root
DB_PASS=secret
DB_NAME=ci_project

.gitignoreに追加

.env

phpdotenvをインストール

composer require vlucas/phpdotenv

index.phpを編集

require __DIR__ . '/../vendor/autoload.php';
$dotenv = Dotenv\Dotenv::createImmutable(__DIR__ . '/../');
$dotenv->load();

設定ファイルでgetenv()を使う

application/config/database.phpなどで

'hostname' => getenv('DB_HOST'),
'username' => getenv('DB_USER'),
'password' => getenv('DB_PASS'),
'database' => getenv('DB_NAME'),

導入後の変化と感想

.envを導入してから、環境切り替え時のストレスが一気に減りました。何より、「本番に接続してしまった…！」という冷や汗から解放されたのは大きいです。CI3を使い続けるなら、ぜひ導入をおすすめします！

GitHub - vlucas/phpdotenv: Loads environment variables from `.env` to `getenv()`, `$_ENV` and `$_SERVER` automagically.

Loads environment variables from `.env` to `getenv()`, `$_ENV` and `$_SERVER` automagically. - vlucas/phpdotenv

github.com