Mise à jour PHPTS 2.0.13 : ajout des tâches déclenchées par événements
Publiée le 19 novembre 2026, la version PHPTS 2.0.13 introduit le module « tâches déclenchées par événements » : cinq types de sources d'événements — WebSocket, TCP, MQTT, port série et minuteur — sont raccordés de façon unifiée à la passerelle d'événements Rust intégrée ; les événements sont traités par des scripts PHP qui répondent par le même canal. Associé au stockage clé-valeur inter-processus phpts_kv et à l'interface de push proactif Server → Client, toute page PHP ordinaire peut envoyer des messages de manière proactive aux clients en ligne, aux connexions TCP ou au port série. Cet article couvre la prise en main en trois minutes, les conventions de scripts, la boucle complète de push proactif, la protection anti-réentrance du minuteur et cinq assistants de débogage.
Avant-propos
PHPTS 2.0.13 a été officiellement publié le 19 novembre 2026. Adresse de téléchargement du package d'installation : https://down.phpts.com/phpts.zip
Notes de mise à jour de la version 2.0.13 (2026-11-19) :
- 1. Ajout d'un gestionnaire de pool de processus « PHP FastCGI (tâche) », un pool de processus PHP 8.5 FastCGI indépendant des activités Web, servant de moteur dédié au traitement des événements. Lorsqu'un événement survient, PHPTS affecte directement la tâche à un processus PHP en attente en mémoire, ce qui évite le coût de démarrage à froid des processus et garantit un traitement des événements efficace et immédiat ;
- 2. Nouvelle passerelle « Tâches déclenchées par événement » : elle prend en charge de manière unifiée, en mode asynchrone non bloquant Windows IOCP, les événements d'E/S tels que les connexions longues WebSocket, les connexions longues TCP, les abonnements MQTT, les ports série et les minuteries à la seconde. La passerelle transmet les événements via FastCGI au pool de processus de tâches PHP-CGI, et les scripts PHP exécutent la logique métier concrète, formant une architecture découplée où « la passerelle Rust se charge de l'accès et de l'ordonnancement des événements à forte concurrence, tandis que PHP se concentre sur le traitement métier de courte durée » ; traitez chaque événement avec les scripts PHP qui vous sont familiers — sans écrire vous-même de serveur socket, sans maintenir de processus PHP résidents ; la gestion des connexions, le découpage en trames, les heartbeats et TLS sont entièrement confiés à la passerelle d'événements Rust intégrée ;
- 3. Ajout de l'extension PHP phpts_kv de stockage clé-valeur partagé entre processus ; combinée à l'interface de push actif (Server → Client), elle permet même aux pages de sites Web Nginx + PHP ordinaires d'envoyer à tout moment des données en push actif vers des clients WebSocket ou TCP spécifiés en ligne, ou vers un port série ;
- 4. Optimisation de l'utilisation CPU : suppression de l'animation de respiration, adoption de voyants statiques ; lorsque l'interface ne change pas, l'occupation CPU du processus GPU descend à 0 % ;
- 5. Les voyants d'état des services dans la barre des tâches supérieure sont remplacés par des icônes d'outils client ; un maintien du bouton de la souris permet de les faire glisser horizontalement pour changer leur position ;
- 6. La liste des tâches et la liste des outils à gauche prennent en charge le maintien du bouton de la souris et le glisser-déposer vertical pour modifier leur position ;
- 7. Correction du BUG d'échec de suppression d'e-mails par les clients IMAP tiers du bureau de messagerie électronique ;
- 8. Correction du BUG d'interruption du téléversement de fichiers volumineux par le transfert de fichiers ;
- 9. Correction du BUG d'échec de réinitialisation du mot de passe root de la base de données MySQL.
Le principal point fort de cette version est le tout nouveau module « Tâches déclenchées par événement » : il intègre de manière unifiée dans PHPTS cinq types de sources d'événements — WebSocket, TCP, MQTT, port série et minuterie —, et traite chaque événement avec les scripts PHP qui vous sont familiers — sans écrire vous-même de serveur socket, sans maintenir de processus PHP résidents ; la gestion des connexions, le découpage en trames, les heartbeats et TLS sont entièrement confiés à la passerelle d'événements Rust intégrée.
Avec la nouvelle extension phpts_kv de stockage clé-valeur partagé entre processus et l'interface de push actif (Server → Client), les pages de sites Web Nginx + PHP ordinaires peuvent elles aussi envoyer à tout moment des données en push actif vers des clients en ligne, des connexions TCP ou un port série. Voici une présentation complète des fonctionnalités et de leur utilisation.
I. Qu'est-ce qu'une tâche déclenchée par événement ?
Le module est porté par le processus de passerelle indépendant phpts-event.exe : les connexions longues et les sources d'événements sont entièrement gérées par Rust (WebSocket / TCP via E/S asynchrones IOCP), et PHP n'est qu'une unité d'exécution logique sans état — à chaque événement reçu, la passerelle le délègue, via le protocole FastCGI, au pool de processus « PHP FastCGI (tâche) » qui exécute le script que vous avez associé, et la sortie du script est renvoyée au client par le même chemin. L'anomalie d'un seul sous-service n'affecte que lui-même et ne fait pas tomber toute la passerelle.
Cinq sources d'événements, chacune avec ses propres boutons démarrer / arrêter / redémarrer, et pouvant être lancées automatiquement au démarrage de PHPTS :
- Serveur WebSocket : écoute double ws:// et wss://, le certificat TLS peut être demandé en un clic depuis la page (validation DNS) ou déployé en un clic depuis le magasin de certificats ; le Ping de heartbeat côté serveur est configurable ; routage vers différents scripts PHP selon le « chemin ».
- Serveur TCP : écoute simultanée sur plusieurs ports, chaque port étant lié à son propre script ; trois modes de découpage en trames — idle avec fusion silencieuse (fenêtre de silence par défaut de 50 ms, configurable), line avec découpage selon le séparateur, none avec segments d'octets bruts ; les paquets collés ou partiels n'ont pas à être gérés manuellement.
- Abonnement MQTT : prise en charge des thèmes génériques + / #, connexion possible au NanoMQ intégré ou à un broker externe ; la règle peut configurer un « thème de réponse », et la sortie du script y est automatiquement publiée.
- Écoute de port série : raccordement d'appareils RS232 / RS485 / TTL, écoute simultanée de plusieurs ports série ; débit en bauds, bits de données, bits d'arrêt et bits de parité configurables port par port ; une fois « réponse écrite vers le port série » activé, la sortie du script est renvoyée telle quelle à l'appareil, prête à l'emploi pour les scénarios de réponse de l'ordinateur hôte.
- Minuterie : quatre modes de déclenchement — intervalle / quotidien / hebdomadaire / mensuel ; commutateur « anti-réentrance » (si le tour précédent n'est pas terminé, le tour actuel est ignoré ; activé par défaut) ; les paramètres supplémentaires sont transmis au script via QUERY_STRING.
II. Prise en main en trois minutes
- Ouvrez la page « Tâches déclenchées par événement » du groupe « Outils » dans la barre latérale (le tableau de bord d'ensemble comporte aussi une carte d'état et un point d'entrée). La page comporte six onglets : « Configuration globale de délégation et service de push » + cinq sous-services.
- Dans l'onglet correspondant, cliquez sur « Ajouter une règle » : pour WebSocket, saisissez le chemin ; pour TCP, le port ; pour MQTT, le thème ; pour le port série, sélectionnez le port COM ; pour la minuterie, choisissez le mode de déclenchement ; la colonne « Script PHP » est préremplie par défaut avec les scripts de démonstration fournis (cinq exemples sous data/taskdemo/) ; vous pouvez utiliser « Sélectionner… » pour associer votre propre script, ou cliquer sur « Modifier » pour l'ouvrir et le modifier directement.
- Cliquez sur « Démarrer » (la configuration de cette page est d'abord enregistrée automatiquement, puis le service est démarré ou arrêté). Utilisez l'assistant de débogage à droite de l'en-tête de page pour connecter un client et envoyer un message ; vous verrez alors la réponse du script PHP revenir par le même chemin.
Les conventions côté script sont très simples : php://input lit le corps de l'événement, $_SERVER['PHPTS_EVENT_*'] récupère les métadonnées, et la sortie echo constitue la réponse. Exemple (script de routage WebSocket) :
<?php
// Lire l'intégralité du message envoyé par le client (compatible à la fois avec JSON et le texte brut)
$msg = file_get_contents('php://input');
$data = json_decode($msg, true);
if (json_last_error() !== JSON_ERROR_NONE) { $data = ['text' => $msg]; }
// En prenant le nom métier comme clé, enregistrer l'ID de la connexion actuelle dans la mémoire partagée, pour que la page Web puisse ensuite effectuer un push actif
if (function_exists('phpts_kv_set')) {
phpts_kv_set('user:1001', $_SERVER['PHPTS_EVENT_CLIENTID'], 3600);
}
// Le client demande de quitter : émettre la valeur convenue, la passerelle ferme activement cette connexion (close 1000)
if (($data['cmd'] ?? '') === 'QUIT') { echo '__PHPTS_CLOSE__'; return; }
// La sortie constitue la réponse : la renvoyer au client sur la connexion d'origine en tant que trame de type text
echo json_encode(['type' => 'reply', 'msg' => 'received']);
Aperçu des métadonnées disponibles :
- PHPTS_EVENT_CLIENTID : ID de la connexion actuelle (WebSocket / TCP). La poignée de main du client peut inclure ?client_id= pour définir une identité personnalisée ; sinon, un ID préfixé par ws- / tcp- est attribué automatiquement.
- PHPTS_EVENT_CLIENTIP : IP du client (sans le port), à utiliser directement pour le contrôle d'accès et les journaux d'audit.
- PHPTS_EVENT_PATH / PHPTS_EVENT_NAME : chemin de routage / nom de règle correspondants (le nom de règle prend en charge le chinois).
- PHPTS_EVENT_PORT : port d'écoute TCP ou nom du port série ; PHPTS_EVENT_TOPIC : thème MQTT réellement correspondant.
Deux conventions pratiques : lorsque la sortie du script WebSocket / TCP est exactement égale à __PHPTS_CLOSE__, la passerelle ferme activement la connexion en cours (clôture uniforme des scénarios tels que l'échec d'authentification ou le QUIT du client) ; le délai d'attente est à deux niveaux, « global + règle individuelle » ; une valeur de 0 pour une règle individuelle = héritage du réglage global (300 secondes par défaut), et il est lié à la limite d'exécution PHP du pool de tâches, afin qu'un script lent ne soit pas interrompu en cours de route.
III. Push actif : envoyer des messages à des clients en ligne depuis n'importe quelle page PHP
La passerelle expose en permanence une interface HTTP de push (par défaut 127.0.0.1:3379, pouvant être démarrée et arrêtée indépendamment, avec un Token d'autorisation configurable), et distingue les cibles de livraison par préfixe d'URI : /ws/send (trame text WebSocket), /tcp/send (octets bruts TCP), /serial/send (octets bruts série) ; les trois prennent en charge la diffusion broadcast et l'interrogation de la liste des clients en ligne ; les cibles individuelles acceptent plusieurs ID séparés par des virgules, et acceptent aussi key= pour transmettre directement une clé phpts_kv, la passerelle recherche automatiquement la clé pour récupérer l'ID et livrer.
Boucle typique : dans un script d'événement, utilisez phpts_kv_set('user:1001', 连接ID) pour enregistrer (phpts_kv est une extension de stockage clé-valeur inter-processus basée sur la mémoire partagée nommée Windows, activée par défaut dans le pool Web et le pool de tâches) ; ensuite toute page PHP ordinaire, script planifié peut récupérer l'ID par clé et pousser ; lorsqu'un client se déconnecte, la passerelle supprime automatiquement l'enregistrement dans la mémoire partagée, le script n'a pas à se soucier du nettoyage à la déconnexion.
<?php
// N'importe quelle page PHP ordinaire / script planifié : push basé sur l'enregistrement
$client = phpts_kv_get('user:1001');
if (!$client) { exit('client offline'); } // Déconnecté (supprimé automatiquement par la passerelle) ou TTL expiré
$url = 'http://127.0.0.1:3379/ws/send?client=' . urlencode($client) . '&token=你的权限Token';
$ctx = stream_context_create(['http' => [
'method' => 'POST',
'header' => "Content-Type: text/plain\r\n",
'content' => json_encode(['type' => 'notify', 'msg' => 'hello']),
'timeout' => 3,
]]);
echo file_get_contents($url, false, $ctx); // {"ok":true}
La ligne de commande est tout aussi pratique (dans l'onglet « Configuration globale des délégations et service de push » de la page se trouve un exemple curl assemblé en temps réel selon la configuration actuelle, copiable en un clic) :
curl -X POST "http://127.0.0.1:3379/ws/send?client=ws-1a2b3c4d&token=你的权限Token" -d "hello" curl -X POST "http://127.0.0.1:3379/ws/broadcast?token=你的权限Token" -d "系统公告" curl -X POST "http://127.0.0.1:3379/serial/send?port=COM3" --data-binary "@frame.bin"
IV. Minuteur : quatre modes de déclenchement et protection anti-réentrance
Le minuteur n'a plus seulement la forme « intervalle en secondes » : intervalle / quotidien / hebdomadaire / mensuel au choix, quotidien/hebdomadaire/mensuel se déclenchent à l'heure prévue selon l'horloge murale locale (pour l'hebdomadaire, choix du jour de la semaine ; pour le mensuel, choix du quantième ; le 31 février inexistant est naturellement ignoré) ; l'anti-réentrance est configurable par règle : lorsqu'elle est activée, si l'exécution précédente n'est pas revenue, le tour en cours est ignoré ; désactivée, le déclenchement a lieu normalement à l'heure prévue. Le corps de requête du script est vide, les paramètres supplémentaires passent par $_GET, la sortie est écrite uniquement dans le journal de la passerelle, ce qui convient aux tâches d'arrière-plan telles que la remontée de heartbeat, le nettoyage des expirations, la génération de rapports quotidiens, etc. Après mise à niveau, le comportement des anciennes règles d'intervalle reste inchangé au caractère près.
V. Assistants de débogage et détails de fiabilité
- Cinq assistants de débogage : push actif / client WebSocket / client TCP / MQTT / série, ouverts en un clic en haut à droite de l'en-tête de page, pour une validation en boucle « d'abord se connecter, puis pousser » ; la fenêtre contextuelle peut être minimisée dans la barre des tâches de la barre supérieure et la session restaurée à tout moment.
- Bouton Journal de la passerelle pour les déclenchements d'événements : suivi en temps réel du journal du jour (un fichier par jour), plus besoin de parcourir les répertoires pour diagnostiquer les problèmes de délégation.
- Pré-vérification de l'occupation des ports : avant le démarrage, vérifie qui occupe le port d'écoute et signale l'erreur en le nommant (y compris les occupations masquées avec bind sans listen) ; avant le démarrage du port série, pré-vérifie l'occupation, reconnaît d'abord « l'assistant de débogage série » comme faisant partie des nôtres, puis détermine les autres programmes.
- Prise en compte à chaud de la configuration : après sauvegarde, la passerelle recharge immédiatement, la modification des règles ne nécessite pas de redémarrer le processus ; les noms de règles en chinois sont conservés tels quels.
- Isolation au niveau des processus : le plantage d'un seul sous-service est seulement marqué comme anomalie sans faire tomber toute la passerelle ; le démarrage et l'arrêt de la passerelle et du pool de tâches sont sémantiquement indépendants, la page affiche des indications de dépendance.
VI. Autres mises à jour
- Correctif pour l'upload de gros fichiers dans le mappage de stockage réseau / le transfert de fichiers : la réception PUT du proxy local passe à l'écriture en flux sur disque, les uploads de l'ordre de 17 Go ne se heurtent plus au « mur de mémoire de 4 Go » et n'échouent plus en cours de route ; la chaîne d'annulation d'upload ajoute un verrou de non-régression, l'annulation pendant le transfert prend effet immédiatement.
- Délai d'expiration par défaut des délégations d'événements porté de 30 secondes à 300 secondes, les scripts de longue durée sont plus à l'aise (toujours surchargeable globalement / par règle).
VII. Instructions de mise à niveau
Il suffit de télécharger le paquet d'installation 2.0.13 depuis le site officiel ou d'utiliser la mise à jour intégrée ; les anciennes configurations sont automatiquement compatibles. « Tâche déclenchée par événement » porte actuellement la mention beta ; vos retours de problèmes et suggestions pendant l'utilisation sont les bienvenus.
Téléchargement du paquet d'installation : https://down.phpts.com/phpts.zip
Comments 1 comments