// ライフサイクルを知っていれば, このようにデバッグできる:
// 1. バインディングが存在するか確認
app()->bound('payment.gateway');
// 2. どのProviderが登録したか確認
app()->getBindings()['payment.gateway']['concrete'];
// 3. ミドルウェアの実行順序をトレース
app()->make(\Illuminate\Foundation\Http\Kernel::class)->getMiddlewarePriority();

# 登録済みサービスプロバイダを確認
php artisan about --only=providers
# 一覧表示: AppServiceProvider, AuthServiceProvider 等

# ミドルウェアパイプラインを確認
php artisan route:list --columns=method,uri,middleware
# GET /dashboard → auth, tenant.resolve, verified

# コンテナ内のバインド済みサービスを確認
php artisan tinker
# app()->getBindings()
# すべての登録済みコンテナバインディングを一覧表示

# コマンド実行成功

// bootstrap/app.php — Laravel 11単一ファイル設定
return Application::configure(basePath: dirname(__DIR__))
    ->withRouting(
        web: __DIR__.'/../routes/web.php',
        api: __DIR__.'/../routes/api.php',
        commands: __DIR__.'/../routes/console.php',
        health: '/up',
    )
    ->withMiddleware(function (Middleware $middleware) {
        $middleware->appendToGuestList([
            '/api/*',
        ]);
        $middleware->alias([
            'tenant.resolve' => \App\Http\Middleware\TenantResolve::class,
        ]);
    })
    ->withExceptions(function (Exceptions $exceptions) {
        //
    })->create();

// bootstrap/app.php
->withMiddleware(function (Middleware $middleware) {
    // グローバルミドルウェアを追加 (すべてのリクエストで実行)
    $middleware->append([
        \App\Http\Middleware\SetLocale::class,
    ]);

    // デフォルトのグローバルミドルウェアを削除
    $middleware->remove([
        \Illuminate\Foundation\Http\Middleware\TrimStrings::class,
    ]);

    // ルートミドルウェアのエイリアスを登録
    $middleware->alias([
        'tenant' => \App\Http\Middleware\TenantResolve::class,
        'role' => \App\Http\Middleware\CheckRole::class,
    ]);
})

// 実行成功

// app/Providers/AppServiceProvider.php
public function register(): void
{
    // インターフェースを実装にバインド
    $this->app->bind(
        PaymentGatewayInterface::class,
        StripeGateway::class,
    );

    // クロージャでバインド (完全制御)
    $this->app->bind('analytics.service', function ($app) {
        return new AnalyticsService(
            $app->make(CacheManager::class),
            $app['config']->get('analytics.ttl'),
        );
    });

    // シングルトン — 毎回同じインスタンス
    $this->app->singleton(ShopMetricsConfig::class, function ($app) {
        return new ShopMetricsConfig(
            $app['config']->get('shopmetrics'),
        );
    });
}

// タイプヒントによる自動解決
class OrderController extends Controller
{
    public function __construct(
        private PaymentGatewayInterface $gateway, // 自動解決される
    ) {}
}

// 手動解決
$gateway = app(PaymentGatewayInterface::class);
$gateway = app()->make(PaymentGatewayInterface::class);
$analytics = resolve('analytics.service');

// app/Providers/AppServiceProvider.php
public function register(): void
{
    $this->app->bind(
        \App\Contracts\ReportGeneratorInterface::class,
        \App\Services\PdfReportGenerator::class,
    );

    $this->app->singleton(
        \App\Services\TenantManager::class,
        fn ($app) => new TenantManager(
            $app->make(\App\Models\Tenant::class),
        ),
    );

    $this->app->when(ShopController::class)
        ->needs(\App\Contracts\FileStorageInterface::class)
        ->give(\App\Services\S3StorageService::class);
}

// 実行成功

// Facadeを使用 — 簡潔
use Illuminate\Support\Facades\Cache;

public function getShopStats(int $shopId): array
{
    return Cache::remember("shop.stats.{$shopId}", 3600, function () use ($shopId) {
        return Shop::findOrFail($shopId)->getStats();
    });
}

// DIを使用 — 明示的, テストしやすい
public function __construct(
    private CacheManager $cache,
) {}

public function getShopStats(int $shopId): array
{
    return $this->cache->remember("shop.stats.{$shopId}", 3600, function () use ($shopId) {
        return Shop::findOrFail($shopId)->getStats();
    });
}

// 実行成功

リクエスト到着
  → Register段階: すべてのProviderのregister()が呼ばれる (まだbootingではない)
  → Boot段階: すべてのProviderのboot()が呼ばれる (すべてのバインディングが利用可能)
  → アプリケーション準備完了

// app/Providers/PaymentServiceProvider.php
class PaymentServiceProvider extends ServiceProvider
{
    protected bool $defer = true;

    public function register(): void
    {
        $this->app->singleton(StripeGateway::class, function ($app) {
            return new StripeGateway(config('services.stripe'));
        });
    }

    public function provides(): array
    {
        return [StripeGateway::class];
    }
}

// app/Providers/ShopMetricsServiceProvider.php
class ShopMetricsServiceProvider extends ServiceProvider
{
    public function register(): void
    {
        $this->app->bind(
            ReportGeneratorInterface::class,
            PdfReportGenerator::class,
        );

        $this->app->singleton(TenantManager::class);
    }

    public function boot(): void
    {
        // ミドルウェアエイリアスの登録
        $this->app->make(\Illuminate\Routing\Router::class)
            ->aliasMiddleware('tenant', TenantResolve::class);

        // ビューコンポーザーの登録
        View::composer('dashboard.*', NavigationComposer::class);

        // イベントリスナーの登録
        Event::listen(OrderPlaced::class, SendOrderNotification::class);
    }
}

// 実行成功

// ============================================
// 総合例: ShopMetricsリクエストのトレース
// 対象: ライフサイクル, コンテナ, Facade, Provider
// ============================================

// 1. public/index.php — エントリポイント
// $app = require_once __DIR__.'/../bootstrap/app.php';
// $app->handleRequest();

// 2. bootstrap/app.php — カーネル設定
// return Application::configure(basePath: dirname(__DIR__))
//     ->withRouting(web: ..., api: ...)
//     ->withMiddleware(fn ($m) => $m->append([SetLocale::class]))
//     ->create();

// 3. AppServiceProvider — バインディングの登録
// public function register(): void
// {
//     $this->app->singleton(TenantManager::class);
//     $this->app->bind(PaymentGatewayInterface::class, StripeGateway::class);
// }

// 4. ルート: GET /{tenant}/dashboard
// Route::middleware(['auth', 'tenant'])->get('/{tenant}/dashboard', [DashboardController::class, 'index']);

// 5. コントローラ — DIとFacadeを使用
class DashboardController extends Controller
{
    public function __construct(
        private TenantManager $tenantManager, // DIで解決される
    ) {}

    public function index(Request $request): View
    {
        $tenant = $this->tenantManager->current();
        $stats = Cache::remember("dashboard.{$tenant->id}", 300, function () use ($tenant) {
            return [
                'revenue' => $tenant->shops()->sum('revenue'),
                'orders' => $tenant->orders()->count(),
                'shops' => $tenant->shops()->active()->count(),
            ];
        });

        return view('dashboard.index', compact('tenant', 'stats'));
    }
}

// 6. レスポンス送信 → Terminableミドルウェア実行 → リクエスト完了