⌛️ Как настроить production-ready логирование в PHP

Логи в проде — это не просто error_log(). Это структурированные данные, correlation ID, асинхронная запись и ротация. Разбираем пошаговую настройку.

1️⃣ Выбираем стек: Monolog

PHP де-факто стандарт для логирования — Monolog. Устанавливаем через Composer:

composer require monolog/monolog

Если на Laravel, уже есть из коробки. Если нет, то подключаем вручную.

2️⃣ Базовая конфигурация с JSON-форматом

use Monolog\Logger;
use Monolog\Handler\RotatingFileHandler;
use Monolog\Formatter\JsonFormatter;

$log = new Logger('app');

$handler = new RotatingFileHandler(
    __DIR__ . '/logs/application.log',
    maxFiles: 30,
    level: Logger::INFO
);

$handler->setFormatter(new JsonFormatter());
$log->pushHandler($handler);

JSON-формат удобен для парсинга в ELK / Grafana Loki.

3️⃣ Добавляем Correlation ID

Трекаем каждый запрос через Processor:

class CorrelationIdProcessor implements ProcessorInterface
{
    private string $correlationId;

    public function __construct()
    {
        $this->correlationId = $_SERVER['HTTP_X_CORRELATION_ID']
            ?? bin2hex(random_bytes(16));

        header('X-Correlation-ID: ' . $this->correlationId);
    }

    public function __invoke(array $record): array
    {
        $record['extra']['correlation_id'] = $this->correlationId;
        return $record;
    }
}

$log->pushProcessor(new CorrelationIdProcessor());

Теперь каждая строка лога привязана к конкретному запросу.

4️⃣ Ротация и лимиты

$handler = new RotatingFileHandler(
    filename: __DIR__ . '/logs/app.log',
    maxFiles: 30,
    level: Logger::WARNING,
);

Для ограничения по размеру связываем с logrotate на уровне системы:

# /etc/logrotate.d/php-app
/var/www/app/logs/*.log {
    daily
    rotate 30
    compress
    missingok
    size 100M
}

5️⃣ Асинхронная запись

PHP синхронный по природе, но можно буферизовать тяжёлые хендлеры:

use Monolog\Handler\BufferHandler;

$bufferHandler = new BufferHandler(
    handler: new StreamHandler('logs/app.log'),
    bufferSize: 100,
    flushOnOverflow: true
);

$log->pushHandler($bufferHandler);

Буферизуем записи и сбрасываем пачкой → меньше I/O операций.

6️⃣ Интеграция с мониторингом

Отправляем в Graylog через GELF:

use Monolog\Handler\GelfHandler;
use Gelf\Publisher;
use Gelf\Transport\UdpTransport;

$publisher = new Publisher(
    new UdpTransport('logstash.example.com', 12201)
);

$log->pushHandler(new GelfHandler($publisher));

Или напрямую в Telegram для критических ошибок. Отдельный хендлер, 5 минут работы.

📌 Итог

Monolog + JsonFormatter + CorrelationId + logrotate = логи, с которыми не стыдно идти в прод.

Библиотека пхпшника

⌨️ Топ-вакансий по PHP за неделю

PHP-разработчик — от 150 000 до 200 000 ₽ — удалёнка, гибрид (Москва)

PHP Developer FinTech — от 200 000 ₽ — гибрид (Санкт-Петербург)

Backend разработчик — от 480 000 ₽ — удалёнка

➡️ Еще больше топовых вакансий — в нашем канале PHP Jobs

🔧 Фишка PHP

array_walk_recursive + замыкание — обходим вложенные массивы без рекурсии вручную.

Часто видишь код, где разработчик пишет свою рекурсивную функцию для обхода многомерного массива. Но PHP уже давно умеет это из коробки.

$data = [
    'name' => '  John  ',
    'address' => [
        'city' => '  Berlin  ',
        'zip'  => '  10115  ',
    ],
];

array_walk_recursive($data, function (&$value) {
    if (is_string($value)) {
        $value = trim($value);
    }
});

// Все строки на любом уровне вложенности — обрезаны

Почему это удобно:

— Не нужно писать свой рекурсивный обход
— Работает с любой глубиной вложенности
— Передача по ссылке (&$value) позволяет менять данные на месте

Где применяется на практике:

— Санитизация входящих данных из форм / API
— Нормализация конфигов
— Очистка данных перед валидацией

💡 Помни: array_walk_recursive пропускает ключи-массивы и заходит внутрь — то есть колбэк вызывается только для скалярных значений. Это поведение стоит учитывать, если тебе нужно обрабатывать и промежуточные узлы.

Библиотека пхпшника

💡 Используй array_filter() без колбэка

Не все знают, что array_filter() без второго аргумента убирает все «пустые» значения автоматически:

php
$data = [0, '', null, false, 'hello', 42, [], 'world'];

$result = array_filter($data);

// ['hello', 42, 'world']

Удалит: 0, '', null, false, []
Оставит: всё, что приводится к true

⚠️ Ловушка: ключи сохраняются! Если нужен чистый массив — добавь array_values().

Используй это для очистки данных формы или фильтрации результатов из БД перед обработкой.

Библиотека пхпшника

#vardump

⚙️ Phiki

Phiki помогает подсветить синтаксис. Написан на PHP. Он использует файлы грамматики TextMate и темы Visual Studio Code для генерации кода с подсветкой синтаксиса для веба.

Название и публичный API Phiki во многом вдохновлены Shiki — пакетом, который делает примерно то же самое в экосистеме JavaScript. Реализация пакета также во многом вдохновлена vscode-textmate — мощным пакетом, лежащим в основе Visual Studio Code, Shiki и других инструментов.

🔗 Github

Библиотека пхпшника

#инструменты

💡 Используй array_map + array_filter с null колбэком для мультимерного flatten

Не городи рекурсию там, где достаточно одной строки через SPL или array_merge(...array_map(...)):

$matrix = [[1, 2, 3], [4, 5], [6]];

// ❌ Цикл или рекурсия
$result = [];
foreach ($matrix as $row) {
    foreach ($row as $item) {
        $result[] = $item;
    }
}

// ✅ Одна строка
$result = array_merge(...$matrix);
// [1, 2, 3, 4, 5, 6]

Но вот где реальная магия — когда нужно flatten + filter за раз:

$data = [[1, 0, 2], [null, 3], [false, 4, '']];

$result = array_values(
    array_filter(
        array_merge(...$data)
    )
);
// [1, 2, 3, 4]

⚠️ Ловушки

— array_merge(...$matrix) упадёт с ошибкой на пустом массиве [].
— Работает только для одного уровня вложенности.

📦 В продакшене это спасает при обработке сгруппированных результатов из БД, когда ORM отдаёт Collection[] и нужно быстро схлопнуть в плоский список.

Библиотека пхпшника

#vardump

⏳ Как устроена типизация в PHP 8.x?

PHP долго был языком с динамической типизацией и репутацией «всё приведётся само». Начиная с PHP 7, а особенно с версий 8.0–8.3, система типов стала по-настоящему выразительной.

🔍 Что появилось и зачем

🔹 Union Types (8.0)

Тип может быть одним из нескольких:

function process(int|string $id): User|null {
    // ...
}

Раньше это документировали только в PHPDoc и надеялись на лучшее.

🔹 mixed, never, void

▪️ mixed — явно говорит "любой тип", в отличие от отсутствия типа
▪️ never — функция никогда не вернёт управление (бросает исключение или завершает процесс)
▪️ void — функция ничего не возвращает

function redirect(string $url): never {
    header("Location: $url");
    exit();
}

🔹 Intersection Types (8.1)

Значение должно реализовывать все указанные интерфейсы одновременно:

function process(Serializable&Countable $data): void {
    // ...
}

Полезно при работе с коллекциями и DTO, которые соответствуют нескольким контрактам.

🔹 Enums (8.1)

Наконец-то нативные перечисления вместо констант в классах:

enum Status: string {
    case Active = 'active';
    case Inactive = 'inactive';
}

function setStatus(Status $status): void { ... }

Теперь нельзя передать произвольную строку туда, где ожидается Status.

🔹 Readonly properties (8.1) и readonly классы (8.2)

class User {
    public function __construct(
        public readonly int $id,
        public readonly string $name,
    ) {}
}

В 8.2 можно пометить весь класс как readonly — все свойства автоматически становятся иммутабельными. Отлично подходит для Value Objects и DTO.

🔹 DNF Types — Disjunctive Normal Form (8.2)

Комбинация union и intersection:

function handle(Countable&Iterator|null $collection): void {
    // ...
}

Тип читается как: "реализует оба интерфейса, либо null".

🔹 typed class constants (8.3)

class Config {
    const string VERSION = '1.0.0';
    const int MAX_RETRIES = 3;
}

До 8.3 константы классов не имели типов — теперь контракт полный.

⚠️ Нюансы

— declare(strict_types=1) обязателен, иначе PHP будет тихо приводить типы и "5" пройдёт там, где ожидается int
— Intersection types не работают с примитивами только с интерфейсами и классами
— readonly нельзя применить к static свойствам
— Enums не поддерживают наследование

Библиотека пхпшника

❓ Что такое Fibers в PHP 8.1 и чем они отличаются от async/await в других языках?

Fiber — примитив для кооперативной многозадачности. Позволяет приостановить выполнение функции в произвольной точке через Fiber::suspend() и возобновить позже, передав значение обратно.

Главное отличие от async/await: Fibers не заражают сигнатуры. В JS как только где-то await — вся цепочка выше должна быть async. В PHP Fiber::suspend() можно вызвать на любой глубине стека, не меняя сигнатуры вызывающих функций.

Второе отличие — Fibers это низкоуровневый примитив, event loop в них не встроен. Сами по себе они не дают параллелизма — это строительный блок, поверх которого ReactPHP, Revolt и Amp строят настоящую неблокирующую конкурентность.

👀 А вы говорите «спасибо» ИИ?

Иногда пишу нейронке «спасибо» на случай, если через 10 появится Skynet, для поддержания базовой грамотности рабочего диалога.

А вы как? Благодарите после удачного ответа или общаетесь с ИИ как с микроволновкой?

💬 Делитесь опытом, может через пару лет эти комментарии станут вашим алиби

🐸 Библиотека пхпшника

#междусобойчик

🔥 PDO vs MySQLi

Каждый рано или поздно задаёт себе вопрос:

«А почему мы вообще используем именно это?»

Чаще всего ответ → «так исторически сложилось». Но давай разберём более делательно.

🔹 MySQLi — быстрый, но привязанный

Работает только с MySQL/MariaDB. Зато даёт нативные async-запросы через mysqli_poll(), что редкость, но иногда критично.

$stmt = $mysqli->prepare("SELECT * FROM users WHERE id = ?");
$stmt->bind_param("i", $id);
$stmt->execute();

Синтаксис bind_param с типами — это боль при большом числе параметров.

🔹 PDO — абстракция с характером

Поддерживает 12+ драйверов: MySQL, PostgreSQL, SQLite, MSSQL, и др. Именованные плейсхолдеры — читаемость на уровне:

$stmt = $pdo->prepare("SELECT * FROM users WHERE id = :id AND role = :role");
$stmt->execute(['id' => $id, 'role' => $role]);

Одна нотация везде. Смена БД без переписывания логики запросов.

📊 Что реально важно на проекте

Смена БД когда-либо → PDO (без вариантов)
Legacy MySQL-проект → MySQLi уже там, не трогай
Нужен fetchAll в объекты → PDO::FETCH_CLASS чище
Производительность → разница < 1%, забудь

💡 Вердикт

MySQLi — это не "плохо". Это инструмент под конкретный стек.

Но если ты стартуешь проект с нуля или пишешь библиотеку, то лучше PDO. Любой ORM (Doctrine, Eloquent) под капотом использует именно его.

🐸 Библиотека пхпшника

#элементарный_выбор