runner-selection

ランナーの選択（Symfony）

使用するタイミング

• セッションで最初の PHP、コンソール、composer、またはテストコマンドを実行する前。
• コンテナーにある PHP、拡張機能、またはデータベースが見つからず、コマンドが失敗したとき。
• プロジェクトで Docker Compose、Symfony Docker（FrankenPHP）、DDEV、またはホストを使用していて、適切なプレフィックスが不明なとき。
• コンテナーが停止している可能性があり、コマンドがホスト上で気付かないうちに実行されてはならないとき。

デフォルトのワークフロー

1. ライブラリのランタイムコンテキスト CLI を --format=markdown（スクリプトの場合は --format=env）で実行します。
2. 検出された Docker の種類（ddev、symfony-docker、Compose ファイル、または none）と、コンテナーが実行中かどうかを確認します。
3. docker compose exec php bin/console など、出力されたプレフィックス付きのコンソール、composer、テストコマンドを使用します。
4. コンテナーが停止している場合は、出力された案内に従って（ddev start または docker compose up -d）起動し、もう一度実行します。
5. セッション中のすべてのコマンドで同じプレフィックスを再利用します。

ガードレール

• プロジェクトがコンテナーを前提としている場合、ホストの php や composer は実行しないでください。
• Compose サービス名を推測しないでください。検出されたコマンドから取得します。
• Symfony アプリケーションがない場合、CLI は何も出力しません。実行環境を作り上げず、その旨を伝えてください。
• タスクに不要なコンテナーを起動または停止しないでください。

段階的な開示

• 実行時の方針とリスク管理には、このファイルを使用します。
• 実装の詳細が必要な場合は、リファレンスを開きます。

出力の要件

• 検出された環境（Docker の種類、実行状態、テストフレームワーク）。
• このセッションで使用する、プレフィックス付きのコンソール、composer、テストコマンド。

リファレンス