cli_set_process_title

(PHP 5 >= 5.5.0, PHP 7, PHP 8)

cli_set_process_title — Définit le titre du processus

Description

function cli_set_process_title(string $title): bool

Définit le titre du processus visible avec des outils comme top et ps. Cette fonction n'est disponible qu'en mode CLI.

Liste de paramètres

title
Le nouveau titre.

Valeurs de retour

Cette fonction retourne true en cas de succès ou false si une erreur survient.

Erreurs / Exceptions

Une alerte de niveau E_WARNING sera générée si le système sous-jacent n'est pas supporté.

Historique

Version Description
8.5.0 cli_set_process_title() émet désormais une alerte E_WARNING lorsque le titre du processus défini est trop long ; auparavant, le titre était tronqué.

Exemples

<?php
$title = "Mon super script PHP";
$pid = getmypid(); // il est possible d'utiliser ceci pour voir le titre du processus dans ps

if (!cli_set_process_title($title)) {
echo "Impossible de définir le titre du processus pour le PID $pid...\n";
exit(1);
} else {
echo "Le titre du processus '$title' pour le PID $pid a bien été défini !\n";
sleep(5);
}
?>

Voir aussi