Почему некоторые 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
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
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
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
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
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> внутри перенаправляется на объект, зарегистрированный в контейнере, поэтому его можно подменить в тестах.