# guzzle

Задаёт стандарты работы с Guzzle в PHP: фабрики клиентов с таймаутами, middleware для повторов и совместимость с PSR-18.

- правило · `type=rule` · Cursor · ★ 3580
- Автор: sanjeed5
- Лицензия: CC0-1.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/sanjeed5/awesome-cursor-rules-mdc/tree/HEAD/rules-mdc/guzzle.mdc
- Обновлён: 2026-05-19
- HTML: https://affpapa.org/nevibecode/rules/guzzle

## Что делает

Правило инструктирует модель настраивать `GuzzleHttp\Client` через фабрику сервиса, а не плодить вызовы ad-hoc по всему коду. Клиент получает базовый `base_uri` и обязательные лимиты времени: общий `timeout` и `connect_timeout` для соединения. Без явных таймаутов сетевые запросы рискуют зависнуть навсегда.

Для сквозной логики правило предписывает использовать `HandlerStack` и стандартные middleware. Повторные попытки настраиваются через `Middleware::retry` с лимитом в три повтора и экспоненциальной задержкой от 100 мс при сбоях сети или ошибках 5xx. Токены авторизации добавляются централизованно через `Middleware::mapRequest`. Это избавляет методы сервисов от дублирования заголовков.

Если пишется SDK или пакет для других разработчиков, правило запрещает жёсткую привязку к Guzzle. Код должен зависеть от интерфейсов PSR-18 (`ClientInterface`) и PSR-17 (`RequestFactoryInterface`). При обработке ошибок правило требует ловить точечные исключения: `RequestException` для сбоев протокола и `ConnectException` при проблемах со связью.

## Установка

### Cursor (родная платформа)

**Вручную: положить файлы**
- Файл: `.cursor/rules/guzzle.mdc` — Во frontmatter: description, globs, alwaysApply

### Claude Code

**Вручную: положить файлы**
- Файл: `.claude/rules/guzzle.md` — Поле paths во frontmatter ограничивает файлы: globs из источника → paths

### Codex

**AGENTS.md**
- Codex читает AGENTS.md: вставьте текст правила туда

### GitHub Copilot

**Вручную: положить файлы**
- Файл: `.github/instructions/guzzle.instructions.md` — Поле applyTo задаёт, к каким файлам применять: globs из источника → applyTo

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/rules/guzzle.md`

### Cline

**Вручную: положить файлы**
- Файл: `.clinerules/guzzle.md`

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/sanjeed5/awesome-cursor-rules-mdc/tree/HEAD/rules-mdc/guzzle.mdc

## Когда брать
- настроить фабрику HTTP-клиента с едиными таймаутами и базовым URL
- внедрить middleware с экспоненциальным повтором запросов при ошибках 5xx
- подключить логирование запросов и ответов через HandlerStack
- переписать SDK на интерфейсы PSR-18 и PSR-17 вместо прямой зависимости от Guzzle

## Примеры запросов агенту
- Сделай фабрику Guzzle-клиента с таймаутом на коннект 5 секунд и логами
- Добавь middleware повторных попыток для сетевых сбоев и кодов 5xx
- Переведи HTTP-клиент нашего SDK на интерфейс PSR-18

## Похожие
- [wordpress-php-guzzle-gutenberg-cursorrules-prompt-](https://affpapa.org/nevibecode/rules/wordpress-php-guzzle-gutenberg-cursorrules-prompt.md) — правило · ★ 41028
- [aws-sdk-java-v2-core](https://affpapa.org/nevibecode/skills/aws-sdk-java-v2-core.md) — скилл · 3700 установок
- [effect](https://affpapa.org/nevibecode/skills/effect.md) — скилл · 2500 установок
- [vtex-io-client-integration](https://affpapa.org/nevibecode/skills/vtex-io-client-integration.md) — скилл · 1200 установок
- [php-pro](https://affpapa.org/nevibecode/skills/httpsgithubcomjeffallan-php-pro.md) — скилл · 15500 установок
- [php-best-practices](https://affpapa.org/nevibecode/skills/php-best-practices.md) — скилл · 3700 установок

Из того же набора: [sanjeed5/awesome-cursor-rules-mdc](https://affpapa.org/nevibecode/by/sanjeed5/awesome-cursor-rules-mdc.md) — 240 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md