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

<?php
declare(strict_types=1);

interface Payment
{
    public function request(int $kopecks): string;
}
class InvoicePayment implements Payment
{
    public function request(int $kopecks): string
    {
        return 'Счёт на ' . $kopecks . ' коп.';
    }
}
$payment = new InvoicePayment();
echo $payment->request(25900), "\n";

Счёт на 25900 коп.

interface объявляет договор; implements связывает класс с ним. В интерфейсе после сигнатуры стоит ;, тела метода нет. Класс предоставляет тело. Этот пример формирует инструкцию и не списывает деньги.

<?php
declare(strict_types=1);

interface Payment
{
    public function request(int $kopecks): string;
}
class InvoicePayment implements Payment
{
    public function request(int $kopecks): string
    {
        return 'Счёт на ' . $kopecks . ' коп.';
    }
}
class CashOnDelivery implements Payment
{
    public function request(int $kopecks): string
    {
        return 'Получить при выдаче: ' . $kopecks . ' коп.';
    }
}
function checkout(Payment $payment, int $kopecks): string
{
    if ($kopecks < 1) {
        throw new InvalidArgumentException('Сумма должна быть положительной');
    }
    return $payment->request($kopecks);
}

echo checkout(new InvoicePayment(), 25900), "\n";
echo checkout(new CashOnDelivery(), 25900), "\n";

Счёт на 25900 коп.
Получить при выдаче: 25900 коп.

checkout знает только Payment. При смене исполнителя меняется аргумент в месте сборки, а проверка суммы и вызов request остаются прежними. Никакой общий родитель со случайными полями не требуется.

<?php
declare(strict_types=1);

class ProductCard implements JsonSerializable
{
    public function __construct(
        private string $title,
        private int $priceKopecks,
        private string $supplierNote
    ) {}
    public function jsonSerialize(): array
    {
        return ['title' => $this->title, 'price_kopecks' => $this->priceKopecks];
    }
}
$card = new ProductCard('Чай', 25900, 'Проверить упаковку');
echo json_encode($card, JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR), "\n";

{"title":"Чай","price_kopecks":25900}

Метод возвращает массив, не готовую JSON-строку: кодирует json_encode. JSON_UNESCAPED_UNICODE оставляет читаемую кириллицу, JSON_THROW_ON_ERROR превращает ошибку кодирования в исключение. Такой контроль представления не означает, что весь объект безопасно выдавать автоматически.

<?php
declare(strict_types=1);

interface Payment
{
    public function request(int $kopecks): string;
}
class InvoicePayment implements Payment
{
    public function request(int $kopecks): string
    {
        return 'Счёт на ' . $kopecks . ' коп.';
    }
}
class CashOnDelivery implements Payment
{
    public function request(int $kopecks): string
    {
        return 'Получить при выдаче: ' . $kopecks . ' коп.';
    }
}
function checkout(Payment $payment, int $kopecks): string
{
    if ($kopecks < 1) {
        throw new InvalidArgumentException('Сумма должна быть положительной');
    }
    return $payment->request($kopecks);
}

class UnavailablePayment implements Payment
{
    public function request(int $kopecks): string
    {
        throw new RuntimeException('Оплата временно недоступна');
    }
}
try {
    echo checkout(new UnavailablePayment(), 25900), "\n";
} catch (RuntimeException $error) {
    echo 'Заказ не подтверждён. ', $error->getMessage(), "\n";
}

Заказ не подтверждён. Оплата временно недоступна

Этот исполнитель намеренно моделирует отказ. Сценарий реально вызывает тот же checkout и получает исключение; это проверяет путь отказа без обращения к банку. Исключения в PHP не перечисляются в сигнатуре, поэтому договор ошибок надо описывать рядом с интерфейсом.

<?php
declare(strict_types=1);

interface HasCaption
{
    public string $caption { get; }
}

class LocalCaption implements HasCaption
{
    public function __construct(public string $caption) {}
}

class CrmCaption implements HasCaption
{
    public string $caption {
        get => 'CRM: ' . $this->title;
    }

    public function __construct(private string $title) {}
}

function printCaption(HasCaption $item): void
{
    echo $item->caption, "\n";
}

printCaption(new LocalCaption('Магазин'));
printCaption(new CrmCaption('Заявка 42'));

Магазин
CRM: Заявка 42

Get; в интерфейсе означает требование публичного чтения и не содержит реализации. LocalCaption выполняет его обычным публичным свойством, CrmCaption — хуком. Интерфейс не утверждает, что поле нельзя записывать: конкретный LocalCaption дополнительно разрешает запись.

<?php
declare(strict_types=1);

interface HasOrderNumber
{
    public function number(): string;
}

interface HasOrderTotal
{
    public function total(): int;
}

interface OrderDocument extends HasOrderNumber, HasOrderTotal
{
    public const FORMAT = 'text';
    final public const SCHEMA = 'order-v1';
}

class PrintableOrder implements OrderDocument
{
    public const FORMAT = 'csv';
    public function number(): string { return 'ORD-42'; }
    public function total(): int { return 240; }
}

function documentLine(OrderDocument $document): string
{
    return $document->number() . ';' . $document->total();
}

echo documentLine(new PrintableOrder()), "\n";
echo OrderDocument::FORMAT, ', ', PrintableOrder::FORMAT, "\n";
echo PrintableOrder::SCHEMA, "\n";

ORD-42;240
text, csv
order-v1

Extends у интерфейса перечисляет родительские договоры через запятую. Implements у класса означает выполнение требований. С PHP 8.1 обычную интерфейсную константу можно переопределить; final закрепляет SCHEMA. Константы не хранят уникальное состояние заказа.

<?php
interface CsvRule { public const FORMAT = 'csv'; }
interface JsonRule { public const FORMAT = 'json'; }
class AmbiguousReport implements CsvRule, JsonRule {}

Этот файл специально неверен. Он не предназначен для включения в рабочую программу. Следующий локальный проверочный запуск получает диагностический отказ отдельного PHP-процесса.

<?php
declare(strict_types=1);

$checks = [
    ['BadInterface.php', 'inherits both', 'Конфликт констант подтверждён']
];
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";
}

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

Нужен доступный proc_open и файл BadInterface.php рядом с main.php. Запускается только текущий PHP_BINARY и известный учебный файл: shell и пользовательские команды не участвуют. Родитель проверяет ненулевой код завершения и характерную диагностику; обычный try/catch внутри несовместимого класса такую ошибку объявления не исправляет.