Guia de Instalação de Scripts PHP com Instalador (/install) no CyberPanel

Introdução

Este guia ensina como preparar e instalar um script PHP que já possui um instalador próprio (/install) no CyberPanel. O objetivo é facilitar o processo para que qualquer pessoa, sem conhecimento técnico, consiga realizar a instalação corretamente. Este é um exemplo educacional para demonstrar como instalar scripts PHP de forma prática.

Passo 1: Criar o Banco de Dados no CyberPanel

Antes de iniciar a instalação do script, é necessário criar um banco de dados para armazenar as informações do sistema.

1. Acesse o CyberPanel:

   • Entre no CyberPanel com suas credenciais.

   • No painel inicial, clique em Databases (Banco de Dados) e depois em Create Database (Criar Banco de Dados).

2. Preencha os campos necessários:

   • Escolha o domínio: Selecione o domínio onde o script será instalado.

   • Nome do Banco de Dados: (exemplo: meuscript_db).

   • Usuário do Banco de Dados: (exemplo: meuscript_user).

   • Senha do Banco de Dados: Crie uma senha segura e anote-a para uso posterior.

3. Clique em Criar Banco de Dados.

Agora o banco de dados está pronto para ser usado na instalação do script.

Passo 2: Preparar os Arquivos no Computador

1. Obtenha os arquivos do script:

   • Certifique-se de que possui a pasta completa do script PHP que deseja instalar.

   • Se os arquivos foram baixados ou recebidos de outra pessoa, eles já devem estar organizados.

2. Compacte os arquivos corretamente:

   • Para facilitar a instalação, compacte apenas os arquivos dentro da pasta raiz do script, e não a pasta raiz em si.

   • Isso evita que, ao descompactar no CyberPanel, os arquivos fiquem dentro de uma pasta extra e precisem ser movidos manualmente.

   • Clique com o botão direito nos arquivos dentro da pasta raiz do script e escolha a opção "Enviar para" → "Pasta compactada" ou "Compactar".

   • Certifique-se de que o nome do arquivo ZIP não contém espaços ou números para evitar erros ao descompactar no CyberPanel.

   • Exemplo de nome correto: scriptphp.zip.

Passo 3: Enviar os Arquivos para o CyberPanel

1. Acesse o CyberPanel:

   • Abra seu navegador e entre no CyberPanel com suas credenciais.

   • Vá até a seção de gerenciamento de sites ou domínios.

2. Escolha o domínio onde deseja instalar o script:

   • Na lista de sites, clique no domínio correspondente (exemplo: seusite.com).

3. Acesse o Gerenciador de Arquivos:

   • Clique em "File Manager" ou "Gerenciador de Arquivos".

   • Isso abrirá uma interface onde você pode gerenciar os arquivos do seu site.

4. Faça o upload do arquivo compactado:

   • Clique no botão "Upload" ou "Enviar Arquivo".

   • Selecione o arquivo ZIP que você compactou (scriptphp.zip).

   • Aguarde o upload terminar completamente.

5. Extraia os arquivos no CyberPanel:

   • Após o upload, localize o scriptphp.zip na lista de arquivos.

   • Clique com o botão direito nele e escolha "Extract" ou "Extrair".

   • Como os arquivos já foram compactados corretamente sem uma pasta extra, eles serão extraídos diretamente na raiz do domínio.

Passo 4: Iniciar a Instalação pelo Navegador

1. Acesse o instalador do script:

   • No navegador, digite o endereço do seu site seguido de /install.

   • Exemplo: http://seusite.com/install.

2. Siga os passos do instalador:

   • A tela de boas-vindas será exibida.

   • Clique em "Iniciar Instalação" para prosseguir.

3. Aceite os termos de uso:

   • Leia e marque a opção "Aceitar os Termos".

   • Clique em "Avançar".

4. Verifique os requisitos:

   • O instalador checará automaticamente se todos os requisitos do servidor estão atendidos.

   • Caso tudo esteja correto, clique em "Prosseguir".

5. Configure o banco de dados:

   • Preencha os campos com as informações criadas anteriormente:

     • Host: localhost (padrão)

     • Porta: 3306

     • Nome do Banco: meuscript_db

     • Usuário: meuscript_user

     • Senha: (senha definida no CyberPanel)

   • Clique em "Avançar".

6. Crie as credenciais de administrador:

   • Defina os dados para login:

     • Nome de Usuário: (exemplo: admin)

     • Nome Completo: (exemplo: Seu Nome)

     • Email: (exemplo: seuemail@exemplo.com)

     • Senha: (crie uma senha forte)

   • Clique em "Instalar".

7. Aguarde o processo de instalação:

   • O instalador mostrará mensagens como "Configurando banco de dados..." e "Finalizando instalação...".

   • Aguarde alguns segundos até a instalação ser concluída.

Passo 5: Acessar o Sistema

1. Página Inicial:

   • Após a instalação, clique no link "Página Inicial" ou acesse seusite.com.

2. Área do Administrador:

   • Para acessar o painel administrativo, vá até seusite.com/admin.

   • Faça login com o usuário e senha que você criou durante a instalação.

Solução de Problemas

• Erro na licença:

  • Caso veja uma mensagem de "Licença inválida", verifique se preencheu corretamente os campos no instalador.

• Página não carrega:

  • Confirme que os arquivos foram extraídos corretamente no CyberPanel.

  • Verifique se o domínio está apontado corretamente para a pasta do script.

• Tela em branco após instalação:

  • Isso pode indicar um problema no servidor. Tente reenviar os arquivos e repetir o processo de instalação.

Conclusão

Agora você tem um script PHP instalado no CyberPanel de forma simples e prática. Esse método é válido para qualquer script que já possua um instalador via navegador (/install). Se encontrar dificuldades, consulte o suporte da sua hospedagem ou do fornecedor do script.

Por segurança, após concluir a instalação, é altamente recomendável excluir a pasta /install para evitar possíveis vulnerabilidades no site.

Além disso, se ao descompactar no CyberPanel os arquivos forem extraídos dentro de uma pasta adicional, será necessário movê-los manualmente para a raiz do domínio. Para evitar esse problema, sempre compacte apenas os arquivos dentro da pasta raiz do script, e não a pasta inteira.

Este guia foi criado para ensinar um processo genérico de instalação de scripts PHP e pode ser adaptado conforme necessário.