Chaque réglage est une variable d'environnement

Adresse et port du serveur HTTP principal.

Répertoire racine pour servir les fichiers et les scripts PHP.

Script d'entrée canonique unique. Non défini = mappage direct des fichiers, *.php = contrôleur frontal, non-.php = fallback SPA ; en mode worker — le bootstrap du worker. Résolu par rapport à DOCUMENT_ROOT.

Active le mode worker persistant. Nécessite qu'ENTRY_FILE pointe vers un script .php.

Nombre maximal de connexions TCP simultanées. Sert aussi de plafond au QUEUE_MAX_WAITING par défaut (sa moitié) ; une valeur malformée est une erreur au démarrage. À garder au-dessus de PHP_WORKERS + QUEUE_CAPACITY + QUEUE_MAX_WAITING.

Threads d'E/S asynchrones. 1 = mono-thread, N = nombre fixe, non défini = auto. Partage les cœurs avec PHP_WORKERS — le porter au nombre total de cœurs coûte généralement du débit. CPU compte les cœurs sur lesquels le processus peut s'exécuter (masque d'affinité, abaissé à un quota cgroup), et non un poids CPU ni une limite qu'une plateforme impose hors du conteneur ; la ligne de démarrage CPU count for default sizing indique ce qui a été compté.

Backend d'exécution PHP : sapi pour du vrai PHP, stub pour le benchmark sans PHP.

Taille du pool de workers. N = pool fixe, MIN:MAX = mise à l'échelle dynamique, 0 = auto. Le dimensionnement auto compte les CPU comme TOKIO_WORKERS — sur une offre dont le conteneur ne voit pas la limite CPU (cpu_source: host dans le log de démarrage), définissez les deux explicitement.

Secondes pendant lesquelles un worker dynamique reste inactif avant d'être retiré. Le retrait attend un moment sans rien en cours, si bien que les requêtes en vol ne sont jamais interrompues.

Nombre maximal de requêtes en attente dans la file PHP ; les arrivées sur une file pleine attendent jusqu'à QUEUE_WAIT_TIMEOUT_MS. 0 = auto. Pour les pools MIN:MAX, les workers initiaux = le minimum.

Plafond de la durée pendant laquelle une requête peut attendre un worker PHP avant un 529 — une seule échéance couvrant l'attente d'une place dans la file et dans la file. En surcharge, le serveur la raccourcit de lui-même (jusqu'à 1/64, min 10 ms) ; oxphp_admission_wait_budget_us indique la valeur en vigueur. 0 = rejeter dès que la file est pleine.

Nombre maximal de requêtes stationnées en attente d'une place dans la file ; au-delà, 529 immédiat. Chaque requête en attente détient une connexion et son corps mis en tampon. 0 = auto.

Nombre maximal d'octets de corps de requête détenus par l'ensemble en attente ; un corps qui le dépasserait reçoit un 529 immédiat, les requêtes sans corps continuent d'attendre. 0 = auto.

Plafond mémoire par worker en Mio avant recyclage. 0 = illimité. Les workers sont aussi recyclés après trois requêtes consécutives qui ont mal tourné, ou à la demande via Worker::scheduleExit().

Construit $_SERVER et $_GET avant chaque script. Falsy = ce travail est sauté ; $_POST, $_FILES, $_COOKIE et php://input ne sont pas affectés.

Protection contre le clickjacking : SAMEORIGIN, DENY ou off. Définit X-Frame-Options + CSP frame-ancestors sur chaque réponse ; les en-têtes définis par l'application l'emportent toujours. Les valeurs invalides retombent sur SAMEORIGIN avec un avertissement au démarrage.

Proxys de confiance : un mélange, séparé par des virgules, de CIDR, d'IP nues et des mots-clés private et cloudflare. Adresse IP réelle du client extraite de Forwarded / X-Forwarded-* via l'entrée la plus à droite non approuvée ; avec cloudflare, de CF-Connecting-IP lorsque la requête est passée par un serveur edge de Cloudflare.

Motifs glob dont les fichiers .php ne s'exécutent jamais via une URI directe (/uploads/**). Comparés avant toute E/S disque — aucun oracle d'existence.

Réponse en cas de correspondance PHP_DENY_PATHS ou de règle de refus .oxphpdeny : un statut HTTP 400–599 ou un script PHP de repli préfixé par / dans DOCUMENT_ROOT. En mode worker, les règles de refus .oxphpdeny n'acceptent qu'un code de statut.

Chemins absolus sous lesquels les liens symboliques peuvent sortir de DOCUMENT_ROOT. Non défini = aucune sortie autorisée.

Remplacements opt-in, suspendant la Fiber, de fonctions natives bloquantes. Catégories : sleep (sleep/usleep natifs), streams (lectures tcp:// bloquantes et stream_select), net (établissements de connexion, poignées de main et lectures TLS, écritures en attente de place dans le tampon, lectures unix:// / udp:// / udg:// — nécessite streams, Linux uniquement). 1/true/all = toutes les catégories. L'ensemble installé apparaît comme runtime_hooks dans /config.

Threads worker asynchrones dédiés. 0 = fonctions enregistrées mais levant AsyncException à l'appel.

Nombre maximal de tâches en attente dans la file asynchrone. 0 = auto.

Limite par worker de Fibers de tâches concurrentes ; limite globale en cours = Fibers × workers.

Interrupteur principal pour l'ensemble du sous-système OxPHP\Shared\*. Désactivé = ses classes ne sont pas enregistrées du tout ; protégez-vous avec class_exists().

Limite globale sur les objets Shared vivants (les clés de Map ne comptent pas) ; en créer un au-delà lève CapacityException.

Limite globale sur la mémoire estimée des objets Shared, vérifiée uniquement à la création d'un objet.

Active ou désactive l'exposition Prometheus oxphp_shared_*.

Active ou désactive l'API d'introspection /__ox_shared/*.

Aperçus des valeurs dans les réponses d'introspection ; à désactiver si les aperçus peuvent divulguer des données.

Profondeur BFS pour la détection de cycles ; à augmenter pour les graphes profonds.

Arêtes parcourues lors de la détection de cycles ; à augmenter pour les graphes denses.

Limite de taille par valeur ; les insertions plus grandes échouent immédiatement.

Limite de charge utile totale par canal.

Détecteur d'interblocage pour Shared\Mutex : off, warn (journalise et compte les cycles) ou strict (les rompt avec DeadlockException). Les builds de débogage utilisent strict par défaut.

Fréquence d'analyse du détecteur d'interblocage, en ms.

Troncature par chaîne dans les aperçus, en octets, coupée à une frontière de caractère.

Entrées échantillonnées dans les aperçus /entry.