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:

npm install && npm run build && 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 install && npm run build: Instala as dependências de frontend e compila seus assets. O runtime PHP só instala as dependências do Composer, e o upload remove a node_modules, por isso o npm install é necessário. Outra opção: rode npm run build localmente e envie a pasta public/build.
2. php artisan optimize: Limpa e gera o cache de rotas e configurações.
3. php artisan migrate --force: Executa suas migrações de banco de dados automaticamente.
4. php artisan octane:start: Inicia o servidor de alta performance na porta 80, utilizando 4 workers de processamento e 8 workers para tarefas pesadas.

Composer: a Square Cloud roda composer install sozinha antes de cada inicialização (envie composer.json e composer.lock). Adicione o Octane ao projeto com composer require laravel/octane antes de enviar.

3. 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.

Atualizado em: 04/10/2026