Symfony 7.3(2025年5月リリース)とPHP 8.4で、 コンポーネントはもはや単なるユーティリティではなく、決定主義的なアプリケーションアーキテクチャの背骨です。 symfony/clock This article explores non-trivial, production-grade patterns for the 単純な「今」の呼びかけを超えて、 で、 そして . Clock component JWT authentication Task Scheduling, Precision Telemetry Stack & Prerequisitesについて PHP 8.4+ と Symfony 7.3 を実行しているプロジェクトを仮定します。 必要なパッケージ このガイドで使用する特定のバージョンをインストールするには、次の操作を実行します。 # Core Clock and Scheduler components
composer require symfony/clock:^7.3 symfony/scheduler:^7.3 symfony/messenger:^7.3

# JWT Library (supports PSR-20 Clock)
composer require lcobucci/jwt:^5.3

# For testing
composer require --dev symfony/phpunit-bridge:^7.3
 Deterministic Security トークン JSON Web Tokens (JWTs) を生成するとき、開発者はしばしばライブラリにシステムの時間をキャッチさせます。 以来 PSR20を導入すると、直接注入できます。 構成 symfony/clock lcobucci/jwt サービス名:TokenGenerator PHP 8.4 Asymmetric Visibility (private set) を DTO で使用することに注意してください。 namespace App\Security;

use Lcobucci\JWT\Configuration;
use Lcobucci\JWT\Signer\Hmac\Sha256;
use Lcobucci\JWT\Signer\Key\InMemory;
use Psr\Clock\ClockInterface;
use Symfony\Component\DependencyInjection\Attribute\Autowire;

final readonly class TokenGenerator
{
    private Configuration $jwtConfig;

    public function __construct(
        private ClockInterface $clock,
        #[Autowire('%env(APP_SECRET)%')]
        string $appSecret
    ) {
        // Initialize JWT Configuration with OUR Clock
        $this->jwtConfig = Configuration::forSymmetricSigner(
            new Sha256(),
            InMemory::base64Encoded($appSecret)
        );
    }

    public function generateToken(string $userId): string
    {
        $now = $this->clock->now();
        
        return $this->jwtConfig->builder()
            ->issuedBy('https://api.myapp.com')
            ->issuedAt($now)
            ->expiresAt($now->modify('+15 minutes')) // Short lifetime
            ->withClaim('uid', $userId)
            ->getToken($this->jwtConfig->signer(), $this->jwtConfig->signingKey())
            ->toString();
    }
}
 手動で通過 由来 由来 俺ら勝ち イスラエル(イスラエル)とイスラエル(イスラエル)の主張。 Why this matters: $now $this->clock 100% control 「Testing the Untestable」 検査の実施は通常、 待つ 15 分 1 秒 テスト スイートのパフォーマンスを破壊する sleep(901) 同 (テストで自動的に利用可能) (※) 即座に MockClock ClockSensitiveTrait we can “time travel” namespace App\Tests\Security;

use App\Security\TokenGenerator;
use Lcobucci\JWT\Encoding\JoseEncoder;
use Lcobucci\JWT\Token\Parser;
use Lcobucci\JWT\Validator\Validator;
use Lcobucci\JWT\Validation\Constraint\LooseValidAt;
use Symfony\Bundle\FrameworkBundle\Test\KernelTestCase;
use Symfony\Component\Clock\Test\ClockSensitiveTrait;

class TokenGeneratorTest extends KernelTestCase
{
    use ClockSensitiveTrait;

    public function testTokenExpiresAfterFifteenMinutes(): void
    {
        self::bootKernel();
        
        // 1. Freeze time at a known point
        $startTime = '2025-11-18 12:00:00';
        $clock = static::mockTime($startTime);

        $generator = static::getContainer()->get(TokenGenerator::class);
        $tokenString = $generator->generateToken('user_123');

        // 2. Verify token is valid NOW
        $this->assertTokenValidity($tokenString, true, "Token should be valid immediately");

        // 3. Time travel: Jump 16 minutes into the future
        $clock->sleep(16 * 60);

        // 4. Verify token is EXPIRED
        $this->assertTokenValidity($tokenString, false, "Token should be expired after 16 mins");
    }

    private function assertTokenValidity(string $tokenString, bool $expectValid, string $message): void
    {
        $parser = new Parser(new JoseEncoder());
        $token = $parser->parse($tokenString);
        
        $validator = new Validator();
        // We verify against the CURRENT clock time (which we shifted)
        $constraint = new LooseValidAt(static::getContainer()->get('clock'));

        $this->assertSame($expectValid, $validator->validate($token, $constraint), $message);
    }
}
 走る テスト will 16分遅れのシミュレーションでも、 php bin/phpunit complete in milliseconds ダイナミック&条件付きスケジュール THE コンポーネントは通常、静的属性に依存します。 しかし、実際のビジネス論理はしばしばより複雑である。 symfony/scheduler #[AsPeriodicTask(‘1 hour’)] このレポートは、午前9時から午後5時までの営業日にのみ実行してください。 We can inject the 入 A ダイナミックなスケジュールを作成する ClockInterface Schedule Provider namespace App\Scheduler;

use App\Message\GenerateBusinessReport;
use Psr\Clock\ClockInterface;
use Symfony\Component\Scheduler\Attribute\AsSchedule;
use Symfony\Component\Scheduler\RecurringMessage;
use Symfony\Component\Scheduler\Schedule;
use Symfony\Component\Scheduler\ScheduleProviderInterface;

#[AsSchedule('business_reports')]
final readonly class BusinessHoursProvider implements ScheduleProviderInterface
{
    public function __construct(
        private ClockInterface $clock
    ) {}

    public function getSchedule(): Schedule
    {
        $schedule = new Schedule();
        $now = $this->clock->now();

        // Logic: Only schedule the task if it's a weekday (Mon-Fri)
        // AND within business hours (9-17).
        
        $isWeekday = $now->format('N') < 6;
        $isBusinessHour = $now->format('G') >= 9 && $now->format('G') < 17;

        if ($isWeekday && $isBusinessHour) {
            $schedule->add(
                RecurringMessage::every('1 hour', new GenerateBusinessReport())
            );
        }

        return $schedule;
    }
}
 たとえ 時計を使用して、複雑な休日論理やPHPで定義されたメンテナンスウィンドウを可能にし、crontab 文字列よりも単位テストが容易になります。 Scheduler スケジュールテスト ClockInterface を注入したため、システムの日付を変更することなく週末にスケジュールが空いていることをテストできます。 public function testNoReportsOnSunday(): void
{
    // Set clock to a Sunday
    $clock = new MockClock('2025-11-23 10:00:00'); 
    $provider = new BusinessHoursProvider($clock);
    
    $schedule = $provider->getSchedule();
    $this->assertEmpty($schedule->getRecurringMessages());
}
 精度パフォーマンスメトリック タイムスケジュール(タイムスケジュール)は、タイムスケジュール(タイムスケジュール)を測定するのに適しています。 )を使用すべきである。 それはシステムの時間調整(例えば、NTP更新またはジャンプ秒)に免疫的であり、高解像度のナノ秒を使用します。 NativeClock metrics/telemetry MonotonicClock わたしたちは創造する。 それは、各 async メッセージの正確な実行時間をログします。 Messenger Middleware namespace App\Messenger\Middleware;

use Psr\Log\LoggerInterface;
use Symfony\Component\Clock\MonotonicClock;
use Symfony\Component\Messenger\Envelope;
use Symfony\Component\Messenger\Middleware\MiddlewareInterface;
use Symfony\Component\Messenger\Middleware\StackInterface;

final class PrecisionMetricsMiddleware implements MiddlewareInterface
{
    private MonotonicClock $stopwatch;

    public function __construct(
        private LoggerInterface $logger
    ) {
        $this->stopwatch = new MonotonicClock();
    }

    public function handle(Envelope $envelope, StackInterface $stack): Envelope
    {
        // 1. Snapshot start time (nanosecond precision)
        $start = $this->stopwatch->now();

        try {
            $result = $stack->next()->handle($envelope, $stack);
        } finally {
            // 2. Calculate precise duration
            // monotonic clocks are ideal for "diff" operations
            $duration = $this->stopwatch->now()->diff($start);
            
            // Convert to float milliseconds
            $ms = ($duration->s * 1000) + ($duration->f * 1000);

            $this->logger->info('Message Handled', [
                'message' => get_class($envelope->getMessage()),
                'duration_ms' => number_format($ms, 4)
            ]);
        }

        return $result;
    }
}
 コンピュータ( ) config/packages/messenger.yaml framework:
    messenger:
        buses:
            default:
                middleware:
                    - App\Messenger\Middleware\PrecisionMetricsMiddleware
 ベストプラクティックの概要 
 
 
 
 
 常に Psr\Clock\ClockInterface (または Symfony\...\ClockInterface) を注入し、新しい DateTime() を導入しないでください。 ClockSensitiveTraitとmockTime()を使用して、睡眠()を避ける。 php.ini で default_timezone を構成しますが、バックエンド ロジックでは ClockInterface が既定で UTC を返します。 MonotonicClock for intervals/stopwatches、NativeClock for calendar datesを使用します。 結論 The transition to Symfony 7.3 では、シンタクスアップデート以上のことを表していますが、私たちが扱う方法の根本的な変化です。 グローバルで予測不可能な副作用からタイムを促進することによって(via Time from a global, unpredictable side effect) ) 明示的で注射可能な依存性に、私たちはアプリケーションの行動に対する絶対的なコントロールを取り戻します。 symfony/clock temporal coupling new DateTime() 我々は、ジャンプ年や任意に吊るされたCIパイプラインでのみ失敗する不具合のテストの時代を超えてきた。 示されたように、実装は実践的で、影響力が高い: sleep() 
 
 
 
 セキュリティは、Deterministic JWT 署名を通じて検証可能になります。 スケジュールは厳密に論理的になり、金曜日の午後には「月曜日の朝」の論理をテストすることができます。 MonotonicClock により、システム時計のドライブからパフォーマンスメトリクスを切り離す。 現代のPHP 8.4アーキテクチャでは、タイムはデータです。データベース接続とAPIクライアントに適用する同じ規律で処理します。 コメントであなたの考えを聞きたい! 調和を保ち、話し合いを続けましょう。

Read My Stories

このオーディオは、ストーリーの元の言語で制作されています。

Symfony Clock:MockClock、NativeClock、その他

About Author

コメント

ラベル

この記事は

Related Stories

海を航海する: データレイクを使用した本番環境レベルの RAG アプリケーションの開発

クラウド移行を成功させるための完全ガイド: 戦略とベストプラクティス

ユーザー中心の暗号通貨製品の作成: 顧客からのフィードバックの重要性

目に見えない層: ユーザーインタビューがかけがえのない資産である理由

海を航海する: データレイクを使用した本番環境レベルの RAG アプリケーションの開発

クラウド移行を成功させるための完全ガイド: 戦略とベストプラクティス

ユーザー中心の暗号通貨製品の作成: 顧客からのフィードバックの重要性

目に見えない層: ユーザーインタビューがかけがえのない資産である理由

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps