Este roteiro serve para publicar uma aplicação Laravel no miniCP a partir de um repositório Git. Nos exemplos, a conta é cliente, o domínio é exemplo.com.br e o PHP é 8.3.
1. Criar a conta e o banco
- Em Hospedagem > Usuários, clique em Novo Usuario, crie a conta
clientecom Shell Bash e clique em Criar. - Em Hospedagem > Bancos de Dados, clique em Novo banco no bloco Local.
- Nome do banco:
cliente_app. Dono (conta):cliente. - Acesso: Criar usuario novo, Host de acesso localhost, senha vazia para gerar.
- Clique em Criar e anote a senha.
2. Criar o domínio
- Em Hospedagem > Dominios, clique em Novo Dominio.
- Preencha:
| Campo | Valor |
|---|---|
| Dominio | exemplo.com.br |
| Aliases | www.exemplo.com.br |
| Tipo de aplicacao | PHP |
| Usuario | cliente |
| PHP | 8.3 (ou a versão exigida pelo projeto) |
| Document Root | public_html/public |
| Template da Aplicacao | Laravel |
| Arquivos iniciais | Desmarque os dois |
- Clique em Criar.
O Laravel publica só a pasta public. O restante do projeto, incluindo o .env, fica em public_html, fora do alcance do navegador.
3. Clonar o projeto
- Em Usuários, clique em Acessar como na conta
clientee abra Terminal. - Clone o repositório dentro de
public_html. Como o painel já criou a pastapublic, clone num diretório temporário e mova:
cd ~
git clone git@github.com:empresa/app.git app-tmp
rm -rf public_html && mv app-tmp public_html
cd public_html
cp .env.example .env
- Edite o
.envcom os dados do banco:
APP_URL=https://exemplo.com.br
DB_CONNECTION=mysql
DB_HOST=localhost
DB_DATABASE=cliente_app
DB_USERNAME=cliente_app
DB_PASSWORD=SENHA-ANOTADA
- Gere a chave:
php8.3 $(command -v composer) install --no-dev --optimize-autoloader
php8.3 artisan key:generate
Dica: para o
git clonefuncionar, cadastre uma chave SSH de deploy da conta (~/.ssh) no repositório.
4. Primeiro deploy
- Volte ao admin com Voltar ao Admin.
- Em Dominios, clique em Deploy (git pull + build) na linha do site.
- Clique no modelo Laravel.
- Como o document root é
public, acrescentecd ..na primeira linha:
cd ..
git pull
php8.3 $(command -v composer) install --no-dev --optimize-autoloader
php8.3 artisan migrate --force
php8.3 artisan config:cache
php8.3 artisan route:cache
php8.3 artisan view:cache
- Clique em Executar Deploy. O pipeline fica salvo para as próximas vezes.
5. Permissões
Em Usuários, clique em Aplicar permissoes nas pastas, escolha Sites e clique em Aplicar. O .env fica com 640 e o artisan continua executável.
6. Agendador do Laravel
- Acessar como a conta
clientee abra Cron Jobs. - Clique em Novo Cron Job e em A cada min.
- Comando:
cd /home/cliente/public_html && /usr/bin/php8.3 artisan schedule:run
- Clique em Adicionar.
7. Filas (opcional)
Se a aplicação usa filas, crie o worker em Servicos, no painel do cliente, com o comando php8.3 artisan queue:work.
Logs do servidor web: /home/cliente/logs/. Logs do Laravel: /home/cliente/public_html/storage/logs/.