# Symfony 8の新機能を徹底解説：PHP 8.4レイジーオブジェクト、マルチステップフォーム、面接対策まで

> Symfony 8はPHP 8.4を必須とし、ネイティブレイジーオブジェクト、AbstractFlowType、呼び出し可能コマンドなど多数の新機能を搭載しています。本記事では主要機能をコード例とともに解説し、2026年の面接対策ポイントも紹介します。

- Published: 2026-04-19
- Updated: 2026-04-19
- Author: SharpSkill
- Tags: symfony, php, symfony-8, php-84, lazy-objects
- Reading time: 12 min

---

2025年11月にリリースされたSymfony 8は、Symfony 7.xサイクルで蓄積された非推奨機能をすべて削除し、PHP 8.4以上を必須要件としています。この要件により、ネイティブレイジーオブジェクト、プロパティフック、新しいHTML5パーサーといったPHP言語レベルの機能がフレームワーク内部で直接活用されるようになりました。本記事では、日常の開発ワークフローに影響を与える主要機能、面接準備に役立つポイント、そして本番環境へのアップグレード時に注意すべき点を詳しく解説します。

> **Symfony 8の概要**
>
> Symfony 8.0はPHP 8.4以上を必須とし、ネイティブマルチステップフォーム（`AbstractFlowType`）、`#[Argument]`・`#[Option]`属性による呼び出し可能コンソールコマンド、3つの新しいJSON/ObjectMapperコンポーネントを搭載しています。さらに、DIコンテナとDoctrineの両方でプロキシコード生成がPHP 8.4ネイティブレイジーオブジェクトに置き換えられました。

## ネイティブレイジーオブジェクトがプロキシコード生成を置き換える

PHP 8.4では、`ReflectionClass::newLazyGhost()`と`ReflectionClass::newLazyProxy()`を通じて、エンジンレベルでレイジーオブジェクトが導入されました。Symfony 8はこの機能を直接活用しており、DependencyInjectionコンポーネントはレイジーサービス用のプロキシクラスを生成しなくなりました。代わりに、最初のプロパティアクセス時に初期化されるゴーストオブジェクトが作成されます。

この変更の実用的な影響は大きいです。これまでSymfonyのプロキシベースのレイジーローディングと互換性がなかった`final`クラスや`readonly`クラスが、回避策なしで動作するようになりました。Doctrineも同様に恩恵を受けており、エンティティプロキシのコード生成が不要になり、10年以上続いたメンテナンス負担が解消されました。

```php
// src/Service/HeavyReportGenerator.php
namespace App\Service;

use Symfony\Component\DependencyInjection\Attribute\Lazy;

#[Lazy]
final readonly class HeavyReportGenerator
{
    public function __construct(
        private DatabaseConnection $db,
        private PdfEngine $pdf,
        private CacheInterface $cache,
    ) {
        // Constructor runs only when a method is actually called
    }

    public function generate(int $reportId): string
    {
        $data = $this->db->fetchReport($reportId);
        return $this->pdf->render($data);
    }
}
```

`#[Lazy]`属性はサービスをゴーストオブジェクトとしてインスタンス化するようマークします。コンテナは`HeavyReportGenerator`と外見上同一のシェルを注入します。コンストラクタと3つの注入された依存関係は、`generate()`が呼び出されたときにのみ実行されます。条件的に使用されるサービス（特定の管理者操作でのみトリガーされるレポート生成など）では、リクエストごとの不要なデータベース接続やメモリ割り当てが排除されます。

`#[Autowire(lazy: true)]`バリアントを使用すると、サービスクラス自体を変更せずに、呼び出し側でレイジーインジェクションが可能になります。

```php
// src/Controller/DashboardController.php
namespace App\Controller;

use Symfony\Component\DependencyInjection\Attribute\Autowire;

class DashboardController
{
    public function __construct(
        #[Autowire(lazy: true)]
        private HeavyReportGenerator $reportGenerator,
    ) {}
}
```

面接の場面では、ゴーストオブジェクトとバーチャルプロキシの違いに関する質問が想定されます。ゴーストオブジェクトは元のインスタンスをその場で初期化します。バーチャルプロキシは、完全に初期化された別のインスタンスに処理を委譲します。Symfonyはデフォルトでゴーストを使用しますが、ファクトリが関与する場合は自動的にプロキシに切り替わります。

## AbstractFlowTypeによるマルチステップフォーム

Symfony 8以前は、マルチステップフォームの実装にCraueFormFlowBundleなどのサードパーティバンドルが必要でした。フレームワークは現在、`AbstractFlowType`を提供しています。これは、ステップごとのバリデーション、条件分岐、組み込みナビゲーションを備えたネイティブのフォームフローエンジンです。

```php
// src/Form/UserSignUpType.php
namespace App\Form;

use Symfony\Component\Form\Flow\AbstractFlowType;
use Symfony\Component\Form\Flow\FormFlowBuilderInterface;
use Symfony\Component\OptionsResolver\OptionsResolver;

class UserSignUpType extends AbstractFlowType
{
    public function buildFormFlow(FormFlowBuilderInterface $builder, array $options): void
    {
        $builder->addStep('personal', UserPersonalType::class);
        $builder->addStep('professional', UserProfessionalType::class);
        $builder->addStep('account', UserAccountType::class);

        $builder->add('navigator', NavigatorFlowType::class);
    }

    public function configureOptions(OptionsResolver $resolver): void
    {
        $resolver->setDefaults([
            'data_class' => UserSignUp::class,
            'step_property_path' => 'currentStep',
        ]);
    }
}
```

各ステップ名はバリデーショングループとしても機能します。`UserSignUp`データクラスは、アクティブなステップのみを検証するために、グループ制約付きの`#[Valid]`を使用します。

```php
// src/DTO/UserSignUp.php
namespace App\DTO;

use Symfony\Component\Validator\Constraints as Assert;

class UserSignUp
{
    public function __construct(
        #[Assert\Valid(groups: ['personal'])]
        public Personal $personal = new Personal(),

        #[Assert\Valid(groups: ['professional'])]
        public Professional $professional = new Professional(),

        #[Assert\Valid(groups: ['account'])]
        public Account $account = new Account(),

        public string $currentStep = 'personal',
    ) {}
}
```

コントローラは標準的なSymfonyのフォーム処理パターンに従います。`isFinished()`は最終ステップのバリデーションが通過した後にのみ`true`を返します。

```php
// src/Controller/SignUpController.php
#[Route('/signup')]
public function __invoke(Request $request): Response
{
    $flow = $this->createForm(UserSignUpType::class, new UserSignUp())
        ->handleRequest($request);

    if ($flow->isSubmitted() && $flow->isValid() && $flow->isFinished()) {
        $this->userService->register($flow->getData());
        return $this->redirectToRoute('app_signup_success');
    }

    return $this->render('signup/flow.html.twig', [
        'form' => $flow->getStepForm(),
    ]);
}
```

ナビゲーションボタン（`NextFlowType`、`PreviousFlowType`、`FinishFlowType`、`ResetFlowType`）は、`include_if`による条件付きレンダリング、`skip`によるステップスキップ、`back_to`による直接ナビゲーションをサポートしています。カスタムJavaScriptの状態管理なしで、実務のほとんどのウィザードパターンに対応できます。

## 入力属性による呼び出し可能コマンド

コンソールコマンドでは、もはや`Command`基底クラスの継承や`configure()`のオーバーライドは不要です。`__invoke()`メソッドがPHP属性を通じて引数やオプションを直接受け取ります。

```php
// src/Command/CreateUserCommand.php
namespace App\Command;

use Symfony\Component\Console\Attribute\AsCommand;
use Symfony\Component\Console\Attribute\Argument;
use Symfony\Component\Console\Attribute\Option;
use Symfony\Component\Console\Command\Command;
use Symfony\Component\Console\Style\SymfonyStyle;

#[AsCommand(
    name: 'app:create-user',
    description: 'Create a new user account',
)]
class CreateUserCommand
{
    public function __invoke(
        SymfonyStyle $io,
        #[Argument(description: 'The username for the new account')]
        string $username,
        #[Argument(description: 'The email address')]
        string $email,
        #[Option(shortcut: 'r', description: 'Role to assign')]
        string $role = 'ROLE_USER',
        #[Option(description: 'Activate immediately')]
        bool $activate = false,
    ): int {
        // User creation logic
        $io->success(sprintf('User "%s" created with role %s.', $username, $role));
        return Command::SUCCESS;
    }
}
```

Symfony 8ではBacked Enumが引数やオプションでサポートされています。文字列入力は自動的に対応するEnumケースに変換されます。

```php
// src/Enum/CloudRegion.php
enum CloudRegion: string {
    case UsEast = 'us-east';
    case UsWest = 'us-west';
    case EuWest = 'eu-west';
}

// In the command
public function __invoke(
    SymfonyStyle $io,
    #[Argument] CloudRegion $region,
    #[Option] ?ServerSize $size = null,
): int {
    $io->info(sprintf('Deploying to %s', $region->value));
    return Command::SUCCESS;
}
```

パラメータが多いコマンドでは、`#[MapInput]`を使用して入力をDTOにマッピングできます。

```php
// src/Command/Input/DeployInput.php
class DeployInput
{
    #[Argument]
    public CloudRegion $region;

    #[Option]
    public string $branch = 'main';

    #[Option(shortcut: 'f')]
    public bool $force = false;
}

// src/Command/DeployCommand.php
#[AsCommand(name: 'app:deploy')]
class DeployCommand
{
    public function __invoke(
        SymfonyStyle $io,
        #[MapInput] DeployInput $input,
    ): int {
        // Access $input->region, $input->branch, $input->force
        return Command::SUCCESS;
    }
}
```

このパターンにより、`configure()` + `execute()`の定型コードが不要になり、DTOを直接構築することでコマンドのテストが容易になります。

## JsonStreamer、JsonPath、ObjectMapperコンポーネント

Symfony 8では3つの新しいスタンドアロンコンポーネントが提供されています。

**JsonStreamer**は、ドキュメント全体をメモリに読み込むことなく、大規模なJSONペイロードを処理します。メガバイト規模のレスポンスを扱うAPI（バルクデータエクスポート、アナリティクスフィード、ログ取り込みなど）では、`json_decode()`のメモリ上限の問題を回避できます。

**JsonPath**は、ネストされたJSON構造をナビゲートするためのRFC 9535のサブセットを実装しています。レスポンス全体をデコードして配列を手動で走査する代わりに、パス式でターゲットデータを直接抽出できます。

**ObjectMapper**は、PHP属性を使用してDTOと配列/JSON間の変換を行い、手書きのハイドレーションロジックを置き換えます。Serializerコンポーネントと組み合わせることで、APIリクエスト/レスポンスマッピングのライフサイクル全体をカバーします。

> **面接での出題傾向**
>
> 2026年のSymfony面接では、レイジーオブジェクト（ゴースト vs プロキシ）、`AbstractFlowType`のライフサイクル、`configure()`から呼び出し可能コマンドへの移行が頻出トピックとなっています。これらのパターンを理解していることは、レガシーの知識だけでなく、現行フレームワークバージョンへの精通を示すものです。

## セキュリティとDXの改善点

CSRF保護がサーバーサイドセッションを必要としなくなりました。新しいステートレスCSRF実装はHTTPキャッシュと連携し、APIファーストアーキテクチャやCDNキャッシュページでの利用が実現可能になりました。

Messengerコンポーネントは**メッセージ署名**をサポートしています。ペイロードへの暗号署名により、プロデューサーとコンシューマー間の改ざんを防止します。メッセージの完全性が重要なシステム（決済処理、監査証跡など）では、カスタム署名ミドルウェアを置き換えることができます。

新しいバリデーション制約は、文字セット、MACアドレス、ISO週番号、ワードカウント、YAML構文、スラッグ、Twigテンプレート、動画ファイルなどに対応しています。`#[Slug]`制約だけでも、よく使われるカスタムバリデータを排除できます。

セキュリティ投票者がプロファイラで**判断の理由を説明**するようになりました。認可ロジックのデバッグ（どの投票者がアクセスを拒否したかを推測するプロセス）が、Symfonyプロファイラツールバーでの直接確認に変わりました。

> **アップグレードパス**
>
> Symfony 8.0は7.xサイクルのすべての非推奨機能を削除し、13,202行の後方互換性コードを除去しています。推奨アプローチは、まずSymfony 7.4にアップグレードし、`php bin/phpunit --display-deprecations`を実行してすべての警告を修正した後、8.0に切り替えることです。7.4をスキップすると、削除されたAPIによるランタイムエラーのリスクがあります。

## PHP 8.4プロパティフックとSymfonyでの活用

プロパティフック（クラスプロパティに直接定義される`get`と`set`）は、Symfonyのエコシステムと自然に統合されます。Doctrineエンティティは計算プロパティにフックを使用できます。フォームタイプはデータ変換にフックを活用できます。バリデーション制約はフック付きプロパティに対して修正なしで動作します。

```php
// src/Entity/Product.php
class Product
{
    public string $name {
        set(string $value) {
            $this->name = trim($value);
        }
    }

    public float $price {
        set(float $value) {
            if ($value < 0) {
                throw new \InvalidArgumentException('Price cannot be negative');
            }
            $this->price = $value;
        }
    }

    public float $priceWithTax {
        get => $this->price * 1.20;
    }
}
```

プロパティフックにより、getter/setterペアの必要性が減り、不変条件の適用がプロパティ定義内に移動します。Symfonyフォームでは、トランスフォーマーのボイラープレートが削減されます。Doctrineエンティティでは、計算値が依存するデータの近くに配置されます。

## 面接で準備すべき質問

Symfony 8により、面接で問われる内容が変化しています。以下のトピックが[Symfony面接対策](/technologies/symfony/interview-questions/architecture-patterns)で頻繁に出題されています。

- **レイジーオブジェクト**: ゴーストオブジェクトとバーチャルプロキシの違いを説明できるか。Symfonyはどのような場合にどちらを選択するか。なぜPHP 8.4で`final readonly`サービスのレイジーロードが可能になったか。
- **マルチステップフォーム**: `AbstractFlowType`はステップごとのバリデーションをどのように処理するか。`step_property_path`の役割は何か。条件付きステップはどのように動作するか。
- **呼び出し可能コマンド**: 呼び出し可能コマンドで`configure()`を置き換えるものは何か。`#[MapInput]`はどのように動作するか。`#[Option]`のデフォルト値のルールは何か。
- **新コンポーネント**: JsonStreamerが`json_decode()`より好まれるのはどのような場合か。ObjectMapperがSerializerでは解決できないどのような問題を解決するか。
- **アップグレード戦略**: 8.0の前に7.4へのアップグレードが推奨される理由は何か。13,202行の非推奨コード削除は後方互換性にとって何を意味するか。

これらのトピックは実際のコードで練習することが重要です。[Symfonyコンソールコマンドモジュール](/technologies/symfony/interview-questions/console-commands)と[Doctrine応用モジュール](/technologies/symfony/interview-questions/doctrine-advanced)が、最も頻繁にテストされる分野をカバーしています。

## まとめ

- Symfony 8はPHP 8.4を必須とし、ネイティブレイジーオブジェクトを完全に採用。DIコンテナとDoctrine ORMの両方でプロキシコード生成が不要に
- `AbstractFlowType`がマルチステップフォーム用のサードパーティバンドルを置き換え、ステップごとのバリデーショングループと組み込みナビゲーションボタンを提供
- `#[Argument]`、`#[Option]`、`#[MapInput]`による呼び出し可能コマンドがボイラープレートを排除し、Backed EnumとDTOをサポート
- 3つの新コンポーネント（JsonStreamer、JsonPath、ObjectMapper）が外部依存なしでJSON処理とオブジェクトマッピングに対応
- ステートレスCSRF、メッセージ署名、セキュリティ投票者デバッグ、20以上の新しいバリデーション制約がセキュリティとDXを強化
- PHP 8.4のプロパティフックがDoctrineエンティティ、Symfonyフォーム、バリデーション制約と透過的に統合
- アップグレードパスはSymfony 7.4を経由：8.0に切り替える前にすべての非推奨警告を修正すること

---

Source: SharpSkill (https://sharpskill.dev), tech interview preparation for your real stack.
HTML version of this page: https://sharpskill.dev/ja/blog/symfony/symfony-8-new-features-php-84-lazy-objects