Este é um exemplo de como configurar um aplicativo Laravel para ser implantada nos serviços de Hospedagem de Aplicativos da Kinsta a partir de um repositório do GitHub.

O Laravel é um aplicativo regular baseado em PHP, portanto, durante o processo de implantação, a Kinsta instala automaticamente as dependências definidas no seu arquivo composer.json.

  1. Faça login no GitHub e crie um novo repositório a partir deste modelo (Usar este template > Criar um novo repositório): Kinsta – Hello World – Laravel.
  2. Laravel requer que a variável de ambiente APP_KEY seja definida. Você mesmo pode gerar uma chave de aplicativo localmente, ou você mesmo pode usar este gerador de chaves Laravel on-line.
  3. No MyKinsta, adicione um aplicativo com o repositório Hello World Laravel. Em Environment variables, em Key 1, digite APP_KEY, e em Value 1, cole a chave gerada no Passo 2, selecione Available during runtime e Available during build process.
  4. O comando Start pode ser deixado em branco para o processo web já que Kinsta detecta automaticamente o comando necessário durante a primeira implantação.
    Observação: A primeira implantação pode falhar porque você precisa adicionar os Buildpacks necessários.
  5. Para o aplicativo poder construir 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 esse processo para o PHP.
    O Buildpack que contém a linguagem principal do seu aplicativo deve ser o último na lista de Buildpacks. Neste exemplo, o PHP é a linguagem principal e deve ser o último Buildpack na lista.
  6. Clique em Implantação > Implantar agora, escolha a branch necessária > Implantar aplicativo.

O aplicativo estará disponível assim que a build terminar, 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 Laravel.
Página de boas-vindas da Kinsta após a implantação bem-sucedida do Laravel.

Prefere assistir à versão em vídeo?

Conectar um Banco de Dados

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

  1. Adicione um banco de dados.
  2. Conecte o banco de dados ao aplicativo adicionando uma conexão interna e selecionando a opção “Adicionar variáveis de ambiente…” (Add environment variables…). Isso preencherá automaticamente as variáveis de ambiente do banco de dados.
  3. Alguns dos nomes de variáveis (keys) que o Laravel utiliza são diferentes dos que são criados automaticamente no MyKinsta. Edite as chaves das variáveis conforme necessário para corresponder aos nomes de variáveis definidos no arquivo database.php do Laravel. Abaixo estão os nomes de variáveis correspondentes (chaves) para os tipos de banco de dados suportados pelo Laravel.

Variáveis de ambiente

MySQL e PostgreSQL

Chave Gerada Automaticamente Chave do Laravel
DB_HOST DB_HOST
DB_PORT DB_PORT
DB_NAME DB_DATABASE
DB_USER DB_USERNAME
DB_PASSWORD DB_PASSWORD
DB_CONNECTION_URL DB_URL


Redis

Chave Gerada Automaticamente Chave do Laravel
DB_HOST REDIS_HOST
DB_PORT REDIS_PORT
DB_NAME REDIS_DB
DB_USER REDIS_USERNAME
DB_PASSWORD REDIS_PASSWORD
DB_CONNECTION_URL REDIS_URL

 

APP_KEY do Laravel

Lembre-se de que o Laravel requer que a variável de ambiente APP_KEY seja definida. Se esta chave não estiver definida, você verá uma página de erro 500 servida pelo Laravel. Você mesmo pode gerar uma chave de aplicativo localmente, ou você pode usar o gerador de chaves on-line do Laravel. Uma vez que você tenha uma chave, você pode adicioná-la como uma variável de ambiente.

Buildpacks

Geralmente, você desejará que o aplicativo construa os arquivos CSS/JS, portanto, você precisará 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, o 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 Laravel. Se necessário, você pode alterar este comando ao adicionar seu aplicativo (Configure seus processos) ou na página de Processos do aplicativo após a implantação. Você pode usar:

  • heroku-php-apache2 /public
  • php artisan serve --host 0.0.0.0 --port 8080