PHP: полный мануал с примерами, функциями и ООП

<?php
declare(strict_types=1);

$data = ['deal_id' => 42];
$record = ['event' => 'crm-response', 'data' => $data];
echo json_encode($record, JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR), "\n";

{"event":"crm-response","data":{"deal_id":42}}

json_encode выполняет направление массив → JSON-текст. json_decode нужен для обратного направления: полученный JSON → данные PHP. Выбираем необходимые диагностические поля, а не записываем весь ответ с токенами или персональными данными.

<?php
declare(strict_types=1);

trait LogLine
{
    public function logLine(string $event, array $data): string
    {
        return json_encode(['event' => $event, 'data' => $data], JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR);
    }
}
class B24Client { use LogLine; }
class TelegramClient { use LogLine; }
echo (new B24Client())->logLine('crm-response', ['deal_id' => 42]), "\n";
echo (new TelegramClient())->logLine('telegram-result', ['message_id' => 7]), "\n";

{"event":"crm-response","data":{"deal_id":42}}
{"event":"telegram-result","data":{"message_id":7}}

Трейт сам не создаёт объект: new LogLine недопустим. use внутри класса включает реализацию logLine в этот класс. B24Client и TelegramClient не становятся родственниками и не получают общий внешний тип.

<?php
declare(strict_types=1);

trait IntegrationLog
{
    public function log(string $event, array $data): void
    {
        if (!in_array($event, ['crm-response', 'telegram-result'], true)) {
            throw new InvalidArgumentException('Неизвестное событие журнала');
        }
        $line = json_encode(
            ['event' => $event, 'data' => $data],
            JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR
        ) . "\n";
        $written = file_put_contents(__DIR__ . '/integration.log', $line, FILE_APPEND | LOCK_EX);
        if ($written !== strlen($line)) {
            throw new RuntimeException('Запись журнала не завершена');
        }
    }
}

class B24Client { use IntegrationLog; }
class TelegramClient { use IntegrationLog; }
$b24 = new B24Client();
$telegram = new TelegramClient();
$b24->log('crm-response', ['deal_id' => 42]);
$telegram->log('telegram-result', ['message_id' => 7]);
echo file_get_contents(__DIR__ . '/integration.log');

{"event":"crm-response","data":{"deal_id":42}}
{"event":"telegram-result","data":{"message_id":7}}

Самостоятельный запуск предполагает новый учебный каталог без старого integration.log. В начале проверяется событие, затем кодируется строка, затем она дописывается. strlen измеряет число байт; file_put_contents возвращает число записанных байт или false. Следующий запуск допишет ещё две строки: это назначение журнала. Не кладите сюда токены, пароли и полные ответы с личными данными.

<?php
declare(strict_types=1);

trait IntegrationLog
{
    public function log(string $event, array $data): void
    {
        if (!in_array($event, ['crm-response', 'telegram-result'], true)) {
            throw new InvalidArgumentException('Неизвестное событие журнала');
        }
        $line = json_encode(
            ['event' => $event, 'data' => $data],
            JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR
        ) . "\n";
        $written = file_put_contents(__DIR__ . '/integration.log', $line, FILE_APPEND | LOCK_EX);
        if ($written !== strlen($line)) {
            throw new RuntimeException('Запись журнала не завершена');
        }
    }
}

class B24Client { use IntegrationLog; }
$b24 = new B24Client();
try {
    $b24->log('../outside', ['deal_id' => 42]);
} catch (InvalidArgumentException $error) {
    echo $error->getMessage(), "\n";
}
try {
    $b24->log('crm-response', ['text' => "\xB1"]);
} catch (JsonException $error) {
    echo "Журнал отклонил некорректный UTF-8\n";
}
$b24->log('crm-response', ['deal_id' => 42]);
echo file_get_contents(__DIR__ . '/integration.log');

Неизвестное событие журнала
Журнал отклонил некорректный UTF-8
{"event":"crm-response","data":{"deal_id":42}}

in_array с true проверяет точное совпадение разрешённой строки. JSON_THROW_ON_ERROR не позволяет молча записать пустой результат кодирования. Некорректный UTF-8 показан намеренно. Рекурсивные структуры и ресурс тоже требуют политики отказа; не меняйте их на молчаливое удаление данных без объяснения.

<?php
declare(strict_types=1);

trait ClientLabel
{
    abstract protected function clientName(): string;
    public function label(string $message): string
    {
        return $this->clientName() . ': ' . $message;
    }
}
class B24Client
{
    use ClientLabel;
    protected function clientName(): string { return 'CRM'; }
}
echo (new B24Client())->label('Сделка 42 получена'), "\n";

CRM: Сделка 42 получена

clientName — явно видимая зависимость общего метода. Если потребитель её не предоставит и не останется abstract, объявление класса ошибочно. Для сложных зависимостей лучше отдельный сервис, переданный конструктору.

<?php
declare(strict_types=1);

trait ShortLabel
{
    public function label(): string { return 'Заказ 42'; }
}
trait DetailedLabel
{
    public function label(): string { return 'Заказ 42: Чай, 25900 коп.'; }
}
class OrderCard
{
    use ShortLabel, DetailedLabel {
        ShortLabel::label insteadof DetailedLabel;
        DetailedLabel::label as detailedLabel;
    }
}
$card = new OrderCard();
echo $card->label(), "\n";
echo $card->detailedLabel(), "\n";

Заказ 42
Заказ 42: Чай, 25900 коп.

insteadof выбирает реализацию label. as добавляет имя detailedLabel для другого метода; это не переименование с удалением исходного имени. as также умеет адаптировать видимость. Если не разрешить конфликт двух методов, класс нельзя корректно составить.

<?php
declare(strict_types=1);

trait ExportFormat
{
    public const FORMAT = 'csv';

    public function format(): string
    {
        return self::FORMAT;
    }
}

trait ExportPresentation
{
    use ExportFormat;

    public function label(): string
    {
        return 'Экспорт: ' . $this->format();
    }
}

class CsvReport
{
    use ExportPresentation {
        label as final;
    }
}

echo CsvReport::FORMAT, "\n";
echo (new CsvReport())->label(), "\n";

csv
Экспорт: csv

Константы трейтов поддерживаются с PHP 8.2; as final — с PHP 8.3. CsvReport получает оба уровня поведения. Final здесь запрещает потомку CsvReport переопределить импортированный label; собственное объявление метода непосредственно в потребителе трейта имеет отдельное правило приоритета.

<?php
declare(strict_types=1);

trait CountsRuns
{
    public static int $runs = 0;

    public static function record(): void
    {
        static::$runs++;
    }
}

class ParentImporter
{
    use CountsRuns;
}

class ChildImporter extends ParentImporter
{
    use CountsRuns;
}

ParentImporter::record();
ParentImporter::record();
ChildImporter::record();
echo 'Родитель: ', ParentImporter::$runs, "\n";
echo 'Потомок: ', ChildImporter::$runs, "\n";

Родитель: 2
Потомок: 1

Именно повторное use в дочернем классе создаёт отдельное свойство в PHP 8.3+. До 8.3 эта комбинация разделяла ячейку. Если потомок просто наследует поле без повторного use или своего объявления, нельзя по этому примеру заключать, что счётчики обязательно независимы.

<?php
declare(strict_types=1);

trait FormatsLine
{
    public function formatLine(string $title): string { return '[' . $title . ']'; }
}

class ReportPage
{
    use FormatsLine { formatLine as protected; }

    public function render(): string { return $this->formatLine('Заказы'); }
}

class AliasReportPage
{
    use FormatsLine { formatLine as private internalLine; }
}

$page = new ReportPage();
echo $page->render(), "\n";
try {
    $page->formatLine('Заказы');
} catch (Error $error) {
    echo "Исходный метод закрыт извне\n";
}
echo (new AliasReportPage())->formatLine('Заказы'), "\n";

[Заказы]
Исходный метод закрыт извне
[Заказы]

As protected без нового имени меняет видимость formatLine. As private internalLine добавляет закрытый псевдоним, а исходный public formatLine остаётся доступным. Ошибка ожидания «я сделал alias private и спрятал метод» может незаметно расширить API класса.

<?php
trait HasExportFormat { public string $format = 'csv'; }
class BrokenFormat {
    use HasExportFormat;
    public int $format = 1;
}

Намеренно неверный fixture. Для совместимого одноимённого свойства должны совпадать тип, видимость, readonly и начальное значение.

<?php
trait HasExportVersion { public const VERSION = 1; }
class BrokenVersion {
    use HasExportVersion;
    public const VERSION = 2;
}

Константы в трейтах доступны с PHP 8.2. Здесь имя VERSION совпало, а значения нет. Совместимость требует также совпадения видимости и final.

<?php
declare(strict_types=1);

$checks = [
    ['BadTraitProperty.php', 'define the same property', 'Конфликт свойства подтверждён'],
    ['BadTraitConstant.php', 'define the same constant', 'Конфликт константы подтверждён']
];
foreach ($checks as [$file, $diagnostic, $label]) {
    $process = proc_open(
        [PHP_BINARY, '-n', '-d', 'display_errors=stderr', __DIR__ . '/' . $file],
        [0 => ['pipe', 'r'], 1 => ['pipe', 'w'], 2 => ['pipe', 'w']],
        $pipes
    );
    if (!is_resource($process)) {
        throw new RuntimeException('Не удалось запустить учебную проверку');
    }
    fclose($pipes[0]);
    $output = stream_get_contents($pipes[1]);
    $errors = stream_get_contents($pipes[2]);
    fclose($pipes[1]);
    fclose($pipes[2]);
    $exitCode = proc_close($process);
    if ($exitCode === 0 || !str_contains($output . $errors, $diagnostic)) {
        throw new RuntimeException('Ожидаемая ошибка объявления не обнаружена');
    }
    echo $label, "\n";
}

Конфликт свойства подтверждён
Конфликт константы подтверждён

Это диагностический CLI-опыт с двумя сопутствующими файлами и proc_open. Ненулевой код завершения проверяется вместе с содержанием ошибки. Ни один неверный класс не загружается в процесс самого проверяющего сценария.

<?php
declare(strict_types=1);

interface ExportContract
{
    public const ?string FORMAT = null;
}
abstract class BaseExporter implements ExportContract {}
trait UsesJsonFormat
{
    final public const string FORMAT = 'json';
}
final class JsonExporter extends BaseExporter
{
    use UsesJsonFormat;
}

echo JsonExporter::FORMAT, "\n";
echo (new ReflectionClassConstant(JsonExporter::class, 'FORMAT'))
    ->getDeclaringClass()->getName(), "\n";

json
JsonExporter

Пример требует PHP 8.5; это не обещание того же поведения на прежних версиях с типизированными константами. Трейт включён в JsonExporter, поэтому Reflection указывает этот класс как место объявления итоговой константы. Базовый nullable string уточнён до string.