PHPTime

Почему некоторые PHP-разработчики предпочитают статические API

Статические вызовы в PHP вызывают споры много лет: одни считают их удобным инструментом, другие — источником неявных зависимостей и боли при тестировании. На практике вопрос не в том, хороша ли статика сама по себе, а в том, как она изолирует состояние и насколько прозрачно устроен доступ к сервисам.

Откуда взялась привычка к статике

Поколение разработчиков, выросшее на CodeIgniter и Kohana, привыкло к коротким вызовам вида Input::get('foo'). Это было быстрее, чем тянуть сервис из контейнера или пробрасывать зависимость через конструктор. В проектах на CodeIgniter доступ к общим объектам часто строился через «суперобъект» и магический __get(): внутри модели вызов мог выглядеть как $this->session->userdata('id'), хотя на самом деле за этим скрывался поиск свойства через get_instance().

Когда появилась возможность писать статические методы, они стали выглядеть как более чистый синтаксис. Вместо привязки к экземпляру контроллера — прямой вызов класса. Коду, который не должен хранить состояние запроса, статика подходила внешне: взял значение, вернул результат, ничего не хранишь.

Что изменилось в PHP 8.3–8.5

Современные версии PHP не запрещают статические методы, но делают неявные состояния заметнее. Строгая типизация, readonly-классы, типизированные константы и first-class callable синтаксис позволяют писать статические API аккуратнее, чем в эпоху PHP 5.

PHP
<?php

declare(strict_types=1);

final readonly class Price
{
    public function __construct(
        public int $minor,
        public string $currency = 'RUB',
    ) {}

    public static function fromArray(array $data): self
    {
        return new self(
            minor: (int) ($data['minor'] ?? 0),
            currency: (string) ($data['currency'] ?? 'RUB'),
        );
    }
}

Здесь статический метод — это фабрика, а не доступ к глобальному состоянию. Такое применение вопросов не вызывает: нет скрытых зависимостей, нет сайд-эффектов, результат предсказуем.

Чем статический API удобен на практике

Не вся статика одинакова. Разработчики, которые осознанно выбирают статические вызовы, обычно ценят:

  • Короткую запись. Str::slug($title) читается быстрее, чем цепочка из контейнера и вызова метода.
  • Отсутствие лишнего кода. Не нужно описывать зависимость в конструкторе, если метод не требует состояния сервиса.
  • Простую навигацию по коду. Легко найти все вызовы конкретного класса.
  • Совместимость с фасадами. Фреймворки часто оборачивают контейнер так, что статический синтаксис остаётся, а под капотом работает DI.

Для инфраструктурных операций — логирование, форматирование, генерация slug, валидация изолированного значения — статика часто практичнее, чем создание цепочки объектов.

Где скрывается основная проблема

Сложности возникают, когда статический класс начинает хранить состояние или обращаться к другим сервисам неявно.

PHP
<?php

class Registry
{
    private static array $items = [];

    public static function set(string $key, mixed $value): void
    {
        self::$items[$key] = $value;
    }

    public static function get(string $key, mixed $default = null): mixed
    {
        return self::$items[$key] ?? $default;
    }
}

Такой код похож на глобальную переменную с синтаксическим сахаром. В обычном HTTP-запросе это может работать годами, но в долгоживущих процессах, асинхронных окружениях или при параллельных тестах состояние утекает между сценариями. Кроме того, если Registry::get() внутри обращается к конфигурации, базе данных или кешу, вы не увидите этого в сигнатуре метода.

Статика и внедрение зависимостей: конфликт или сосуществование

Чистый DI выглядит громоздко для коротких операций:

PHP
<?php

final class CreateArticleHandler
{
    public function __construct(
        private SlugGenerator $slugs,
        private ArticleRepository $articles,
    ) {}

    public function handle(CreateArticleCommand $command): Article
    {
        $slug = $this->slugs->fromTitle($command->title);

        return $this->articles->save(
            new Article($command->title, $slug)
        );
    }
}

Когда в проекте сотни команд и обработчиков, пробрасывать SlugGenerator в каждый конструктор утомительно. Поэтому разработчики часто выносят чистые функции в статические фабрики или утилиты, а сервисы с состоянием оставляют за DI.

PHP
<?php

final readonly class Slug
{
    public static function fromTitle(string $title): string
    {
        $slug = mb_strtolower(trim($title));
        $slug = preg_replace('/[^\p{L}\p{N}]+/u', '-', $slug);

        return trim($slug, '-');
    }
}

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

Фасады как компромисс

В Laravel статические вызовы вроде Cache::get('key') не являются статикой в классическом понимании. Фасад перенаправляет вызов на объект из контейнера. Это сохраняет короткий синтаксис и при этом позволяет подменять реализацию в тестах.

PHP
<?php

namespace App\Support\Facades;

use Illuminate\Support\Facades\Facade;

/**
 * @method static int increment(string $key): int
 */
class Counter extends Facade
{
    protected static function getFacadeAccessor(): string
    {
        return 'counter';
    }
}

Снаружи вызов Counter::increment('visits') выглядит как статика. Внутри это обращение к сервису counter из контейнера. Такая схема снимает претензию «статику нельзя мокать», но не отменяет другой риск: если за фасадом скрывается mutable-сервис, вы снова получаете доступ к глобальному состоянию, просто через элегантную обёртку.

Как выбирать между статикой и DI

Критерий Статический метод Внедрение зависимости
Зависимости Нет или только входные параметры Сервисы передаются явно
Состояние Не хранит Может управляться контейнером
Тестирование Простое, тесты изолированы Через моки и контейнер
Объём кода Минимальный Больше явных связей
Подмена реализации Затруднена без фасада Естественна через интерфейс

Правило простое: если метод чистый, без состояния и внешних сервисов — статика допустима. Если методу нужен конфиг, база, логгер или кеш — это работа для DI. Исключение — фасады, которые сохраняют синтаксис статики, но передают управление контейнеру.

Что говорить на код-ревью

Вместо спора «статика — зло» полезнее смотреть на конкретные признаки.

  • Статический метод не читает глобальное состояние и не обращается к другим статическим классам — ок.
  • Внутри вызывается база данных, сессия или конфиг — переписываем на DI.
  • Статическое свойство хранит данные между вызовами — почти всегда ошибка архитектуры.
  • Статика ради короткой записи, а под капотом фасад контейнера — допустимо, если команда понимает механизм.
  • Цепочки статических вызовов, зависящие от порядка выполнения, — красный флаг.

Чек-лист: когда статический API не создаст проблем

  • Метод принимает все данные через параметры и не читает глобальные переменные.
  • Результат зависит только от входных значений.
  • Метод не вызывает другие статические классы с состоянием.
  • Подключён declare(strict_types=1), указаны типы аргументов и возврата.
  • Для сервисов с состоянием используется контейнер или явные зависимости.
  • Если нужен короткий синтаксис для сервиса — используется фасад, а не настоящий статический класс.
  • Класс спроектирован как final readonly, если он не предназначен для наследования.
  • Тест статического метода не требует сброса глобального состояния.

Частые вопросы

Стоит ли использовать статические методы в современном PHP?

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

Почему статика мешает тестированию?

Настоящий статический класс трудно подменить, а его внутреннее состояние может сохраняться между тестами. Фасады и контейнер решают проблему подмены, но не отменяют риск скрытых mutable-зависимостей.

Чем Laravel-фасады отличаются от обычной статики?

Фасад — это синтаксис статики поверх DI-контейнера. Вызов <code>Cache::get()</code> внутри перенаправляется на объект, зарегистрированный в контейнере, поэтому его можно подменить в тестах.

Справка по теме

Ещё в разделе «Возможности PHP»

Релиз PHP 7: что изменилось и как перейти на PHP 8

Что изменилось в PHP 7: производительность, скалярные типы, типы возврата, операторы ?? и <=>. План перехода с PHP 7.x на PHP 8.3–8.5 с проверкой совместимости.

7 мин

Возможности PHP 5.6 и их развитие в PHP 8.x

Разбираем ключевые возможности PHP 5.6: variadic-функции, оператор **, импорт функций и константные выражения. Как это работает в PHP 8.3–8.5.

6 мин

Принцип открытости/закрытости в PHP

Как применять принцип открытости/закрытости в PHP. Сравнение наследования и композиции, абстракции и интерфейсы, типизированные коллекции, стратегии.

9 мин

Трейты в PHP и behaviors в Yii 2: что выбрать для модели

Сравниваем трейты PHP и behaviors Yii 2 на примерах PHP 8.3–8.5: абстрактные методы, свойства, конфликты имён, события модели и критерии выбора.

6 мин