Администрирование PHP: контроль статуса и производительности

Расширенные примеры кода и сценарии

В этом разделе приведены более детальные примеры с выводом, которые помогут глубже понять инструменты мониторинга статуса PHP.

Полный health check скрипт с параметрами

Скрипт проверяет версию PHP, наличие критических расширений, время выполнения и соединение с MySQL (если доступно).

<?php
header('Content-Type: application/json; charset=utf-8');

$result = [
    'php_version' => phpversion(),
    'extensions_loaded' => get_loaded_extensions(),
    'missing_required' => [],
    'memory_limit' => ini_get('memory_limit'),
    'execution_time' => ini_get('max_execution_time'),
    'upload_max_filesize' => ini_get('upload_max_filesize'),
    'time' => date('Y-m-d H:i:s'),
    'mysql_connection' => false
];

// Проверка необходимых расширений
$required = ['json', 'mysqli', 'mbstring', 'curl'];
foreach ($required as $ext) {
    if (!extension_loaded($ext)) {
        $result['missing_required'][] = $ext;
    }
}

// Проверка соединения с MySQL (если заданы переменные окружения)
$db_host = getenv('DB_HOST');
$db_user = getenv('DB_USER');
$db_pass = getenv('DB_PASS');
$db_name = getenv('DB_NAME');
if ($db_host && $db_user && $db_name) {
    try {
        $conn = new mysqli($db_host, $db_user, $db_pass, $db_name);
        $result['mysql_connection'] = $conn->connect_error ? false : true;
        $conn->close();
    } catch (Exception $e) {
        $result['mysql_connection'] = false;
    }
}

echo json_encode($result, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);

Пример вывода (при успешном выполнении):

{
    "php_version": "8.1.27",
    "extensions_loaded": [
        "Core",
        "date",
        "json",
        ...
        "mysqli",
        "mbstring",
        "curl"
    ],
    "missing_required": [],
    "memory_limit": "256M",
    "execution_time": "30",
    "upload_max_filesize": "64M",
    "time": "2025-03-15 14:22:10",
    "mysql_connection": true
}

Мониторинг статуса PHP-FPM через сокет с помощью скрипта на PHP

Скрипт подключается к Unix-сокету PHP-FPM, отправляет запрос на статус и парсит ответ.

<?php
$socketPath = '/run/php/php8.1-fpm.sock';
$statusPath = '/status';

$request = "GET $statusPath HTTP/1.0\r\nHost: localhost\r\n\r\n";
$socket = @stream_socket_client("unix://$socketPath", $errno, $errstr, 5);

if (!$socket) {
    echo "Ошибка подключения: $errstr ($errno)";
    exit(1);
}

fwrite($socket, $request);
$response = stream_get_contents($socket);
fclose($socket);

// Отделяем заголовки от тела
list($headers, $body) = explode("\r\n\r\n", $response, 2);

if (strpos($headers, '200 OK') === false) {
    echo "Статус-страница недоступна. Код: " . $headers;
    exit(1);
}

echo $body;

Пример фрагмента вывода (формат plain):

pool:                 www
process manager:      dynamic
start time:           15/Mar/2025:12:00:00 +0300
start since:          3600
accepted conn:        54321
listen queue:         0
max listen queue:     5
listen queue len:     128
idle processes:       5
active processes:    12
total processes:     17
max active processes: 20
max children reached: 0
slow requests:        2

Использование функции phpversion() с детальным выводом

Эта функция возвращает не только основную версию, но и дополнительную информацию через константу PHP_EXTRA_VERSION.

<?php
echo 'PHP Version: ' . phpversion() . "\n";
echo 'Full version string: ' . PHP_VERSION . "\n";
echo 'Extra info: ' . (defined('PHP_EXTRA_VERSION') ? PHP_EXTRA_VERSION : 'нет') . "\n";
echo 'Zend Engine Version: ' . zend_version() . "\n";
echo 'Operating System: ' . PHP_OS . "\n";

Результат на сервере с PHP 8.1.27 (пример):

PHP Version: 8.1.27
Full version string: 8.1.27
Extra info: нет
Zend Engine Version: 4.1.27
Operating System: Linux

Проверка загруженных расширений с деталями

Использование get_loaded_extensions(true) возвращает не только имена, но и Zend-расширения (опкодные кеши и т.п.).

<?php
$extensions = get_loaded_extensions(true);
echo "Загруженные расширения (всего " . count($extensions) . "):\n";
foreach ($extensions as $type => $extList) {
    echo "Тип [$type] (" . count($extList) . "): " . implode(', ', $extList) . "\n";
}

Вывод может содержать строку наподобие:

Загруженные расширения (всего 2):
Тип [Core] (1): Core
Тип [standard] (62): date, json, mbstring, mysqli, curl, ...

Мониторинг через внешние утилиты: пример с Nagios и check_phpfpm

Плагин check_phpfpm использует статусную страницу FPM. Команда проверки:

/usr/lib/nagios/plugins/check_phpfpm -H localhost -u /status -s unix:/run/php/php8.1-fpm.sock

Возможный результат (OK):

OK - PHP-FPM is running. Active processes: 12 | active=12 idle=5 total=17

При возникновении проблем (таймаут, недоступность) плагин вернет CRITICAL и сообщение об ошибке.