PHP

Este artigo inclui exemplos de como configurar os seguintes aplicativos PHP para serem implantados nos serviços de hospedagem de aplicativos da Kinsta a partir de um repositório do GitHub:

Pré-requisitos

  • Os templates de início rápido da Kinsta são armazenados e gerenciados no GitHub; portanto, você precisa de uma conta no GitHub para acessá-los.
  • Você precisa criar uma conta MyKinsta para implantar o aplicativo.

PHP

  1. Você deve fazer login no GitHub e criar um novo repositório a partir desse template (Use this template > Create a new repository): Kinsta – Hello World – PHP.
  2. No MyKinsta, clique em Aplicativos > Adicionar aplicativo > selecione GitHub, clique em Conectar provedor git > Autorizar e faça login na sua conta do GitHub.
  3. Escolha o repositório Hello World PHP e um local de centro de dados. Deixe todas as outras configurações como padrão e clique em Continuar em cada etapa.
  4. Na etapa Resumo, clique em Implantar agora.

Durante a implantação, a Kinsta detecta automaticamente o Comando Start para o processo web e instala as dependências definidas em seu arquivo composer.json. O aplicativo estará disponível assim que a implantação for concluída e a página de boas-vindas da Kinsta será carregada na URL do seu aplicativo.

Página de boas-vindas da Kinsta após a implantação bem-sucedida do PHP.
Página de boas-vindas da Kinsta após a implantação bem-sucedida do PHP.

Você prefere assistir à versão em vídeo?

Configuração do servidor web

A Kinsta configura automaticamente um servidor web Apache que serve seu arquivo index.php a partir do diretório principal do projeto, da maneira usual. Crie um arquivo index.php na pasta do seu projeto como sua página de índice padrão.

Jigsaw

Este é um exemplo de como você pode configurar um site estático com o Jigsaw nos serviços de hospedagem de aplicativos da Kinsta a partir de um repositório do GitHub.

O Jigsaw é um framework de site estático que usa templates Blade para criar layouts de página e Markdown para criar seu conteúdo dentro dos templates, para que você possa produzir sites estáticos simples sem conhecimento complexo de codificação. Mais informações estão disponíveis no site do Jigsaw.

  1. Faça login no GitHub e crie um novo repositório a partir desse template (Use this template > Create a new repository): Kinsta – Jigsaw Starter.
  2. No MyKinsta, clique em Aplicativos > Adicionar aplicativo > selecione GitHub, clique em Conectar provedor git > Autorizar e faça login na sua conta do GitHub.
  3. Escolha o repositório do Jigsaw Starter e um local de centro de dados. Deixe todas as outras configurações como padrão e clique em Continuar em cada etapa.
  4. Na etapa Resumo, como você deve adicionar os buildpacks necessários antes da implantação, clique em Implantar mais tarde.
  5. Para que o aplicativo possa criar os arquivos CSS/JS, você precisa adicionar dois buildpacks: Node.js e PHP. Clique em Configurações > Adicionar buildpacks, selecione Node.js > Adicionar buildpacks. Repita isso para o PHP.
  6. Clique em Implantar agora > escolha a branch necessária > Implantar aplicativo.

O Jigsaw é baseado no Laravel; é um aplicativo baseado em PHP, portanto, durante a implantação, a Kinsta detecta automaticamente o Comando Start para o processo web e instala as dependências definidas no seu arquivo composer.json. O aplicativo estará disponível assim que a implantação for concluída, e uma página padrão do Jigsaw será carregada na URL do seu aplicativo.

Página padrão do Jigsaw após a instalação bem-sucedida.
Página padrão do Jigsaw após a instalação bem-sucedida.

Buildpacks

Na maioria dos casos, você desejará que o aplicativo crie os arquivos CSS/JS, portanto, precisará adicionar esses dois buildpacks:

  • Node JS
  • PHP

Configuração do servidor web

Comando Start

Quando você implanta o aplicativo, a Kinsta cria automaticamente um processo web com npm start como o Comando Start. Se necessário, você pode alterar isso em Processos.

Laravel

Este é um exemplo de como você pode configurar um aplicativo Laravel para implantar nos serviços de hospedagem de aplicativos da Kinsta a partir de um repositório GitHub.

  1. Você deve fazer login no GitHub e criar um novo repositório a partir deste template (Use this template > Create a new repository): Kinsta – Hello World – Laravel.
  2. O Laravel exige que você defina a variável de ambienteAPP_KEY. Você pode gerar uma chave de aplicativo localmente ou pode usar este gerador de chaves Laravel on-line.
  3. No MyKinsta, clique em Aplicativos > Adicionar aplicativo > selecione GitHub, clique em Conectar provedor git > Autorizar e faça login na sua conta do GitHub.
  4. Escolha o repositório Hello World Laravel e um local de centro de dados. Em Variáveis de ambiente, em Key 1, digite APP_KEY e, em Key 1, cole a chave gerada na Etapa 2, selecione Disponível durante o tempo de execução e Disponível durante o processo de build.
  5. Deixe todas as outras configurações como padrão e clique em Continuar em cada etapa. Na etapa Resumo, clique em Implantar mais tarde para adicionar os Buildpacks necessários antes da implantação.
  6. Para que o aplicativo possa criar os arquivos CSS/JS, você precisa adicionar dois buildpacks: Node.js e PHP. Clique em Configurações > Adicionar buildpacks, selecione Node.js > Adicionar buildpacks. Repita isso para o PHP.
  7. Clique em Implantações > Implantar agora > escolha a branch necessária > Implantar aplicativo.

O Laravel é um aplicativo regular baseado em PHP, portanto, durante a implantação, a Kinsta detecta automaticamente o Comando Start para o processo web e instala as dependências definidas no seu arquivo composer.json. O aplicativo estará disponível assim que a implantação for concluída e uma página padrão do Jigsaw será carregada na URL do seu aplicativo.

Página de boas-vindas da Kinsta após a implantação bem-sucedida do Laravel.
Página de boas-vindas da Kinsta após a implantação bem-sucedida do Laravel.

Você prefere assistir à versão em vídeo?

Conectar um banco de dados

Se você quiser conectar seu aplicativo a um banco de dados, comece criando um banco de dados no mesmo centro de dados em que seu aplicativo está.

  1. Adicione um banco de dados.
  2. Conecte o banco de dados ao aplicativo adicionando uma conexão interna e marcando a caixa de seleção Adicionar variáveis de ambiente… Isso preencherá automaticamente as variáveis de ambiente do banco de dados.
  3. Alguns dos nomes de variáveis (chaves) que o Laravel usa são diferentes dos criados automaticamente no MyKinsta. Edite as chaves das variáveis conforme necessário para corresponderem aos nomes das variáveis definidas no arquivo database.php do Laravel. Abaixo estão os nomes de variáveis correspondentes (chaves) para os tipos de banco de dados que o Laravel suporta.

Variáveis de ambiente

MySQL e PostgreSQL

Chave gerada automaticamenteChave do Laravel
DB_HOSTDB_HOST
DB_PORTDB_PORT
DB_NAMEDB_DATABASE
DB_USERDB_USERNAME
DB_PASSWORDDB_PASSWORD
DB_CONNECTION_URLDB_URL

Redis

Chave gerada automaticamenteChave do Laravel
DB_HOSTREDIS_HOST
DB_PORTREDIS_PORT
DB_NAMEREDIS_DB
DB_USERREDIS_USERNAME
DB_PASSWORDREDIS_PASSWORD
DB_CONNECTION_URLREDIS_URL

APP_KEY do Laravel

O Laravel exige que você defina a variável de ambiente APP_KEY. Se essa chave não estiver definida, você verá uma página de erro 500 exibida pelo Laravel. Você mesmo pode gerar uma chave de aplicativo localmente ou usar o gerador de chaves on-line do Laravel. Quando tiver uma chave, você poderá adicioná-la como uma variável de ambiente.

Buildpacks

Na maioria dos casos, você desejará que o aplicativo crie os arquivos CSS/JS, portanto, será necessário adicionar esses dois buildpacks:

  • Node.js
  • PHP

O buildpack que contém a linguagem principal do seu aplicativo deve ser o último na lista de buildpacks. Neste exemplo, PHP é a linguagem principal e deve ser o último buildpack na lista.

Configuração do servidor web

Comando Start

O processo web padrão é heroku-php-apache2. Este exemplo inclui um arquivo .htaccess que redireciona todas as solicitações para public/index.php para o Laravel. Se necessário, você pode alterar esse comando ao adicionar o aplicativo (Configurar seus processos) ou na página Processos do aplicativo após a implantação. Você pode usar:

heroku-php-apache2 /public

ou

php artisan serve --host 0.0.0.0 --port 8080

Leaf

Este é um exemplo de como configurar um aplicativo PHP do Leaf para ser implantado nos serviços de hospedagem de aplicativos da Kinsta a partir de um repositório do GitHub.

O Leaf é um framework PHP leve, focado na experiência do desenvolvedor, usabilidade e código de alto desempenho. Mais informações estão disponíveis no site do Leaf PHP.

  1. Você pode fazer login no GitHub e criar um novo repositório a partir deste template (Use this template > Create a new repository): Kinsta – Hello World – Leaf PHP.
  2. No MyKinsta, clique em Aplicativos > Adicionar aplicativo > selecione GitHub, clique em Conectar provedor git > Autorizar e faça login na sua conta do GitHub.
  3. Escolha o repositório Hello World – Leaf PHP e um local de centro de dados. Deixe todas as outras configurações como padrão e clique em Continuar em cada etapa.
  4. Na etapa Resumo, clique em Implantar agora.

Durante a implantação, a Kinsta detecta automaticamente o Comando Start para o processo web e instala as dependências definidas em seu arquivo composer.json. O aplicativo estará disponível assim que a implantação for concluída e a página de boas-vindas da Kinsta será carregada na URL do seu aplicativo.

Página de boas-vindas da Kinsta após a instalação bem-sucedida do Leaf PHP.
Página de boas-vindas da Kinsta após a instalação bem-sucedida do Leaf PHP.

Você prefere assistir à versão em vídeo?

Configuração do servidor web

Porta

A Kinsta define automaticamente a variável de ambiente PORT. Você não deve defini-la por conta própria e não deve codificá-la no aplicativo.

Comando Start

Ao implantar o aplicativo, a Kinsta cria automaticamente um processo web que executa heroku-php-apache2.

Ciclo de vida da implantação

Sempre que uma implantação é iniciada (por meio da criação de um aplicativo ou da reimplantação devido a um commit recebido), o comando composer install é automaticamente executado.

Statamic

Este é um exemplo de como configurar um aplicativo Statamic para ser implantado nos serviços de hospedagem de aplicativos da Kinsta a partir de um repositório do GitHub.

O Statamic é um CMS de arquivo simples que, por padrão, armazena todos os dados no repositório Git. Antes de você enviar o código para o MyKinsta, instalar o Statamic localmente é a abordagem recomendada para criar e manter seu site. Em seguida, crie uma conta de superusuário, confirme e envie todas as alterações para o repositório.

  1. Faça login no GitHub e crie um novo repositório a partir deste template (Use this template > Create a new repository): Kinsta – Statamic Boilerplate.
  2. O Statamic é baseado no Laravel, portanto, a variável de ambiente APP_KEY deve ser definida. Você pode gerar uma chave de aplicativo localmente ou pode usar este gerador de chave Laravel on-line.
  3. No MyKinsta, clique em Aplicativos > Adicionar aplicativo > selecione GitHub, clique em Conectar provedor git > Autorizar e faça login na sua conta do GitHub.
  4. Escolha o repositório Statamic Starter e um local de centro de dados. Em Variáveis de ambiente:
    1. Em Key 1, digite APP_KEY e, em Value 1, cole a chave gerada na Etapa 2.
    2. Clique em Adicionar outro e, em Key 2, digite APP_KINSTA e, em Value 2, digite true.
    3. Selecione Disponível durante o tempo de execução e Disponível durante o processo de build.
  5. Deixe todas as outras configurações como padrão e clique em Continuar em cada etapa. Na etapa Resumo, clique em Implantar mais tarde para adicionar os Buildpacks necessários antes da implantação.
  6. Para que o aplicativo possa criar os arquivos CSS/JS, você precisa adicionar dois buildpacks: Node.js e PHP. Clique em Configurações > Adicionar buildpack, selecione Node.js > Adicionar buildpack. Repita isso para o PHP.
  7. Clique em Implantações > Implantar agora > escolha a branch necessária > Implantar aplicativo.

O Statamic é baseado no Laravel; é um aplicativo regular baseado em PHP, portanto, durante a implantação, a Kinsta detecta automaticamente o Comando Start para o processo web e instala as dependências definidas no seu arquivo composer.json. O aplicativo estará disponível assim que a implantação for concluída, e a página de boas-vindas do Statamic será carregada na URL do seu aplicativo.

Página de boas-vindas do Statamic após a instalação bem-sucedida.
Página de boas-vindas do Statamic após a instalação bem-sucedida.

Você prefere assistir à versão em vídeo?

Variáveis de ambiente

O Statamic exige que você defina as seguintes variáveis de ambiente:

Buildpack

Na maioria dos casos, você desejará que o aplicativo crie os arquivos CSS/JS, portanto, será necessário adicionar esses dois buildpacks:

  • Node.js
  • PHP

O buildpack que contém a linguagem principal do seu aplicativo deve ser o último na lista de buildpacks. Neste exemplo, PHP é a linguagem principal e deve ser o último buildpack na lista.

Configuração do servidor web

Comando Start

O processo padrão da web é heroku-php-apache2 public/. Se necessário, você pode alterar esse comando ao adicionar o aplicativo (Configurar seus processos) ou na página Processos do aplicativo após a implantação.

PHP para enviar e-mails

Este é um exemplo de como você pode configurar um aplicativo PHP para enviar e-mails via SendGrid nos serviços de hospedagem de aplicativos da Kinsta, implantado a partir de um repositório do GitHub.

A Kinsta não suporta nativamente e-mails de saída de servidores. Ao enviar e-mails por meio de provedores de saída especializados, como SendGrid ou Mailchimp, você tem mais flexibilidade e taxas de sucesso mais altas para e-mails transacionais e de campanha.

  1. Você pode fazer login no GitHub e criar um novo repositório a partir deste template (Use this template > Create a new repository): Kinsta – Hello World – Envio de e-mail com PHP.
  2. No MyKinsta, clique em Aplicativos > Adicionar aplicativo > selecione GitHub, clique em Conectar provedor git > Autorizar e faça login na sua conta do GitHub.
  3. Escolha o repositório Hello World Email PHP e um local de centro de dados. Em Variáveis de ambiente, adicione o seguinte:
    • SENDGRID_API_KEY: A chave da API do SendGrid.
    • TEST_EMAIL_TO_ADDRESS: O endereço para o qual você deve enviar o e-mail de teste.
    • TEST_EMAIL_FROM_ADDRESS: O endereço de onde você deve enviar o e-mail de teste.
    • TEST_ENDPOINT: O endpoint a ser usado como um acionador para enviar o e-mail de teste. Use uma string aleatória de pelo menos 8 caracteres.
  4. Deixe todas as outras configurações como padrão e clique em Continuar em cada etapa. Na etapa Resumo, clique em Implantar agora.

O aplicativo estará disponível assim que a implantação for concluída, e uma página Hello World será carregada na URL do aplicativo.

E-mail PHP enviando a página Hello World após a instalação bem-sucedida.
E-mail PHP enviando a página Hello World após a instalação bem-sucedida.

Acionando um e-mail

Por meio de um entrypoint index.php muito simples, dois endpoints são expostos; todos os outros retornarão um erro 404:

  • /: Uma página simples que retorna a mensagem Hello World
  • /${TEST_ENDPOINT}: Uma página que aciona um e-mail de teste.

Para acionar um e-mail, encontre a URL da sua implantação na página Implantações, anexe o endpoint de teste a essa URL e visite a página. Por exemplo, se o seu TEST_ENDPOINT estiver definido como o34nifnodhni4of e a implantação mais recente estiver em https://example.kinsta.app, você poderá acionar um e-mail de teste em https://example.kinsta.app/o34nifnodhni4of no seu navegador.

Este artigo foi útil?