Depurando Consultas MySQL em Formulários de Administração
Inspeção e Análise de Consultas SQL

Os Formulários de Administração Bootstrap são construídos com PHP Form Builder. Eles estão localizados na pasta admin/inc/forms/ .


Sobre os formulários de administração e a classe PDO do PHP Form Builder

PHP Form Builder está incluído no pacote do PHP CRUD Generator.
Com todas as suas funcionalidades e plugins.

As consultas MySQL enviadas ao seu banco de dados são construídas com a classe wrapper PDO do PHP Form Builder.

A documentação e exemplos de códigos estão disponíveis aqui no site do PHP Form Builder.

PHP Form Builder
PHP Form Builder

Todos os formulários de administração estão localizados na mesma pasta em admin/inc/forms/.

Cada tabela usa 3 formulários:

  • tabela-create.php
  • tabela-edit.php
  • tabela-delete.php

onde "tabela" é o nome sanitizado da sua tabela.

Todas as ações (gravações no banco de dados) são feitas nos mesmos arquivos após a validação.


Como exibir as consultas do banco de dados e/ou erros

No gerador de CRUD, duas opções de configuração estão disponíveis.
A primeira permite exibir detalhes apenas quando uma consulta SQL falha e ocorre um erro, enquanto a segunda exibe sistematicamente os detalhes de todas as consultas SQL (modo DEBUG).

The PHP CRUD DEBUG option
A opção DEBUG do PHP CRUD

A opção "Ativar depuração" opção

Ative esta opção na aba "Configuração" do Gerador de CRUD.

Quando uma consulta SQL retorna um erro, os detalhes da consulta serão exibidos na tela, incluindo a consulta em formato PDO com placeholders, a consulta gerada em formato SQL enviada ao servidor e a mensagem de erro retornada pelo banco de dados.

O modo Debug

Ative o modo "Debug" no Gerador de CRUD "Configuração" do Gerador de CRUD.

Quando o modo Debug está ativado, todas as consultas são exibidas em detalhes na tela, tanto nas listas quanto nos formulários de administração.
Os detalhes de cada consulta estão disponíveis em PDO com placeholders, filtros e opções, e em formato SQL conforme recebidos pelo banco de dados.

Com o modo DEBUG ativado. As consultas INSERT, UPDATE e DELETE são apenas simuladas, permitindo depurar sem fazer nenhuma alteração nos seus registros.


Você pode então copiar/colar suas consultas SQL diretamente no seu gerenciador de banco de dados (PhpMyAdmin ou similar).
Você verá em retorno se um campo tem um valor inválido ou se há algum outro problema na consulta.


Se a consulta funciona no seu gerenciador de banco de dados mas não no PHPCG, pode haver 2 causas:

  1. O usuário MySQL com o qual você se conecta do PHPCG tem privilégios insuficientes para executar a consulta (verifique os privilégios dos seus usuários MySQL)
  2. A tabela na qual a consulta é executada não atende aos pré-requisitos. Particularmente, cada tabela deve ter uma chave primária auto-incrementada. Se não tiver, os registros ainda são inseridos / editados no painel de administração, mas o programa retorna o erro Erro ao gravar.
    Você pode verificar no gerador, na aba Construir Formulários de Criação / Atualização parte. Se a sua tabela tiver uma chave primária auto-incrementada, você deverá ver PRIMARY e AUTO-INCREMENT abaixo do nome do campo.

Pré-requisitos

Para editar os Bootstrap Admin Forms, você deve previamente:

Página principal do tutorial PHP CRUD