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 & 전제 조건 PHP 8.4+ 및 Symfony 7.3을 실행하는 프로젝트를 가정합니다. 필요한 패키지 이 가이드에서 사용하는 특정 버전을 설치 하려면 다음을 실행 합니다.Run the following to install the specific versions used in this guide: # 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 보안 토큰 JSON Web Tokens(JWT)를 생성할 때, 개발자는 종종 라이브러리를 시스템 시간을 잡게 한다. 이후 PSR-20을 구현하면, 우리는 그것을 직접 삽입할 수 있습니다. configuration 으로 symfony/clock lcobucci/jwt 상품명 : TokenGenerator 원하는 경우 DTO에서 PHP 8.4 Asymmetric Visibility (private set)의 사용을 참고하십시오, 비록 표준 readonly 속성은 여기에서 완벽하게 작동합니다. 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();
    }
}
 수동으로 통과하여 derived from 에서 우리는 이길 이사야와 이사야에 대한 징계와 징계 Why this matters: $now $this->clock 100% control 테스트 Untestable 테스트 expiration usually involves - 기다리는 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 Dynamic & Conditional 스케줄링 이 구성 요소는 일반적으로 정적 특성에 의존합니다.component usually relies on static attributes such as 그러나 실제 비즈니스 논리는 종종 더 복잡합니다. symfony/scheduler #[AsPeriodicTask(‘1 hour’)] 이 보고서를 실행하십시오.Run this report only on business days between 9 AM and 5 PM. 우리는 그것을 주입할 수 있습니다 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;
    }
}
 그 동안 Clock를 사용하면 php로 정의된 복잡한 휴일 논리 또는 유지 보수 창을 사용할 수 있으며, 이는 crontab 문자열보다 단위 테스트가 쉬워집니다. Scheduler 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());
}
 Precision Performance Metrics에 대한 리뷰 보기 시간을 측정하는 것이 좋지만 시간을 측정하는 것이 좋습니다 ( (당신은 사용해야 할 그것은 시스템 시간 조정 (예를 들어, NTP 업데이트 또는 점프 초)에 면역 하 고 고해상도 nanoseconds를 사용 합니다. 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
 Best Practices의 요약 
 
 
 
 
 항상 Psr\Clock\ClockInterface (또는 Symfony\...\ClockInterface)를 주입하십시오. 잠을 자는 것을 피하기 위하여 ClockSensitiveTrait 및 mockTime()를 사용합니다. php.ini에서 default_timezone을 구성하지만 백엔드 논리를 위해 ClockInterface를 기본적으로 UTC로 반환합니다. 간격/stopwatches를 위해 MonotonicClock를 사용하고, 일정 날짜를 위해 NativeClock를 사용합니다. 결론 The transition to Symfony 7.3는 구문 업데이트 이상을 나타냅니다; 그것은 우리가 처리하는 방식에 근본적인 변화입니다. 전 세계적이고 예측할 수 없는 부작용으로부터 시간을 홍보함으로써(via Time from a global, unpredictable side effect) 명시적이고 주입 가능한 의존성으로, 우리는 우리의 응용 프로그램의 행동에 대한 절대적인 통제를 되찾습니다. symfony/clock temporal coupling new DateTime() 우리는 단지 점프 년에만 실패하는 까다로운 테스트의 시대를 넘어 갔습니다. 이와 같이 실행은 실용적이고 높은 영향을 미친다: sleep() 
 
 
 
 보안은 deterministic JWT 서명을 통해 검증될 수 있습니다. 일정은 엄격하게 논리적이되며 금요일 오후에 “월요일 아침” 논리를 테스트 할 수 있습니다. MonotonicClock를 통해 관찰성은 시스템 시계 드라이브로부터 성능 매개 변수를 해제합니다.Observability becomes precise with MonotonicClock, disconnecting performance metrics from system watch drift. 현대 PHP 8.4 아키텍처에서 Time is data.Treat it with the same discipline you apply to your database connections and API clients.When you own the clock, you own the reliability of your software.현대 PHP 8.4 아키텍처에서 Time is data.Treat it with the same discipline you apply to your database connections and API clients. 나는 당신의 생각을 코멘트에서 듣고 싶습니다! 조율을 유지하십시오 - 그리고 대화를 계속하자.

Read My Stories

이 오디오는 이야기의 원래 언어로 제작되었습니다!

Symfony Clock의 고급 패턴: MockClock, NativeClock 및 더 많은 것

About Author

코멘트

태그 걸기

이 기사는 다음에서 발표되었습니다.

Related Stories

바다 항해: 데이터 레이크를 사용하여 프로덕션 등급 RAG 애플리케이션 개발

사용자 중심의 암호화 제품 만들기: 고객 피드백의 중요성

독특한 생태계를 강화하는 비트코인 UTXO 모델

Claude Sonnet 3.5 시스템 프롬프트 유출: 법의학적 분석

바다 항해: 데이터 레이크를 사용하여 프로덕션 등급 RAG 애플리케이션 개발

사용자 중심의 암호화 제품 만들기: 고객 피드백의 중요성

독특한 생태계를 강화하는 비트코인 UTXO 모델

Claude Sonnet 3.5 시스템 프롬프트 유출: 법의학적 분석

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps