Avec Symfony 7.3 (relevé en mai 2025) et PHP 8.4, Le composant n’est plus seulement une utilité, c’est la colonne vertébrale de l’architecture d’application déterministe. symfony/clock Cet article explore les modèles non-triviels de niveau de production pour au-delà des simples appels « maintenant » à l’intégration avec , à et . Clock component JWT authentication Task Scheduling, Precision Telemetry Le stack et les conditions préalables Nous supposons un projet exécutant PHP 8.4+ et Symfony 7.3. Packages nécessaires Exécutez ce qui suit pour installer les versions spécifiques utilisées dans ce 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
 Déterminisme de la sécurité Lors de la génération de JSON Web Tokens (JWTs), les développeurs laissent souvent la bibliothèque saisir le temps du système. depuis PSR-20, nous pouvons l'injecter directement dans le La configuration . symfony/clock lcobucci/jwt Étiquette : TokenGenerator Nous allons construire un générateur qui crée des jetons d'accès à courte durée de vie. Notez l'utilisation de PHP 8.4 Asymétrique Visibilité (ensemble privé) dans le DTO si vous le souhaitez, bien que les propriétés standard readonly fonctionnent parfaitement ici. 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();
    }
}
 En passant manuellement dérivé de Nous gagnons sur le iat (Édité à) et expiration (Expiration). Why this matters: $now $this->clock 100% control Tester l’incontournable Le test d'expiration implique généralement — attendre 15 minutes et 1 seconde. Cela détruit la performance de la suite de test. sleep(901) avec (disponible automatiquement dans les tests via , à instantanément . 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);
    }
}
 courir Le test sera en dépit d'un retard de 16 minutes. php bin/phpunit complete in milliseconds Planification dynamique et conditionnelle Le La composante repose généralement sur des attributs statiques tels que Cependant, la logique des affaires du monde réel est souvent plus complexe : symfony/scheduler #[AsPeriodicTask(‘1 hour’)] Exécutez ce rapport uniquement les jours ouvrables entre 9h00 et 5h00. On peut injecter le dans A Créer des horaires dynamiques. 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;
    }
}
 Même si Supporte la syntaxe crontab, l'utilisation de l'horloge permet la logique complexe des vacances ou des fenêtres de maintenance définies en PHP, ce qui est plus facile à unité de test qu'une chaîne crontab. Scheduler Tester le calendrier Parce que nous avons injecté ClockInterface, nous pouvons tester que l'horaire est vide le week-end sans changer la date du système. 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());
}
 Métriques de performance de précision est bon pour le calendrier, mais pour mesurer la durée d'exécution ( Vous devriez utiliser Il est immunisé contre les ajustements du temps du système (par exemple, les mises à jour NTP ou les secondes de saut) et utilise des nanosecondes haute résolution. NativeClock metrics/telemetry MonotonicClock Nous allons créer une qui enregistre l'heure exacte d'exécution de chaque message 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;
    }
}
 La configuration ( ) config/packages/messenger.yaml framework:
    messenger:
        buses:
            default:
                middleware:
                    - App\Messenger\Middleware\PrecisionMetricsMiddleware
 Résumé des meilleures pratiques 
 
 
 
 
 Toujours injecter Psr\Clock\ClockInterface (ou Symfony\...\ClockInterface), jamais de nouveau DateTime(). Utilisez ClockSensitiveTrait et mockTime(). Configurez default_timezone dans php.ini, mais traitez ClockInterface comme retournant UTC par défaut pour la logique de backend. Utilisez MonotonicClock pour les intervalles/stopwatches, NativeClock pour les dates de calendrier. Conclusion La transition à Symfony 7.3 représente plus qu’une mise à jour de syntaxe ; c’est un changement fondamental dans la façon dont nous traitons Par la promotion du temps à partir d'un effet secondaire mondial et imprévisible (via - à une dépendance explicite et injectable, nous retrouvons le contrôle absolu sur le comportement de notre application. symfony/clock temporal coupling new DateTime() Nous sommes allés au-delà de l’ère des tests flou qui échouent uniquement sur des années de saut ou des pipelines CI qui suspendent à l’arbitraire. Comme montré, les implémentations sont pratiques et d'un impact élevé: sleep() 
 
 
 
 La sécurité devient vérifiable grâce à la signature déterministe de JWT. La planification devient strictement logique, nous permettant de tester la logique du « lundi matin » un vendredi après-midi. L'observabilité devient précise avec MonotonicClock, déconnectant les mesures de performance de la dérive de l'horloge du système. Dans l'architecture moderne PHP 8.4, le temps est des données. Traitez-le avec la même discipline que vous appliquez à vos connexions de base de données et clients API. Quand vous possédez l'horloge, vous possédez la fiabilité de votre logiciel. J'aimerais bien entendre vos pensées dans les commentaires ! Restez à l'aise - et continuons la conversation.

Read My Stories

Cet audio est produit dans la langue originale de l'histoire !

Modèles avancés avec l'horloge symphonique: MockClock, NativeClock et plus

About Author

COMMENTAIRES

ÉTIQUETTES

CET ARTICLE A ÉTÉ PARU DANS

Related Stories

Vous voulez gagner un concours d’écriture HackerNoon ? Voici ce que recommandent les gagnants du concours #crypto-api

Guide de l'architecte pour créer une architecture de référence pour un datalake IA/ML

Libérer la puissance de l’IA. Une revue systématique des techniques de pointe : résumé et introduction

Valhalla de Floki se joint en tant que sponsor associé de la tournée indienne au Sri Lanka

Vous voulez gagner un concours d’écriture HackerNoon ? Voici ce que recommandent les gagnants du concours #crypto-api

Guide de l'architecte pour créer une architecture de référence pour un datalake IA/ML

Libérer la puissance de l’IA. Une revue systématique des techniques de pointe : résumé et introduction

Valhalla de Floki se joint en tant que sponsor associé de la tournée indienne au Sri Lanka

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps