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

<?php
final class Product
{
    public function __construct(
        public string $name,
        public int $priceKopecks,
    ) {}

    public function priceLabel(): string
    {
        return number_format($this->priceKopecks / 100, 2, '.', ' ') . ' ₽';
    }
}

$tea = new Product('Чай', 34990);
echo $tea->name, ': ', $tea->priceLabel(), "\n";

Чай: 349.90 ₽

class описывает форму и поведение, new создаёт конкретный объект, __construct() принимает обязательное начальное состояние. Стрелка читает свойство или вызывает метод объекта; $this внутри метода означает именно текущий товар.

<?php
final class Stock
{
    public function __construct(
        private int $quantity,
    ) {
        if ($quantity < 0) {
            throw new InvalidArgumentException('Остаток не может быть отрицательным');
        }
    }

    public function reserve(int $amount): void
    {
        if ($amount < 1 || $amount > $this->quantity) {
            throw new DomainException('Недостаточно товара');
        }
        $this->quantity -= $amount;
    }

    public function quantity(): int
    {
        return $this->quantity;
    }
}

$stock = new Stock(5);
$stock->reserve(2);
echo 'Осталось: ', $stock->quantity(), "\n";

Осталось: 3

Закрытое свойство нельзя случайно изменить снаружи. Все изменения проходят через метод, который проверяет правило предметной области. Объект полезен здесь не ради короткого кода, а ради одного места, где защищается допустимое состояние.

<?php
interface Notifier
{
    public function send(string $message): string;
}

abstract class NamedNotifier implements Notifier
{
    public function __construct(protected string $recipient) {}

    protected function prefix(): string
    {
        return '[' . $this->recipient . '] ';
    }
}

final class TelegramNotifier extends NamedNotifier
{
    public function send(string $message): string
    {
        return $this->prefix() . $message;
    }
}

function notifyPaidOrder(Notifier $notifier, int $orderId): void
{
    echo $notifier->send("Заказ #$orderId оплачен"), "\n";
}

notifyPaidOrder(new TelegramNotifier('@shop'), 42);

[@shop] Заказ #42 оплачен

Потребитель зависит от маленького интерфейса, а общий код имени получателя вынесен в базовый класс. Наследник обязан сохранить совместимый публичный договор. Если общих данных и поведения нет, одной реализации интерфейса обычно достаточно.

<?php
interface Transport
{
    public function post(string $method, array $parameters): array;
}

final class FixtureTransport implements Transport
{
    public function post(string $method, array $parameters): array
    {
        return ['method' => $method, 'items' => [['ID' => 7, 'TITLE' => 'Заявка']]];
    }
}

final class B24Client
{
    public function __construct(private Transport $transport) {}

    public function listMethod(array $parameters, string $method): array
    {
        $response = $this->transport->post($method, $parameters);
        return $response['items'];
    }
}

$client = new B24Client(new FixtureTransport());
$result = $client->listMethod(['select' => ['ID', 'TITLE']], 'crm.deal.list');
echo $result[0]['ID'], ': ', $result[0]['TITLE'], "\n";

7: Заявка

Транспорт подставлен через конструктор, поэтому клиент не наследуется от HTTP-библиотеки и не привязан к её внутренним деталям. В рабочем адаптере вместо фикстуры будет Guzzle или cURL, а бизнес-код сохранит короткий вызов listMethod(). Это композиция: объект получает нужный инструмент как зависимость.

<?php
final class Money
{
    public const CURRENCY = 'RUB';

    private function __construct(public int $kopecks) {}

    public static function fromRubles(int $rubles): self
    {
        return new self($rubles * 100);
    }
}

$price = Money::fromRubles(350);
echo Money::CURRENCY, ' ', $price->kopecks, "\n";
echo Money::class, "\n";

RUB 35000
Money

:: обращается к члену самого класса: константе, статическому свойству или статическому методу. Money::class возвращает полное имя класса как строку и не создаёт объект. Для обычного метода конкретного экземпляра используется ->.

<?php
class Document
{
    public static function selfName(): string
    {
        return self::class;
    }

    public static function calledName(): string
    {
        return static::class;
    }
}

final class Invoice extends Document {}

echo Invoice::selfName(), "\n";
echo Invoice::calledName(), "\n";

Document
Invoice

self закреплено за классом, где записан метод. static использует класс фактического позднего вызова. parent:: явно обращается к реализации родителя. Позднее статическое связывание полезно фабрикам и наследуемым конфигурациям, но не должно скрывать зависимости приложения в глобальном статическом состоянии.