この記事では、PHP 5でよく使われた書き方とPHP 8.2の書き方を、同じ処理ごとに並べて比較します。最新構文を暗記するのではなく、「新しい一行は、昔のどの処理を短くしたものなのか」を理解することが目的です。

最初に結論：難しく見える原因は3つ

1. 変数や引数、戻り値に型を書くようになった
2. 長い処理を一行にまとめる省略構文が増えた
3. 手続き型中心から、クラス、Composer、依存性注入を使う設計へ移った

PHP 8.2がPHP 5より本質的に難解になったというより、以前はコメントや開発者の頭の中にあった決まりを、コード上へ明示するようになったと考えると理解しやすくなります。

比較1：関数の引数と戻り値

PHP 5でよくある書き方

function add($a, $b)
{
    return $a + $b;
}

短くて分かりやすい反面、整数、文字列、nullなど、どの値を渡す前提なのかは関数の中身を読むまで分かりません。

PHP 8.2の書き方

function add(int $a, int $b): int
{
    return $a + $b;
}

int $aとint $bは「整数を受け取る」、最後の: intは「整数を返す」という意味です。型は処理ではなく、この関数の入力と出力を説明する仕様書です。

function findUser(int $id): Userなら、「整数のIDを渡すとUserオブジェクトが返る関数」と日本語へ置き換えて読めば十分です。

比較2：nullを許可する型と複数の型

function findUser(int $id): ?User
{
    // 見つかればUser、見つからなければnull
}

?Userは「Userまたはnull」です。次のUser|nullと同じ意味になります。

function findUser(int $id): User|null
{
}

|は「または」と読みます。例えばint|stringなら「整数または文字列」、User|falseなら「Userまたはfalse」です。複雑な記号として覚えるより、日本語へ機械的に置き換えるのが近道です。

比較3：値が存在しない場合の処理

PHP 5の書き方

if (isset($_POST['name'])) {
    $name = $_POST['name'];
} else {
    $name = '';
}

PHP 8.2でよく使う書き方

$name = $_POST['name'] ?? '';

??は「左側に値があれば使い、なければ右側を使う」という意味です。PHP 7で導入された構文ですが、PHP 8系のコードでは日常的に登場します。短いコードが読みにくい場合は、頭の中で元のif文に戻してみましょう。

比較4：null安全演算子 ?->

従来の書き方

$user = getUser();

if ($user !== null) {
    $company = $user->getCompany();

    if ($company !== null) {
        $name = $company->getName();
    } else {
        $name = null;
    }
} else {
    $name = null;
}

PHP 8.2の書き方

$name = getUser()?->getCompany()?->getName();

?->は「左側がnullなら、その先を実行せずnullにする」という記号です。上の一行は、Userが存在するか、Companyが存在するかを順番に確認しています。

さらに次のように書かれていれば、「名前を取得できなければ名称未設定を使う」と読めます。

$name = getUser()?->getCompany()?->getName() ?? '名称未設定';

比較5：クラスのプロパティとコンストラクタ

PHP 5の書き方

class User
{
    private $name;
    private $email;

    public function __construct($name, $email)
    {
        $this->name = $name;
        $this->email = $email;
    }
}

PHP 8.2の書き方

class User
{
    public function __construct(
        private string $name,
        private string $email
    ) {
    }
}

PHP 8のコンストラクタ・プロパティ・プロモーションでは、プロパティの宣言、コンストラクタ引数、プロパティへの代入を一か所にまとめられます。

private string $nameを見たら、「文字列型のprivateプロパティを作り、コンストラクタで受け取った値を保存する」と展開します。コード量は減りますが、裏側で行われる処理はPHP 5の例とほぼ同じです。

比較6：readonlyで変更を禁止する

class User
{
    public function __construct(
        public readonly int $id,
        public readonly string $name
    ) {
    }
}

readonlyは、最初に設定した値を後から変更できないようにします。

$user = new User(1, '田中');
$user->id = 2; // エラー

PHP 5では、変更してはいけない値も運用上の約束で守ることがありました。PHP 8.2では、その約束を言語側で強制できます。つまり、readonlyは難しい処理ではなく「作成後は変更禁止」という注意書きです。

比較7：switchとmatch

PHP 5のswitch

switch ($status) {
    case 1:
        $message = '受付中';
        break;

    case 2:
        $message = '完了';
        break;

    default:
        $message = '不明';
        break;
}

PHP 8.2のmatch

$message = match ($status) {
    1 => '受付中',
    2 => '完了',
    default => '不明',
};

matchは「値を返すswitch」と考えると理解できます。$statusが1なら「受付中」、2なら「完了」、それ以外なら「不明」を$messageへ代入しています。breakが不要で、比較も厳密です。

比較8：無名関数とアロー関数

従来の無名関数

$prices = array_map(function ($price) {
    return $price * 1.1;
}, $items);

アロー関数

$prices = array_map(
    fn($price) => $price * 1.1,
    $items
);

fn($price) => $price * 1.1は、「$priceを受け取り、$price × 1.1を返す短い関数」です。複数行の処理には通常の無名関数を使ったほうが読みやすくなります。新構文を使うこと自体が目的ではありません。

比較9：文字列や数値で表していた状態をEnumにする

PHP 5でよくある状態管理

$status = 'paid';

if ($status === 'paid') {
    // 支払済みの処理
}

単純ですが、padiのようにスペルを間違えても、ただの文字列として成立してしまいます。

PHP 8.2のEnum

enum PaymentStatus: string
{
    case Pending = 'pending';
    case Paid = 'paid';
    case Cancelled = 'cancelled';
}

$status = PaymentStatus::Paid;

Enumは、「指定された候補以外を入れられない値」です。難しいオブジェクトとして捉えず、入力可能な選択肢を先に決めたものと理解するとよいでしょう。

比較10：コメントから属性 #[…] へ

コメントで設定を書く例

/**
 * @Route("/users", methods={"GET"})
 */
public function index()
{
}

PHP 8の属性

#[Route('/users', methods: ['GET'])]
public function index(): Response
{
}

#[...]は属性（Attribute）です。クラスやメソッドへ、フレームワークなどが読み取れる追加情報を付けます。上の例では「/usersへのGETアクセスをこのメソッドで処理する」という設定です。

属性を見たら、まず「ここは通常の処理本体ではなく、付加設定である」と切り離しましょう。その属性が何をするかはPHP共通ではなく、LaravelやSymfonyなど利用している仕組みによって変わる場合があります。

比較11：requireとComposer・名前空間

PHP 5でよくある書き方

require_once 'UserRepository.php';

$repository = new UserRepository();

現在よく見る書き方

namespace App\Service;

use App\Repository\UserRepository;

$repository = new UserRepository();

namespaceはクラスの所属先を表し、同名クラスの衝突を防ぎます。use App\Repository\UserRepository;は、その長いクラス名を、このファイル内ではUserRepositoryという短い名前で使う宣言です。

実際のファイル読み込みはComposerのオートローダーが担当することが一般的です。最初はnamespaceとuseを処理本体から外し、「クラス名の住所と略称」として読んでも問題ありません。

比較12：クラス内で部品を作るか、外から渡すか

PHP 5時代に多かった形

class UserController
{
    public function show($id)
    {
        $repository = new UserRepository();
        $logger = new Logger();

        $logger->info('ユーザーを取得します');

        return $repository->find($id);
    }
}

現代的な依存性注入

class UserController
{
    public function __construct(
        private UserRepository $repository,
        private LoggerInterface $logger
    ) {
    }

    public function show(int $id): ?User
    {
        $this->logger->info('ユーザーを取得します');

        return $this->repository->find($id);
    }
}

後者では、必要なRepositoryやLoggerをクラス内で直接作らず、外から渡してもらいます。これが依存性注入です。用語は難しく聞こえますが、「このクラスで使用する道具を外から受け取る」と考えれば十分です。

部品を交換しやすく、テストもしやすくなるため、現在のフレームワークで広く使われています。PHP 8.2の文法というより、現代的な設計方法の違いが、コードを別物に見せている大きな原因です。

PHP 8.2では宣言していないプロパティが問題になる

PHP 5では動いていた書き方

class User
{
}

$user = new User();
$user->name = '田中';

このように、クラスで宣言していないプロパティを後から追加する方法を動的プロパティと呼びます。PHP 8.2では原則として非推奨です。

PHP 8.2で明示する

class User
{
    public string $name;
}

$user = new User();
$user->name = '田中';

宣言が必要になったのは、例えば$user->nmaeというスペルミスを新しいプロパティとして見逃さないためです。面倒が増えたように見えますが、不具合を早い段階で発見するための変更です。

PHP 8.2のコードを読む実践手順

1．記号を日本語に置き換える

2．短い一行を昔のif文へ戻す

$name = $user?->getProfile()?->getName() ?? '名称未設定';

これを見て分からなければ、Userがnullか、Profileがnullか、名前がnullかを一つずつ確認するif文へ書き戻します。何度か展開すると、短い構文のまま処理を追えるようになります。

3．PHPの文法とフレームワークの機能を分ける

• PHPそのものの文法か
• LaravelやSymfonyなどの機能か
• Composerで入れたライブラリの機能か
• そのシステム独自のクラスか

例えば#[Route(...)]の#[...]はPHPの構文ですが、Routeの具体的な動作はフレームワーク側の機能です。この切り分けができると、何を調べればよいかが明確になります。

おすすめの学習順序

最初に覚えるもの

1. 引数と戻り値の型
2. ?、|、null
3. ??と?->
4. クラスのプロパティ型
5. コンストラクタの短縮記法
6. namespaceとuse

次に覚えるもの

• Composerと自動読み込み
• 例外処理
• 依存性注入
• match
• アロー関数
• Enum

Attributes、Intersection Type、Fibers、Reflectionなどは、必要になってから学べば十分です。通常のWebシステムを読むために、PHP 8.2の全機能を最初から覚える必要はありません。

最新構文を全部使うことが良いコードではない

PHP 8.2でも、次のような素直なコードは有効です。

function getDisplayName(?User $user): string
{
    if ($user === null) {
        return 'ゲスト';
    }

    $name = $user->getName();

    if ($name === '') {
        return '名称未設定';
    }

    return $name;
}

型は明示しながらも、処理の流れは上から順番に追えます。一行へ詰め込んで読みにくくするより、適切に改行し、処理を分けるほうが保守しやすいコードになります。

• 型は積極的に付ける
• 省略して分かりにくくなるなら省略しない
• 一行に複数の判断を詰め込まない
• 目的のない高度な設計パターンを導入しない
• コメントより分かりやすい関数名と変数名を優先する

PHP 5からPHP 8.2へ移行するときの注意

書き方を新しくすることと、既存プログラムをPHP 8.2で動作させることは別の作業です。古いプログラムでは、削除された関数、引数や戻り値の扱い、警告からエラーへ変わった処理、動的プロパティ、古いライブラリなども確認する必要があります。

いきなり全面的に書き直すより、まずPHP 8.2でエラーや非推奨警告を確認し、動作を維持したまま問題を解消します。その後、型宣言やクラス設計を少しずつ追加するほうが安全です。

まとめ

PHP 5は、処理を順番に書き、値の解釈をPHPへ任せる柔軟な言語でした。PHP 8.2は、どの値を受け取り、何を返し、何を変更できるのかをコード上で明確にする方向へ進んでいます。

最新のコードに慣れる一番の方法は、構文を丸暗記することではありません。「この短い一行をPHP 5風に書くとどうなるか」と展開してみることです。型は説明書、?はnullの可能性、??は代替値、?->はnullなら停止、と日本語へ置き換えるだけでも、読める範囲は大きく広がります。

そして何より、PHP 8.2を使うからといって、すべてを短く、複雑に書く必要はありません。新しいPHPの安全性を活かしながら、処理の流れが追いやすい書き方を選ぶことが、実務では最も重要です。

参考資料

• PHP 8.0.xの新機能（PHP公式マニュアル）
• PHP 8.1.xの新機能（PHP公式マニュアル）
• PHP 8.2.xの新機能（PHP公式マニュアル）
• 型宣言（PHP公式マニュアル）

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

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

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

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のキャッシュ/セキュリティヘッダ の調整などを行うと、より快適で安全な環境になります。

１．必要な環境の準備

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

ここではLinux環境へCodeIgniter3のフレームワークをセットアップする方法について説明します。

またドキュメントルートは

/var/www/html/codeigniter3/public

とし、ホスト名はwww.example.comとします。

フレームワークの取得・設置

サーバへターミナル等でログイン後、次のコマンドでディレクトリ移動します。

# cd /var/www/html/

　次のダウンロードサイトからCodeIgniter v3.2.0-dev (Current version)のリンクURLを取得します。

CodeIgniter のダウンロード — CodeIgniter 3.2.0-dev ドキュメント

codeigniter.jp

次のようにURLを指定してコマンドを実行します。

# wget https://codeload.github.com/bcit-ci/CodeIgniter/zip/develop

コマンド実行後developというファイルが取得されますが、このファイル名では何のファイルが不明なので次のように名前変更します。

# mv develop develop.zip

次にこのファイルを解凍します。

# unzip develop.zip

解凍後、CodeIgniter-developのファイルの存在が確認できますが更に次のコマンドで名前変更します。

# mv CodeIgniter-develop codeigniter3

ファイル構造の変更

Codeigniter3内のファイル構造は次の通りです。

/var/www/html
└ codeigniter3
　├application(ディレクトリ)
　├build-release.sh
　├composer.json
　├contributing.md
　├DCO.txt
　├.editorconfig
　├.github(ディレクトリ)
　├.gitignore
　├index.php
　├license.txt
　├readme.rst
　├system(ディレクトリ)
　└tests(ディレクトリ)

上記構造のうちドキュメントルートに設置する予定のindex.phpを起点とするとsystemディレクトリとapplicationディレクトリは公開する必要のないディレクトリになりキー情報やこの後設定するデータベースの接続情報など、外部に漏れてはいけない状況がドキュメントルート配下に配置環境の為、セキュアではありません。

尚、systemディレクトリやapplicationディレクトリ内のファイルは全て

<?php
defined('BASEPATH') OR exit('No direct script access allowed');

のように定数によるアクセス制限を掛けている為、直接アクセスする事はできない意味では安全ですが、これはPHPが正常に動作した場合に限り安全というには根本的な対策にはなっていません。

この対策としてsystemディレクトリとapplicationディレクトリをドキュメントルート配下でなない上位ディレクトリへ設置するように変更します。

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

# mkdir public

publicディレクトリを作成します。

mv index.php ./public/

index.phpをpublicディレクトリ内へ移動します。

ディレクトリ設定の変更

index.phpを次のように変更します。

        // 93行目付近
	$system_path = '../system'; 

        // 110行目付近
	$application_folder = '../application';

上記の更新にてドキュメントルート配下からその上位ディレクトリへの変更が完了となります。

設定ファイルの変更

ホスト名の指定など次のファイルを編集します。

application/config/config.php

設定内容は次のようにキー名と値の構成になります。

$config[キー名] = '値’

次の表は初期設定の際に必要となる主要な設定情報の一覧になります。

データベースの設定

以下のファイルを編集しデータベースMySQLの接続情報を設定します。

application/config/database.php

$db['default'] = array(
	'dsn'	=> '',
	'hostname' => 'ホスト名',
	'username' => 'DBユーザー名',
	'password' => 'パスワード',
	'database' => 'データ',
	'dbdriver' => 'mysqli',
	'dbprefix' => '',
	'pconnect' => FALSE,
	'db_debug' => (ENVIRONMENT !== 'production'),
	'cache_on' => FALSE,
	'cachedir' => '',
	'char_set' => 'utf8',
	'dbcollat' => 'utf8_general_ci',
	'swap_pre' => '',
	'encrypt' => FALSE,
	'compress' => FALSE,
	'stricton' => FALSE,
	'failover' => array(),
	'save_queries' => TRUE
);

綺麗なURLにする

例えば複数の会員情報の一覧から特定の会員IDが5番のプロフィール詳細ページは一般的に次のようになります。

http://www.example.com/index.php/profile/view/id/5

上記URLではindex.phpのインデックスファイルの後にパラメータがスラッシュ区切りで構成される為、綺麗ではないのでindex.phpを削除して綺麗にURLにする為、次のファイルを作成・編集します。

public/.htaccess

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php/$1 [L]

ライブラリ・ヘルパーの自動読み込み

常に使用するライブラリや頻繁に使用するヘルパーなどは自動読み込み設定する事でコントローラー内で都度読み込み宣言を記載する手間を省く事ができます。

次のファイルを編集します。

application/config/autoload.php

// ライブラリ自動読み込み
$autoload['libraries'] = [
  'database',
  'session',
];

// ヘルパー自動読み込み
$autoload['helper'] = [
  'url',
  'form',
];

これで環境の用意はひとまず完了です。

これ以外に必要な情報は別途ドキュメントを参照して編集してください。

CodeIgniter ユーザガイド — CodeIgniter 3.2.0-dev ドキュメント

codeigniter.jp

ソーシャルメディアログイン機能の実装にはHybridauthのライブラリを使用します。

Hybridauthライブラリのインストール

次のコマンドを実行してHybridauthライブラリをインストールします。

# composer require hybridauth/hybridauth

設定ファイルの作成

Configディレクトリ内にProvider.phpを以下の内容で作成します。

<?php
 
namespace App\Config;

use CodeIgniter\Config\BaseConfig;

class Provider extends BaseConfig
{
  public $configure = [
    // callback
    'callback' => 'https://www.example.com/auth/authenticate',
    'providers' => [
      // facebook.
      'Facebook' => [
        'enabled' => true,
        'keys' => [
          'id' => '<アプリID>',
          'secret' => '<秘密キー>',
        ],
      ],
      // twitter
      'Twitter' => [
        'enabled' => true,
        'keys' => [
          'key' => '<キー>',
          'secret' => '<秘密キー>',
        ],
      ],
    ],
  ];
}

アプリID、キー、秘密キーは各SNSのデベロッパーサイトで発行された値を指定します。

コントローラーの作成

Authコントローラーを作成します。

<?php

namespace App\Controllers;

use Hybridauth\Hybridauth;
use Hybridauth\HttpClient;

class Auth extends BaseController
{
  public function index()
  {
    return view('auth');
  } 
  
  public function authenticate($provider = false)
  {
    $userProfile = [];
    $config = new \App\Config\Provider();
    try {
      $auth = new Hybridauth($config->configure);
      $adapter = $auth->authenticate($provider);
      $tokens = $adapter->getAccessToken();
      $userProfile = $adapter->getUserProfile();
      $adapter->disconnect();
      
    } catch (\Exception $e) {
      echo $e->getMessage();
    }

    return view('result', ['userProfile' => $userProfile]);
  }

ビューの作成

ビューはログインとログイン後の画面を用意します。

auth.phpの作成

Viewsディレクトリにauth.phpを以下の内容で作成します。

<html>
<head>
<title>ソーシャルメディアログインテスト</title>

<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
</head>
<body>
<a href="<?php echo base_url('auth/authenticate/Facebook') ?>">Facebookアカウントでログイン</a><br>
<a href="<?php echo base_url('auth/authenticate/Twitter') ?>">Twitterアカウントでログイン</a>
</body>
</html>

result.phpの作成

Viewsディレクトリにresult.phpを以下の内容で作成します。

<html>
<head>
<title>ソーシャルメディアログインテスト</title>

<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
</head>
<body>
<?php var_dump($userProfile) ?>
</body>
</html>

動作確認

次のURLへアクセスしてログインできるか確認します。

https://www.example.com/auth

正常に動作していればソーシャルメディア上の登録ID、プロフィール名、サブネイル画像URLの表示が確認できます。

Hybridauth Social Login PHP Library

hybridauth.github.io

インストール

Codeigniterのインストール

次のComposerコマンドでCodeigniter3をインストールします、

# composer create-project kenjis/codeigniter-composer-installer ＜インストール先ディレクトリ名＞

Ion-Authのインストール

次のComposerコマンドでIon-Authをインストールします。

# cd ＜インストール先ディレクトリ名＞
# php bin/install.php ion-auth 2

データベースの設定

データベースのスキーマを管理する機能を追加します。

コマンド実行ファイルの作成

以下のファイルを/application/controllers/内に設置します。

Migrate.php
<?php
defined('BASEPATH') OR exit('No direct script access allowed');

class Migrate extends CI_Controller {

    function __construct()
    {   
        parent::__construct();
        if(! $this->input->is_cli_request()) {
            show_404();
            exit;
        }   
        $this->load->library('migration');
    }   

    function current()
    {   
        if ($this->migration->current()) {
            log_message('error', 'Migration Success.');
        } else {
            log_message('error', $this->migration->error_string());
        }   
    }   

    function rollback($version)
    {   
        if ($this->migration->version($version)) {
            log_message('error', 'Migration Success.');
        } else {
            log_message('error', $this->migration->error_string());
        }   
    }   

    function latest()
    {   
        if ($this->migration->latest()) {
            log_message('error', 'Migration Success.');
        } else {
            log_message('error', $this->migration->error_string());
        }   
    }

}
マイグレーションの設定
application/config/migration.phpを次のように編集します。

<?
// マイグレーションを有効化
$config['migration_enabled'] = TRUE;
// シーケンス番号で管理
$config['migration_type'] = 'sequential';

充実したライブラリと機能性の高さの割に大規模なウェブアプリケーションだけでなく小規模なウェブアプリケーションでも開発しやすいようディレクトリの構成変更が簡単にできる便利なフレームワークです。

この記事ではYii2のインストールと開発開始までの初期設定方法を説明します。

Yii2のインストール

次のcomposerコマンドでYii2をインストールします

# cd ＜インストールするディレクトリ＞
# composer create-project --prefer-dist yiisoft/yii2-app-basic ＜プロジェクト名＞

コード生成ツールGiiの許可設定

Yii2にはGUI上で次のファイルを自動生成する機能があります。

• Model Generator
  このジェネレータは、指定されたデータベーステーブルのActiveRecordクラスを生成します。
• CRUD Generator
  このジェネレータは、指定されたデータモデルのCRUD(作成、読み取り、更新、削除)操作を実装するコントローラとビューを生成します。
• Controller Generator
  このジェネレータは、1つまたは複数のコントローラアクションと対応するビューを持つ新しいコントローラクラスをすばやく生成するのに役立ちます。
• Form Generator
  このジェネレータは、指定されたモデルクラスの入力を収集するフォームを表示するビュースクリプトファイルを生成します。
• Module Generator
  このジェネレータは、Yiiモジュールに必要なスケルトンコードを生成するのに役立ちます。
• Extension Generator
  このジェネレータは、Yii拡張に必要なファイルを生成するのに役立ちます。

Giiの使用は開発環境でのみ利用できるようIP制限を掛けて特定のアクセス元IPのみ許可する必要があります。

/config/web.php

    $config['bootstrap'][] = 'gii';
    $config['modules']['gii'] = [
        'class' => 'yii\gii\Module',
        // uncomment the following to add your IP if you are not connecting from localhost.
        'allowedIPs' => ['127.0.0.1', '::1'], // ⇦コメントアウトを外しアクセス元IPを設定
    ];

デバックツールバーの許可設定

デバックツールバーもGiiと同様にアクセス元IPの許可設定をします。

/config/web.php

    $config['bootstrap'][] = 'debug';
    $config['modules']['debug'] = [
        'class' => 'yii\debug\Module',
        // uncomment the following to add your IP if you are not connecting from localhost.
        'allowedIPs' => ['127.0.0.1', '::1'], // ⇦コメントアウトを外しアクセス元IPを設定
    ];

データベース接続設定

データベースの接続設定をします。

config/db.php

return [
    'class' => 'yii\db\Connection',
    'dsn' => 'mysql:host=localhost;dbname=＜データベース名＞',
    'username' => '＜ユーザ名＞',
    'password' => '＜パスワード＞',
    'charset' => 'utf8',

以上で完了です。