cli_set_process_title

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

cli_set_process_title — Define el título del proceso

Descripción

function cli_set_process_title(string $title): bool

Define el título del proceso visible con herramientas como top y ps. Esta función solo está disponible en modo CLI.

Parámetros

title
El nuevo título.

Valores devueltos

Esta función retorna true en caso de éxito o false si ocurre un error.

Errores/Excepciones

Se generará una alerta de nivel E_WARNING si el sistema subyacente no es compatible.

Historial de cambios

Versión Descripción
8.5.0 cli_set_process_title() ahora emite una alerta E_WARNING al definir un título de proceso demasiado largo; antes el título era truncado.

Ejemplos

<?php
$title = "Mi super script PHP";
$pid = getmypid(); // puede utilizarse para ver el título del proceso en ps

if (!cli_set_process_title($title)) {
echo "No se puede definir el título del proceso para el PID $pid...\n";
exit(1);
} else {
echo "¡El título del proceso '$title' para el PID $pid ha sido definido correctamente!\n";
sleep(5);
}
?>

Ver también