O Laravel não é um CMS: é a base sobre a qual se escreve uma aplicação em PHP. Por isso este artigo tem duas metades. A primeira é para quem quer um esqueleto novo para começar; a segunda é para quem já tem uma aplicação escrita e a quer pôr aqui.
O instalador do cPanel tem duas séries do Laravel, e ambas pedem PHP 8.2 ou mais recente. Nenhuma lhe pede extensões a mais: tudo o que o Laravel exige já vem ligado numa conta nova.
A. Começar do zero, pelo instalador
| 2 |
Abra o Softaculous Apps Installer e procure Laravel.
|
|
| 3 |
Escolha o domínio, o protocolo https e a pasta.
|
|
| 4 |
Instale. O que fica lá é um projeto Laravel vazio, com o banco de dados criado e o arquivo de ambiente escrito. A partir daqui o código é seu.
|
|
|
O instalador é a maneira rápida de acertar a parte chata: o banco de dados, a chave da aplicação e as permissões das pastas de escrita. Mesmo quem vai depois substituir o código todo poupa tempo começando assim.
|
B. Trazer a sua própria aplicação
A dificuldade é sempre a mesma, e é esta: o Laravel serve o site a partir da pasta public, e não da raiz do projeto. As pastas com a configuração, o código e as chaves ficam um nível acima, e nunca devem ser alcançáveis pelo navegador.
| 1 |
Envie o projeto para a conta, por FTP ou pelo Gerenciador de Arquivos: contas FTP e o FileZilla. Não envie a pasta das dependências nem a pasta dos arquivos compilados.
|
|
| 2 |
Coloque o projeto FORA da pasta pública e aponte a pasta pública do domínio para a public do projeto. Se for um domínio adicional ou um subdomínio, isso escolhe-se ao criá-lo: acrescentar um domínio ou subdomínio.
|
|
| 4 |
Escreva o arquivo de ambiente com os dados da base, o endereço do site e a chave da aplicação. Sem chave, o Laravel recusa-se a iniciar.
|
|
| 5 |
Instale as dependências e rode as migrações pela linha de comandos. Precisa de acesso SSH: há contas com shell e contas sem.
|
|
| 6 |
Confirme que as pastas de escrita têm permissão. Se o site der erro 500 logo à primeira, é quase sempre isto ou a chave em falta. Veja os erros do site explicados.
|
|
|
Na linha de comandos, o php por padrão pode não ser a versão que escolheu para o site. Isto dá um resultado desconcertante: o site abre bem no navegador e as ferramentas de linha de comandos recusam-se a rodar, ou ao contrário. Use sempre o caminho completo da versão de PHP que escolheu, tanto ao instalar dependências como nas tarefas agendadas.
|
O agendador e as filas
Se a aplicação usa o agendador do Laravel, precisa de uma tarefa agendada a rodar a cada minuto, que chama o agendador dele. É assim que o Laravel foi desenhado: uma só entrada no cron, e o resto decide-se dentro do código. Veja tarefas agendadas, e não esqueça o caminho completo do PHP.
|
Filas com processos permanentes não são para hospedagem compartilhada. Um processo que fica rodando sem parar bate no teto de processos da conta e é interrompido. Se a aplicação precisa disso, o lugar dela é um servidor próprio: VPS, Cloud ou Dedicado. Sobre os tetos, veja os limites da conta.
|
Antes de pôr no ar
| 1 |
Desative o modo de depuração. Com ele ligado, qualquer erro mostra ao visitante o código, os caminhos e, por vezes, as credenciais da base.
|
|
| 2 |
Confirme que o arquivo de ambiente não é alcançável pelo navegador. Se o projeto ficou bem colocado, não é.
|
|
| 3 |
Ligue o acelerador do PHP. O opcache vem desligado numa conta nova e liga-se em Select PHP Version.
|
|
Para o que é comum a todas as instalações, veja instalar uma plataforma pronta. Se a sua aplicação é em outra linguagem, veja Django ou Ruby on Rails.
PRODUTO RECOMENDADO Alojamento de sites com cPanel Domínio e SSL incluídos, cópias diárias e o painel que já conhece. desde R$ 36,30/mês (plano de 3 anos, com cupom) Ver planos |
Angola
Brasil
Kenya
Moçambique
Nigeria
Portugal
South Africa
United Kingdom
United States
International
