Null Objectパターン：オプショナルな依存関係の扱い

class OrderService
{
    public function __construct(
        private OrderRepositoryInterface $orderRepository,
        private ?LoggerInterface $logger = null,
        private ?NotificationServiceInterface $notifier = null
    ) {}

    public function processOrder(Order $order): void
    {
        if ($this->logger !== null) {  // nullチェック
            $this->logger->info("Processing order: {$order->getId()}");
        }

        $this->orderRepository->save($order);

        if ($this->notifier !== null) {  // nullチェック
            $this->notifier->send(new OrderConfirmation($order));
        }

        if ($this->logger !== null) {  // nullチェック
            $this->logger->info("Order processed successfully");
        }
    }
}

// ❌ さらに悪い例：if文でコンテキストをチェック
class OrderService
{
    public function processOrder(Order $order): void
    {
        $this->orderRepository->save($order);

        // 環境チェックがビジネスロジックに混在！
        if ($_ENV['APP_ENV'] === 'production') {
            $this->notifier->send(new OrderConfirmation($order));
        }
    }
}

// Null Object実装 - インターフェースを満たすが何もしない
class NullLogger implements LoggerInterface
{
    public function info(string $message): void {}
    public function error(string $message): void {}
}

class NullNotificationService implements NotificationServiceInterface
{
    public function send(Notification $notification): void {}
}

// DIモジュールで環境別にバインド
class DevelopmentModule extends AbstractModule
{
    protected function configure(): void
    {
        // 開発環境ではNull Objectを使用
        $this->bind(LoggerInterface::class)->to(NullLogger::class);
        $this->bind(NotificationServiceInterface::class)->to(NullNotificationService::class);
    }
}

class ProductionModule extends AbstractModule
{
    protected function configure(): void
    {
        // 本番環境では実際の実装を使用
        $this->bind(LoggerInterface::class)->to(FileLogger::class);
        $this->bind(NotificationServiceInterface::class)->to(EmailNotificationService::class);
    }
}

// ✅ コードからnullチェックも環境チェックも完全に消える！
class OrderService
{
    public function __construct(
        private OrderRepositoryInterface $orderRepository,
        private LoggerInterface $logger,           // 常に存在
        private NotificationServiceInterface $notifier  // 常に存在
    ) {}

    public function processOrder(Order $order): void
    {
        // if文不要 - 実行するかしないかはDIバインディングで決まる
        $this->logger->info("Processing order: {$order->getId()}");
        $this->orderRepository->save($order);
        $this->notifier->send(new OrderConfirmation($order));
        // 開発: NullNotificationService = 何もしない
        // 本番: EmailNotificationService = メール送信
    }
}

class DevelopmentModule extends AbstractModule
{
    protected function configure(): void
    {
        $this->bind(OrderRepositoryInterface::class)->to(MySQLOrderRepository::class);
        $this->bind(InventoryServiceInterface::class)->to(InventoryService::class);

        // toNull()でNull Objectを自動生成
        $this->bind(LoggerInterface::class)->toNull();
        $this->bind(CacheInterface::class)->toNull();
        $this->bind(NotificationServiceInterface::class)->toNull();
    }
}

// 1. インターフェイスだけを定義（実装クラスは書かない）
interface TodoQueryInterface
{
    #[DbQuery('todo_item')]
    public function item(string $id): Todo;
}

// 2. Null Objectをバインド + インターセプターを適用
class AppModule extends AbstractModule
{
    protected function configure(): void
    {
        $this->bind(TodoQueryInterface::class)->toNull();
        $this->bindInterceptor(
            $this->matcher->any(),
            $this->matcher->annotatedWith(DbQuery::class),
            [DbQueryInterceptor::class]
        );
    }
}

// 3. インターセプターがメソッド呼び出しを横取りしてSQL実行
class DbQueryInterceptor implements MethodInterceptor
{
    public function invoke(MethodInvocation $invocation): mixed
    {
        $attr = $invocation->getMethod()->getAttributes(DbQuery::class)[0];
        $sql = "SELECT * FROM {$attr->table} WHERE id = ?";
        return $this->pdo->execute($sql, $invocation->getArguments());
    }
}

// 使用 - 普通のメソッド呼び出しだが、実際にはSQLが実行される
$todo = $todoQuery->item('123');