Hospede um site ou API em PHP

​

Antes de começar

• PHP na sua máquina. Se ainda não o tiver, baixe-o no site oficial do PHP.
• Uma conta na Square Cloud: cadastre-se com seu e-mail ou GitHub.
• Um plano ativo. Veja os planos e escolha o que combina com o seu projeto.

​

Configure a Square Cloud

MAIN=index.php
MEMORY=512
VERSION=recommended
DISPLAY_NAME=My website
SUBDOMAIN=mywebsite

​

O que a Square Cloud executa

• Se o campo START não estiver definido no arquivo de configuração, será iniciado um servidor PHP local com o comando php -S 0.0.0.0:80, com a raiz do seu ZIP como document root. Se o campo START estiver definido, o valor nele será executado diretamente. Para mais informações sobre os parâmetros do arquivo de configuração, visite parâmetros de configuração.
• Se o seu projeto tiver um composer.json na raiz, a Square Cloud roda composer install antes de cada inicialização, então você não precisa colocá-lo no START. Ela usa o composer.phar do seu ZIP quando houver um e, caso contrário, o Composer incluído no runtime. Envie também o composer.lock, para que o servidor instale as mesmas versões que você testou.

​

Porta e host

​

PHP com Swoole

• Swoole é uma ferramenta que melhora o desempenho padrão do PHP, permitindo que o servidor web atenda múltiplas requisições de forma assíncrona.
• Com esta ferramenta, você consegue criar microsserviços, websockets, filas em segundo plano, entre outros. Ele também permite executar eventos assim como o JavaScript.
• Vale mencionar também que o Swoole é compatível com outros frameworks PHP. Um bom exemplo é o Laravel, que é compatível com o Swoole graças ao Octane.
• Você pode usá-lo no lugar do servidor PHP padrão, definindo o seu comando START personalizado. Exemplo:

npm install && npm run build && php artisan optimize && php artisan octane:start --host=0.0.0.0 --port=80 --workers=4 --task-workers=8 --server=swoole

• Você pode conferir todas as funções do Swoole no manual do Swoole.

​

Prepare o projeto

​

Arquivos necessários

• squarecloud.app, na raiz do ZIP.
• index.php, ou o arquivo definido em MAIN.
• composer.json e composer.lock, quando você usa pacotes do Composer.

START=npm install && npm run build && php -S 0.0.0.0:80

​

O que deixar de fora

• O seu arquivo .env local: defina os seus segredos como variáveis de ambiente. O servidor padrão usa a raiz do ZIP como document root, então qualquer arquivo que você enviar ali pode ser baixado.
• vendor/: a Square Cloud a instala a partir do composer.json.
• node_modules/, quando o seu comando START a instala.

​

Guias de frameworks

​

Faça o deploy

​

Via dashboard

1

Acesse a página de upload

Acesse a página de upload e envie seu arquivo zip.

2

Configure seu ambiente

Após fazer o upload do seu arquivo zip, você precisará configurar o nome, o arquivo principal ou o ambiente de execução e outras configurações do seu projeto.
Se você estiver enviando um projeto web, certifique-se de selecionar “Publicação na Web” e definir um subdomínio para o seu projeto.

3

Faça o deploy do projeto

Por fim, clique no botão “Deploy” para hospedar seu projeto na Square Cloud. Após o deploy, você poderá monitorar o status e os registros do seu projeto no dashboard.

4

Confirme que seu app está no ar

Seu primeiro deploy geralmente leva menos de um minuto. No dashboard, aguarde o status da sua aplicação mudar para em execução e verifique os registros em busca de erros de inicialização.
Se você fez deploy de um site ou API, abra https://<seu-subdominio>.squareweb.app no navegador: você deve ver sua aplicação respondendo. Se você fez deploy de um bot, envie um comando para confirmar que ele está online.

Seu app não está iniciando? Veja o guia de solução de problemas para as causas e correções mais comuns.

​

Via CLI

curl -fsSL https://cli.squarecloud.app/install | bash

npm install -g @squarecloud/cli@latest

squarecloud auth login

squarecloud upload

squarecloud upload --file <caminho/para/zip>

squarecloud app status
squarecloud app logs

​

Próximos passos

​

Contate-nos