Pular para o conteúdo principal

​
🚀 Introdução

  • Antes de começar, certifique‑se de que o PHP está instalado no seu sistema. Se ainda não o tiver, você pode baixá‑lo no site oficial do PHP.
  • Em seguida, será necessário criar uma conta na Square Cloud, o que pode ser feito através da página de login. Você pode usar seu e‑mail, GitHub ou ambos para criar a conta.
  • Por fim, é necessário ter um plano pago ativo na sua conta. Você pode ver nossos planos e adquirir um conforme sua necessidade aqui.

​
⚙️ Criando o arquivo de configuração do squarecloud

Saiba mais: como criar o arquivo de configuração para a Square Cloud.

O arquivo squarecloud.app é um arquivo de configuração que será usado para configurar sua aplicação; ele servirá para definir nome, descrição, versão, arquivo principal, entre outras coisas.

​
📄 Arquivos Obrigatórios

  • index.php (Exemplo de arquivo principal).
  • composer.json (Arquivo de dependências opcional).
  • squarecloud.app (arquivo que contém a configuração da Square Cloud).

​
▶️ Iniciar a Aplicação

  • 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. 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 configuration parameters.
  • Se o arquivo composer.json existir, todas as dependências serão instaladas usando o comando php composer.phar install.

​
PHP com Swoole

  • Swoole é uma ferramenta que melhora o desempenho padrão do PHP possibilitando que o webserver atenda múltiplas requisições de assíncronamente.
  • Com esta ferramenta, você consegue criar microserviços, websockets, filas em segundo plano, entre outros. Ele também permite que execute eventos assim como o JavaScript permite.
  • Importante mencionar também que, o Swoole tem compatibilidade com outros frameworks PHP. Um bom exemplo de framework PHP é o Laravel que é compatível com o Swoole graças ao Octane.
  • Você pode usá-lo ao invés do server PHP padrão, definindo seu comando START personalizado. Exemplo: 
npm run build && composer install --no-interaction --prefer-dist --optimize-autoloader && php artisan optimize && php artisan migrate --force && php -v && php artisan octane:start --host=0.0.0.0 --port=80 --workers=4 --task-workers=8 --server=swoole
  • Você pode conferir todas as poderosas funções do Swoole aqui.

​
🖥️ Preparando o Projeto para Upload

Antes de hospedar seu projeto na Square Cloud, verifique se os arquivos do projeto estão corretamente configurados para hospedagem. Se seu projeto incluir um arquivo composer.json, a Square Cloud instalará automaticamente as dependências usando o Composer. Porém, se seu projeto também tiver dependências Node (ou seja, um package.json), você deve especificar o processo de instalação no campo START do seu arquivo squarecloud.app. Por exemplo: 
START=npm install && php .....
O arquivo de configuração (squarecloud.app/.config) deve estar localizado na raiz do arquivo zip. Caso contrário, a Square Cloud não conseguirá encontrá‑lo durante o deploy.

​
📤 Enviando o Projeto para a Square Cloud

Após preparar os arquivos do projeto, você pode enviá‑los para a Square Cloud e hospedar sua aplicação.
  • Envio via Dashboard
  • Envio via CLI
Acesse o Dashboard da Square Cloud e faça o upload dos arquivos do seu projeto.
Se você continuar enfrentando dificuldades técnicas, nossa equipe de suporte especializada está disponível para auxiliá-lo. Entre em contato conosco e teremos prazer em ajudá-lo a resolver qualquer questão.