Central de Ajuda

Leia isto primeiro

Como pedir ajuda

Antes de entrar em contato para obter suporte, leia atentamente o seguinte:

  • A resposta para o seu problema pode estar aqui, nos tutoriais ou na documentação.
    Por favor, reserve um tempo para procurá-la antes de nos contatar.
  • Para ajudar você, precisamos entender e ser capazes de reproduzir o seu problema.
    O PHP CRUD Generator não tem nenhum bug conhecido até o momento, e os problemas encontrados se devem, em sua maioria, à configuração do seu servidor, à estrutura do seu banco de dados ou a outros parâmetros relacionados ao seu projeto.

    Por isso, é essencial nos fornecer todas as informações de que podemos precisar:

    • Acesso FTP
    • URL do CRUD Generator
    • URL de administração
    • Logins e senhas
    • Acesso à administração do servidor, se necessário (cPanel)

    Portanto, por favor entre em contato conosco e envie-nos as informações necessárias; faremos o nosso melhor para ajudar você de forma rápida e eficiente.

    Se, por qualquer motivo, você se recusar a nos fornecer as informações necessárias, talvez não consigamos ajudá-lo de forma eficaz. Nesse caso, nenhuma solicitação de reembolso será aceita, exceto em casos especiais.

Erros de PHP e problemas de configuração do servidor

Qualquer programa PHP pode gerar erros que dependem do seu servidor: versão do PHP, extensões ativadas, definição de variáveis globais, ...

Aqui estão algumas recomendações que ajudarão você em muitos casos:

  1. Ative a exibição de erros do PHP

    • Localize e edite o seu arquivo php.ini arquivo
    • Localize a diretiva display_errors e ative-a
    • Atualize sua página para ver a mensagem de erro, isso ajudará a entender de onde vem o erro.
  2. Página em branco / Problemas de caminhos & URLs

    Primeiro passe display_errors On (veja #1 acima)

    O PHPCG usa algumas constantes para detectar os caminhos e URLs que levam às pastas do PHPCG.
    Um arquivo de teste está disponível para visualizar e depurar os valores do seu servidor:

    1. Abra install/server-test.php no seu editor de código
    2. L.15: Substitua 'AUTHORIZE', false por 'AUTHORIZE', true para desativar a proteção
    3. Abra o arquivo no seu navegador a partir do seu servidor PHP

    Você verá as constantes principais, as descrições dos valores esperados e os valores reais do seu servidor.

    A solução será revisar as configurações do seu servidor, ou entrar em contato conosco se precisar de mais ajuda.

  3. Teste e ative a extensão PHP cUrl se necessário

    O PHPCG requer que a extensão cUrl esteja ativada.

    Abra install/curl-test.php no seu navegador.
    Se você não vir a mensagem de sucesso você tem um problema com a extensão cUrl.
    A mensagem exibida dirá o que está errado e como resolver.

    A solução pode ser ativar sua extensão cUrl a partir do php.ini, configurar seu firewall, ou pode ser uma mensagem retornada pelo cUrl.

  4. Conexão com o banco de dados

    Veja como testar suas configurações de conexão com o banco de dados:

    1. Abra install/db-connection-test.php no seu editor de código
    2. Substitua 'host', 'user', 'pass', 'dbname', 'dbtable' pelas suas configurações de conexão
    3. Abra o arquivo no seu navegador a partir do seu servidor PHP

    Você verá a consulta enviada ao seu banco de dados.
    Se a conexão for bem-sucedida, você verá uma lista com as colunas da sua tabela.
    Caso contrário, suas configurações de conexão provavelmente estão erradas, tente alterá-las.

    Verifique também seu firewall, que pode estar bloqueando o acesso.

Licenciamento & Registro

O PHP CRUD Generator é protegido por um sistema de licença: 1 licença = 1 domínio + qualquer subdomínio desse domínio.

A licença é uma ativação única: você insere sua chave de licença uma vez, em cada domínio, e o código gerado nunca exige nenhum outro registro.

Você obtém sua chave de licença no seu portal do cliente Polar ou no e-mail de confirmação do pedido enviado após a sua compra.

Como ativar

  1. Copie sua chave de licença do seu portal do cliente Polar ou do e-mail de confirmação do seu pedido.
  2. Abra /install/do-install.php no seu navegador e vá para a etapa Ativação da licença do assistente de instalação.
  3. Cole sua chave de licença e o endereço de e-mail usado na compra, depois envie o formulário.
Seu servidor de desenvolvimento e seu servidor de produção devem ser ativados separadamente - cada um usa uma das 2 ativações da sua licença.
Se você mover seu projeto para outro domínio, desative primeiro o domínio antigo no seu portal do cliente Polar - depois execute a ativação novamente no novo domínio.

Verificações de licença

Após a ativação, a instalação realiza verificações automáticas de licença, no máximo uma vez a cada 24 horas, para garantir que sua licença ainda seja válida.

Se o seu servidor não conseguir acessar o servidor de licenças por algumas verificações, um período de tolerância permite que a instalação continue funcionando antes que os formulários sejam desativados. Veja Seu servidor não consegue acessar o servidor de licenças.

Solução de problemas: você pode exibir o estado atual da licença em qualquer página adicionando define('PHPFB_LICENSE_DEBUG', true); antes da primeira chamada new Form() no seu script.

Erros de instalação

Não é possível estabelecer conexão com o servidor remoto

O sistema de licença tenta enviar uma requisição cUrl para o servidor de licenças (api.polar.sh), e a requisição falha no seu servidor.

  1. Abra /install/do-install.php no seu navegador e tente a ativação novamente.
    O instalador exibirá uma mensagem de erro explícita explicando por que a conexão falhou.
  2. Copie / Cole a mensagem de erro em uma pesquisa do Google, você encontrará muitas pessoas que tiveram o mesmo problema antes de você e que explicarão como resolvê-lo.

Esses problemas estão relacionados à configuração do seu servidor (geralmente restrições de firewall, ou a porta 443 está fechada, ...).
Não há nada específico e nada de errado com o PHPCG. Seu servidor deve estar corretamente configurado para enviar requisições cUrl.

Se você estiver em hospedagem compartilhada, deve entrar em contato com seu provedor de hospedagem e pedir para desbloquearem as requisições cUrl


Seu limite de ativações foi atingido

Infelizmente, a instalação falhou por este motivo: Seu limite de ativações foi atingido, ou este domínio já está vinculado a outra chave.

Cada licença permite 2 ativações simultâneas - por exemplo, 1 para o seu servidor de desenvolvimento e a outra no seu servidor de produção.

Você pode reinstalar em qualquer lugar & a qualquer momento, mas não pode ter mais de 2 ativações ao mesmo tempo.

Para liberar uma vaga, abra seu portal do cliente Polar e desative o domínio que você não usa mais. Você não precisa desinstalar nada antes de reinstalar em outro lugar.


Erro - Não aceitável!

Não aceitável! Você tem um erro na sua sintaxe SQL; verifique o manual que corresponde à versão do seu servidor MySQL [...]

Este erro é gerado pelo mod_security do Apache

Isso significa que o Firewall do seu servidor (mod_security) está configurado para bloquear algumas requisições por motivos de segurança.

Você precisa permitir a requisição manualmente, e a forma correta de fazer isso depende do seu próprio servidor.

Uma pesquisa no Google pode ajudar.

Se não, entre em contato com o provedor do seu servidor e peça ajuda. Informe a data e hora em que encontrou o erro e a url, isso o ajudará a ajudá-lo.


A opção FollowSymLinks não é permitida na configuração do seu servidor Apache.

Esta diretiva é usada em /admin/.htaccess

Para resolver este problema:

  1. Abra /admin/.htaccess no seu editor de código
  2. Substitua Options +FollowSymLinks -MultiViews por # Options +FollowSymLinks -MultiViews

Erros do painel de administração

Erro 404 (Página não encontrada)

Pode haver diferentes causas:

  1. Causa
    Você está tentando abrir uma lista READ ou um FORM que ainda não criou.
    Solução
    abra /generator/generator.php no seu navegador e gere os arquivos de administração.
  2. Causa
    Instalação em uma subpasta
    Solução
    1. abra /admin/.htaccess no seu editor de código
    2. adicione sua subpasta ao RewriteRule.
      Por exemplo: RewriteRule . /your-folder/admin/index.php [QSA,L]
  3. Servidor Apache - Causa
    Seu servidor está mal configurado & a reescrita de URL não é permitida.
    Solução
    1. abra seu arquivo de configuração do Apache (httpd.conf)
    2. encontre as diretivas do diretório do seu projeto (<Directory "/var/www/html/phpcrud"></Directory>)
    3. altere a diretiva AllowOverride para All (AllowOverride controla quais diretivas podem ser colocadas em arquivos .htaccess)
    4. reinicie o Apache
  4. Servidor NGINX ou Microsoft IIS - Causa
    Seu servidor não usa o .htaccess, então a reescrita de URL via htaccess não tem efeito
    Solução
    Adicione as regras de reescrita no seu arquivo de configuração

Tabela não instalada com o módulo de autenticação

A opção xxx é usada no painel de administração, mas não foi instalada com o módulo de autenticação.
O módulo de autenticação deve ser reinstalado para adicionar a tabela xxx no gerenciamento de direitos de perfil.

Isso acontece quando você instalou o módulo de autenticação (portanto, você já selecionou as tabelas MySQL que serão usadas no admin),
então você adicionou outra tabela ao seu banco de dados MySQL / painel de administração.

É obviamente mais adequado (e mais lógico) instalar o módulo de autenticação somente depois que todas as suas tabelas tiverem sido criadas no seu banco de dados MySQL.


No entanto, se você precisar adicionar uma ou mais tabelas ao módulo de autenticação, tudo está explicado aqui:

Como atualizar / reinstalar o Módulo de Autenticação de Usuário

Erro ao gravar durante o envio de um formulário

Você precisa exibir a consulta SQL na tela para entender por que ela falhou.

Consulte esta página de tutorial para soluções e explicações detalhadas.

Erros de conexão com o banco de dados

Warning: mysqli_connect(): (HY000/2002)

Warning: mysqli_connect(): (HY000/2002): Can’t connect to MySQL server [...]

O erro MySQL #2002 ocorre quando o programa falha ao conectar ao seu banco de dados MySQL.

Na maioria das vezes, a falha de conexão se deve a credenciais incorretas.

Também é possível que o usuário MySQL não tenha direitos suficientes para acessar o banco de dados.

Para ajudá-lo a configurar e testar sua conexão MySQL, um arquivo de teste está disponível.

  1. Abra install/db-connection-test.php no seu editor de código
  2. Substitua 'host', 'user', 'pass', 'dbname', 'dbtable' com suas configurações de conexão e um nome de tabela do seu banco de dados.
  3. Abra o arquivo no seu navegador a partir do seu servidor PHP

Você verá a consulta enviada ao seu banco de dados.
Se a conexão for bem-sucedida, você verá uma lista com as colunas da sua tabela.
Caso contrário, suas configurações de conexão provavelmente estão erradas, tente alterá-las.

Verifique também seu firewall, que pode estar bloqueando o acesso.


O programa não usa a conexão com o banco de dados que registrei / Conexão com o banco de dados necessária

O PHPCG armazena as configurações de conexão com o banco de dados em class/database/db-connect.php. Este único arquivo pode conter as configurações de conexão de até dois servidores (por exemplo, seu localhost e seu servidor de produção), e o programa usa automaticamente as configurações do servidor em que é executado.

Para saber em qual servidor está sendo executado, o PHPCG calcula uma impressão digital do servidor a partir do nome do host da máquina e do caminho de instalação. As configurações que correspondem a essa impressão digital são usadas - não há fallback: se nenhuma conexão corresponder, a aplicação para em uma tela de recuperação em vez de se conectar silenciosamente ao banco de dados errado.

Se você ver a tela Conexão com o banco de dados necessária , o servidor atual não tem nenhuma conexão registrada. Isso acontece quando a instalação foi movida ou sua pasta renomeada, quando um contêiner foi reconstruído ou em uma nova implantação.

O que fazer:

  1. Clique no botão Executar o instalador na tela de recuperação, ou abra /install/do-install.php no seu navegador.
  2. O instalador lista as conexões registradas (máximo de 2) e preenche previamente as configurações existentes - você apenas as confirma. Nada é excluído.
  3. Ao confirmar, o servidor atual é registrado: as configurações de conexão são adicionadas ao db-connect.php e a aplicação volta a funcionar imediatamente.
Não edite as conexões no db-connect.php manualmente: elas são gerenciadas pelo instalador, que as sobrescreve a cada (re)configuração.

PHP Notice: ... | PHP Warning: ...

Quando você faz algumas alterações na estrutura do seu banco de dados, por exemplo, adicionar / renomear ou excluir algumas tabelas ou campos, você verá algumas mensagens PHP NOTICE ou WARNING.

Isso é feio e um pouco assustador, mas felizmente você pode ignorar todas elas, e nada é quebrado no sistema.

Isso apenas significa que os dados do gerador devem ser atualizados.

Este tutorial explica em detalhes como registrar alterações na estrutura do seu banco de dados.

Chamada a função indefinida generator\is_countable()

A função PHP is_countable() está disponível a partir da versão 7.3 do PHP.

Se você encontrar este erro, significa que sua versão do PHP é anterior à 7.3

Atualizar para uma versão do PHP superior à 7.3 resolverá o problema.

Erros de atualização

Falha na atualização

  1. O atualizador automático precisa gravar em algumas pastas/subpastas do PHPCG:

    admin, class, conf, documentation, generator, install, vendor

    Tente aumentar seu CHMOD (0755 deve ser suficiente)

  2. Abra generator/update/update.log arquivo de log para ver detalhes sobre a falha.

Outros erros

O arquivo de configuração do usuário não existe em [root]conf/user-conf.

O PHPCG detecta o caminho para o diretório raiz do servidor e o armazena em uma constante chamada ROOT.

Esta operação é realizada em conf/conf.php

Parece haver um problema com os valores detectados no seu servidor. Para resolver isso:

  1. Verifique o caminho para conf/conf.php , se contiver caracteres maiúsculos, substitua-os por letras minúsculas.
  2. Se você ainda precisar de ajuda entre em contato conosco e nos envie seu acesso FTP e sua URL.

Erro fatal: classe finfo não encontrada

A extensão PHP finfo está ausente no seu servidor.

Solução: habilite a extensão PHP finfo no seu php.ini ou instale-a.

Erros e mensagens de licença

As mensagens a seguir podem ser exibidas pelos formulários gerados em vez do HTML, quando a verificação da licença falha.


O PHP CRUD Generator não está ativado neste domínio

O PHP CRUD Generator não está ativado neste domínio.

Abra install/do-install.php no seu navegador e insira sua chave de licença para ativá-lo. Se você acabou de mover seu projeto de outro domínio, isso é esperado - registre-o aqui para usá-lo neste domínio.


Sua licença está registrada para outro domínio

Sua licença está registrada para outro domínio.

Este projeto foi ativado em outro domínio. Abra install/do-install.php neste domínio e insira sua chave de licença para usá-lo aqui. Limite de ativações atingido? Desative primeiro o domínio antigo no seu portal do cliente Polar.


Este domínio não corresponde à sua licença do PHP CRUD Generator

Este domínio não corresponde à sua licença do PHP CRUD Generator.

Há um arquivo de licença presente aqui, mas ele foi registrado para outro domínio - copiar o arquivo não transfere a licença. Abra install/do-install.php neste domínio e insira sua chave de licença para registrá-lo.


Sua chave de licença é inválida

Sua chave de licença é inválida.

O servidor de licenças não reconhece a chave inserida no formulário de ativação. Certifique-se de ter copiado a chave completa do seu portal do cliente Polar ou do e-mail de confirmação do seu pedido, sem nenhum caractere extra ou espaço no final, e ative novamente.


Sua licença não está mais ativa

Sua licença não está mais ativa.

Sua chave de licença foi revogada no servidor de licenças (possíveis causas: reembolso ou desativação manual). Se você acredita que isso é um erro, entre em contato conosco.


Não foi possível validar sua licença

Não foi possível validar sua licença.

Sua chave de licença pode ter atingido o limite de ativações. Gerencie suas ativações no seu portal do cliente Polar.


Seu servidor não consegue acessar o servidor de licenças

Seu servidor não consegue acessar o servidor de licenças.

Os formulários foram desativados após várias tentativas malsucedidas de contato. Causas comuns e soluções:

  • Seu firewall bloqueia requisições de saída: permita requisições HTTPS de saída para api.polar.sh (porta 443).
  • curl e openssl não estão habilitadas no seu php.ini: habilite-as.
  • O servidor de licenças está temporariamente inacessível: aguarde alguns minutos e recarregue a página - a validação é tentada novamente automaticamente.

Erro genérico de licença

Este formulário não pode ser exibido. Verifique sua licença do PHP CRUD Generator.

Esta mensagem genérica é exibida quando ocorre um erro inesperado de licença. Verifique os casos específicos acima; se nenhum corresponder, entre em contato conosco com os detalhes do erro.


Erro nas configurações de sessão do PHP

Erro de configuração de sessão do PHP: as configurações de sessão não permitem iniciar uma sessão.

As sessões do PHP são necessárias para exibir e processar os formulários. Este erro é exibido quando o PHP falha ao iniciar uma sessão, geralmente devido a uma configuração de cookie de sessão que não corresponde à configuração do seu servidor:

  • Se o seu site roda em HTTP (não HTTPS), certifique-se de que session.cookie_secure esteja desativado (=0 ou Off) no seu php.ini ou .htaccess.
  • Por outro lado, se o seu site roda em HTTPS, os cookies podem ser marcados com o atributo Secure no seu .htaccess para melhorar a segurança.
  • Verifique também session.cookie_domain e session.cookie_path: eles devem corresponder ao seu domínio (ou permanecer vazios para o domínio padrão).

Depois de corrigir, recarregue a página: o PHP iniciará a sessão e exibirá o formulário.

Fale conosco

Normalmente respondemos em no máximo 24 horas

Geralmente solicitamos um acesso FTP e/ou sua chave de licença - se possível, envie-os para nós, assim economizaremos tempo.