> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.squarecloud.app/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Como hospedar Laravel na Square Cloud (Octane)

# Como hospedar aplicações Laravel na Square Cloud

Hospedar Laravel na Square Cloud vai além de simplesmente subir o código. Para garantir que sua aplicação suporte um alto volume de requisições com baixa latência, nosso ambiente oferece suporte nativo ao **Swoole** via **Laravel Octane**, transformando o modo como o PHP processa as informações.

---

## 1. O Diferencial do Swoole

Tradicionalmente, o PHP inicia um novo processo para cada requisição, o que gera um "overhead" de memória e CPU. Ao utilizar o **Swoole** em nosso ambiente, a aplicação permanece na memória (bootstrapped), pronta para responder instantaneamente.

Isso resulta em:
*   Resposta de requisições em milissegundos.
*   Menor consumo de recursos do seu plano.
*   Capacidade de lidar com WebSockets e tarefas assíncronas nativamente.

---

## 2. O Script de Inicialização Ideal

Na Square Cloud, você pode automatizar todo o processo de preparação e início da aplicação em uma única linha de comando. Isso garante que, a cada reinicialização ou commit, seu ambiente esteja perfeitamente sincronizado.

### Exemplo de Comando de Início:
```bash
npm run build && composer install --no-interaction --prefer-dist --optimize-autoloader && php artisan optimize && php artisan migrate --force && php artisan octane:start --host=0.0.0.0 --port=80 --workers=4 --task-workers=8 --server=swoole
```

**O que este comando faz?**
1.  **`npm run build`**: Compila seus assets de frontend.
2.  **`composer install...`**: Instala as dependências de PHP otimizando o autoloader para produção.
3.  **`php artisan optimize`**: Limpa e gera o cache de rotas e configurações.
4.  **`php artisan migrate --force`**: Executa suas migrações de banco de dados automaticamente.
5.  **`php artisan octane:start`**: Inicia o servidor de alta performance na porta 80, utilizando 4 workers de processamento e 8 workers para tarefas pesadas.

## 4. Dicas de Performance

*   **Task Workers**: No comando de início, o parâmetro `--task-workers=8` permite que você envie tarefas pesadas (como envio de e-mails ou processamento de imagens) para o fundo, sem travar a resposta do usuário principal.
*   **Storage Simbólico**: Lembre-se de rodar o comando `php artisan storage:link` caso precise servir arquivos públicos da pasta `storage`. Você pode adicionar isso ao seu script de início.
*   **Cache com Redis**: Utilize uma instância de Redis na Square Cloud para gerenciar as sessões e o cache do Laravel para uma performance ainda mais extrema.