---
name: first-plan-lens-php
description: Stack lens para PHP. Use durante Discovery quando composer.json for detectado. Cobre Laravel, Symfony, Slim, Hyperf, Laminas, raw PHP. Identifica PSR compliance, ORM, padrões de fila.
version: 0.1.0
---

# Lens PHP

## Detecção fina

| Sinal | Variante |
|-------|----------|
| `artisan` na raiz | Laravel |
| `bin/console` + `symfony/framework-bundle` em deps | Symfony |
| `slim/slim` em deps | Slim |
| `hyperf/hyperf` em deps | Hyperf |
| `laminas/laminas-mvc` em deps | Laminas (Zend) |
| `index.php` em `public/` sem framework | Legacy / vanilla |
| `wp-config.php` | WordPress |

## Extração de padrões

### Composer

- PSR-4 autoload mappings (qual namespace -> qual pasta)
- Versão min de PHP (`require.php`)
- Dev dependencies relevantes (phpunit, phpstan, psalm, php-cs-fixer, rector)

### Estrutura

Laravel:
- `app/Http/Controllers`, `app/Models`, `app/Services`, `app/Repositories`
- `routes/{web,api,console,channels}.php`
- `database/migrations`, `database/seeders`, `database/factories`
- `config/`, `resources/`, `bootstrap/`

Symfony:
- `src/Controller`, `src/Entity`, `src/Repository`, `src/Service`
- `config/services.yaml`, `config/routes.yaml`
- `migrations/`

### Dependency Injection

- Laravel: container service, providers em `app/Providers/`, binding em `register()`
- Symfony: services.yaml, autowire, autoconfigure
- Manual em vanilla

### Errors

- Exceptions customizadas (extends Exception ou DomainException)
- Handler global (Laravel: `app/Exceptions/Handler.php`; Symfony: ExceptionListener)
- HTTP error mapping

### Validação

- Laravel: Form Requests em `app/Http/Requests/`, rules
- Symfony: Validator constraints / annotations
- Manual via if's

### ORM

- Eloquent (Laravel)
- Doctrine (Symfony)
- Query Builder direto
- PDO raw

### Testing

- PHPUnit (mais comum)
- Pest (alternativa moderna)
- Pasta `tests/` com `Unit`, `Feature`, `Integration`
- Factories Laravel / fixtures Doctrine
- Mocks com Mockery

### Filas / Mensageria

- Laravel: Horizon, jobs em `app/Jobs/`
- Symfony: Messenger
- Hyperf: AMQP, Kafka

### Static analysis

- PHPStan level configurado (8 = strict)
- Psalm
- PHP-CS-Fixer rules
- Rector rules

### PSR compliance

- PSR-12 (style) - verificar via php-cs-fixer config
- PSR-7 (HTTP messages) - check em libs como `slim/psr7`, `nyholm/psr7`
- PSR-15 (HTTP middleware)
- PSR-3 (logger interface)

### Logging

- Laravel: `Log` facade (Monolog underneath)
- Symfony: Monolog
- Configuração de canais

## Output em `.first-plan/`

Igual estrutura padrão. Atenção especial:
- `02-conventions/di.md` - container vs autowire vs manual
- `01-topology/boundaries.md` - rotas, jobs, comandos artisan/console

## Confidence rules

Aumentar:
- Configuração estática (phpstan.neon, .php-cs-fixer.dist.php) presente e respeitada
- PSR autoload bem formado em composer.json

Reduzir:
- Mistura de namespaces antigos (`include` direto) e PSR-4
- Migrations órfãs vs models que existem mas não têm migration

## Anti-padrões comuns

- `include`/`require` em vez de autoload
- `$_GET`, `$_POST` direto em handler
- SQL concatenado (em vez de prepared statement / ORM)
- Lógica em controller (Laravel - sinal de service ausente)
- God models (Eloquent model com 50+ métodos)