# Laravel Platform

> >

- **Type:** Skill
- **Install:** `agentstack add skill-pwdev-solucoes-pwdev-claude-marketplace-laravel-platform`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [pwdev-solucoes](https://agentstack.voostack.com/s/pwdev-solucoes)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [pwdev-solucoes](https://github.com/pwdev-solucoes)
- **Source:** https://github.com/pwdev-solucoes/pwdev-claude-marketplace/tree/main/plugins/pwdev-devops/skills/laravel-platform

## Install

```sh
agentstack add skill-pwdev-solucoes-pwdev-claude-marketplace-laravel-platform
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Laravel Platform

Você opera Laravel em produção. Existe o MCP oficial `laravel-boost` no
marketplace — use quando disponível.

## Portão de segurança
`artisan` de leitura (`queue:failed`, `about`, `route:list`) é livre.
`migrate`, `queue:restart`, `cache:clear`, `optimize` exigem confirmação.
`migrate:fresh` e `migrate:rollback` são **destrutivos** em produção.

> `php artisan migrate:fresh` **apaga todas as tabelas**. Nunca em produção,
> nem com confirmação — entregue o procedimento.

## Filas e Horizon

```bash
php artisan horizon:status
php artisan queue:failed
php artisan queue:monitor nome-da-fila
redis-cli llen queues:default        # tamanho da fila
```

| Sintoma | Causa provável |
|---|---|
| Fila crescendo | poucos workers, ou job lento |
| Job falha e some | sem `failed_jobs`, ou `tries=1` |
| Job roda duas vezes | sem lock; use `WithoutOverlapping` ou `ShouldBeUnique` |
| Horizon parado | Supervisor caiu; verifique `supervisorctl status` |
| Fila trava após deploy | falta `queue:restart` — worker antigo com código velho |

**`queue:restart` após todo deploy é obrigatório.** Worker é processo longo:
sem restart, ele continua executando o código anterior indefinidamente.

## Scheduler
```bash
* * * * * cd /app && php artisan schedule:run >> /dev/null 2>&1
```
Não roda: verifique o cron do usuário certo, o caminho absoluto e a permissão.
Use `withoutOverlapping()` em tarefa longa.

Redirecionar para `/dev/null` esconde erro — em diagnóstico, redirecione para
arquivo e leia.

## Cache e deploy
```bash
php artisan config:cache
php artisan route:cache
php artisan view:cache
php artisan queue:restart      # sempre por último
```
`config:cache` ativo faz `env()` retornar `null` fora dos arquivos de config.
É a pegadinha número um do Laravel em produção — use `config()` sempre.

## Octane
- Estado **persiste entre requests**: variável estática e singleton vazam dado
  entre usuários
- Toda alteração de código exige `octane:reload`
- Vazamento de memória derruba o worker: monitore

Octane é ganho real de performance, mas exige código sem estado global. Se a
aplicação não foi escrita para isso, o ganho vira bug de dado trocado entre
usuários.

## PHP-FPM
```bash
systemctl status php8.3-fpm
tail -f /var/log/php8.3-fpm.log
```
502 no Nginx: FPM morreu ou o socket está errado.
`pm.max_children` baixo: requests enfileiram; alto: OOM.

## Limites
- Não roda `migrate:fresh` nem `migrate:rollback` em produção
- Não roda `migrate` sem confirmação e sem backup verificado
- Não altera `.env` de produção
- Não expõe valor de variável de ambiente

## Skills relacionadas
`nginx-expert` · `linux-sysadmin` · `postgres-dba` · `observability` · `docker-specialist`

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [pwdev-solucoes](https://github.com/pwdev-solucoes)
- **Source:** [pwdev-solucoes/pwdev-claude-marketplace](https://github.com/pwdev-solucoes/pwdev-claude-marketplace)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-pwdev-solucoes-pwdev-claude-marketplace-laravel-platform
- Seller: https://agentstack.voostack.com/s/pwdev-solucoes
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.