cli_set_process_title

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

cli_set_process_title — Устанавливает заголовок процесса

Описание

function cli_set_process_title(string $title): bool

Устанавливает заголовок процесса, видимое утилитами top и ps. Эта функция доступна только в режиме CLI.

Список параметров

title
Новое имя.

Возвращаемые значения

Функция возвращает true, если выполнилась успешно, или false, если возникла ошибка.

Ошибки

Если команда не поддерживается вашей операционной системой, то будет вызвана ошибка уровня E_WARNING.

Список изменений

Версия Описание
8.5.0 Функция cli_set_process_title() теперь выдаёт ошибку уровня E_WARNING при установке слишком длинного заголовка процесса; раньше заголовок усекался.

Примеры

<?php
$title = "Мой потрясающий PHP-скрипт";
$pid = getmypid(); // вы можете использовать это, чтобы увидеть заголовок процесса в ps

if (!cli_set_process_title($title)) {
echo "Не удалось установить заголовок процесса для PID $pid...\n";
exit(1);
} else {
echo "Заголовок процесса '$title' для PID $pid был установлен!\n";
sleep(5);
}
?>

Смотрите также