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

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.
- Adicione um banco de dados.
- 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.
- 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