{"id":1437,"date":"2012-09-13T06:30:17","date_gmt":"2012-09-13T04:30:17","guid":{"rendered":"http:\/\/www.manuelmarangoni.it\/sir-bit\/?p=1437"},"modified":"2016-02-12T11:51:09","modified_gmt":"2016-02-12T10:51:09","slug":"creare-un-report-di-salvataggio-per-tutte-le-azioni-del-sito","status":"publish","type":"post","link":"https:\/\/www.manuelmarangoni.it\/sir-bit\/1437\/creare-un-report-di-salvataggio-per-tutte-le-azioni-del-sito\/","title":{"rendered":"Creare un report di salvataggio per tutte le azioni del sito"},"content":{"rendered":"

Vi \u00e8 mai capitato che il vostro cliente faccia – per sbaglio – una modifica al sito e vi chieda di riportarlo com’era prima?
\nUn sito ben strutturato limita al minimo gli errori in lato codice (per esempio, la cancellazione di una categoria se questa contiene ancora elementi), ma dagli “errori umani” non c’\u00e8 script che tenga. In questo campo ricadono, per esempio, le cancellazione di utenti registrati al sito, che diventano di fatto irrecuperabili – a meno che non abbiate un backup del database.<\/p>\n

Il pi\u00f9 delle volte il cliente sa di non dover coinvolgere il programmatore, visto che l’errore \u00e8 esclusivamente suo, ma se trovate qualche personaggio ostico o con cui avete rapporti particolari vi potrebbe essere utile poter recuperare il record cancellato<\/strong> e riportarlo al suo posto.
\nEcco quindi che una funzione di report far\u00e0 al caso vostro.<\/p>\n

Nel concreto, in questo articolo vedremo una semplice funzione da richiamare sotto ogni query “di modifica” (vi rientrano quindi update<\/code>, insert<\/code> e delete<\/code>, ma non le comuni select, che non vanno a intaccare il database). Lo script si occuper\u00e0 di salvare la query intera, con qualche informazioni in pi\u00f9 a vostra discrezione. Io consiglio di tenere traccia per lo meno di queste informazioni<\/strong>:
\n– eventuale id dell’utente che ha effettuato la modifica (questo solo in caso che ci sia una fase di login)
\n– id del record modificato\/cancellato\/inserito
\n– la query completa
\n– la data dell’operazione
\n– un campo note da compilare per capire quale area del sito l’operazione ha coinvolto<\/p>\n

Questi saranno, di fatto, i campi che andranno a formare la nostra tabella report<\/code> nel database. Nello script ho aggiunto anche il campo tabella<\/code>, per avere direttamente sottomano la tabella coinvolta dall’operazione.
\nUna nota<\/em>: la funzione \u00e8 predisposta per accettare anche report che non siano inerenti a query lanciate, cio\u00e8 \u00e8 predisposta per accettare semplici messaggi di “promemoria”<\/strong> (un esempio: se inviate email periodiche, potete compilare solo il campo data con la descrizione che l’email \u00e8 stata inviata). In questo caso \u00e8 sufficiente lasciare vuoti i campi della tabella non necessari.<\/p>\n

Per la comprensione dello script basta una conoscenza di base del php e del mysql.<\/p>\n

<\/p>\n\n

Download script<\/h2>\n
\n
\"[PHP,<\/div>\n
Pagina diretta alla scheda e al download del codice<\/a><\/strong><\/div>\n <\/div>\n
<\/div>\n

Il database e la funzione report<\/h2>\n

Eseguite questa query nel vostro database, che creer\u00e0 la struttura della tabella report<\/code>:<\/p>\n

\n\n\n\n
\n
1\r\n2\r\n3\r\n4\r\n5\r\n6\r\n7\r\n8\r\n9\r\n10<\/pre>\n<\/td>\n
\n
CREATE<\/span> TABLE<\/span> IF<\/span> NOT<\/span> EXISTS<\/span> `report`<\/span> (<\/span>\r\n  `id`<\/span> int<\/span>(<\/span>11<\/span>)<\/span> NOT<\/span> NULL<\/span> AUTO_INCREMENT<\/span>,<\/span>\r\n  `id_<\/span>utente`<\/span> int<\/span>(<\/span>11<\/span>)<\/span> NOT<\/span> NULL<\/span>,<\/span>\r\n  `tabella`<\/span> varchar<\/span>(<\/span>255<\/span>)<\/span> NOT<\/span> NULL<\/span>,<\/span>\r\n  `id_<\/span>record`<\/span> int<\/span>(<\/span>11<\/span>)<\/span> NOT<\/span> NULL<\/span>,<\/span>\r\n  `query`<\/span> varchar<\/span>(<\/span>500<\/span>)<\/span> NOT<\/span> NULL<\/span>,<\/span>\r\n  `note`<\/span> text<\/span> NOT<\/span> NULL<\/span>,<\/span>\r\n  `data`<\/span> datetime<\/span> NOT<\/span> NULL<\/span>,<\/span>\r\n  PRIMARY KEY<\/span> (<\/span>`id`<\/span>)<\/span>\r\n)<\/span> ENGINE<\/span>=<\/span>InnoDB<\/span>  DEFAULT<\/span> CHARSET<\/span>=<\/span>latin1 AUTO_INCREMENT<\/span>=<\/span>1<\/span> ;<\/span><\/pre>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
Passiamo adesso sul lato della programmazione.
\nLa funzione report<\/code> che ho messo qui sotto ha diversi parametri, che formeranno poi la base per il salvataggio nella tabella creata sopra.<\/p>\n
Una breve spiegazione dei parametri<\/strong>:
\n– $idutente<\/code> \u00e8 l’id dell’utente che ha generato il report
\n– $tabella<\/code> \u00e8 la tabella di riferimento nel database (se vuoto, non si riferisce a nessuna tabella)
\n– $id_record<\/code> \u00e8 l’id del record modificato o inserito nella tabella (se 0, non si riferisce a nessun record)
\n– $query_report<\/code> \u00e8 la query eseguita (pu\u00f2 essere lasciata vuota)
\n– $note<\/code> \u00e8 l’eventuale commento associato al report
\n– $data<\/code> \u00e8 la data e ora di creazione del report (se non specificata prende l’attuale)<\/p>\n
Si pu\u00f2 inserire qualsiasi tipo di record (es: che non sia una query), anche lasciando vuoti tabella<\/code>, id_record<\/code> e query_report<\/code>.<\/p>\n
\n\n\n\n
\n
1\r\n2\r\n3\r\n4\r\n5\r\n6\r\n7\r\n8\r\n9<\/pre>\n<\/td>\n
\n
function<\/span> report(<\/span>$id_utente<\/span>,<\/span> $note<\/span>=<\/span>\"\"<\/span>,<\/span> $data<\/span>=<\/span>\"\"<\/span>,<\/span> $tabella<\/span>=<\/span>\"\"<\/span>,<\/span> $id_record<\/span>=<\/span>0<\/span>,<\/span> $query_report<\/span>=<\/span>\"\"<\/span>)<\/span>{<\/span>\r\n\r\n\tif<\/span>(<\/span>$data<\/span>==<\/span>\"\"<\/span>)<\/span>\r\n\t\t$data<\/span>=<\/span>date<\/span>(<\/span>\"Y-m-d H:i:s\"<\/span>)<\/span>;<\/span>\r\n\r\n\t$q<\/span>=<\/span>\"INSERT INTO report (id_utente, tabella, id_record, query, note, data) VALUES (\"<\/span>.<\/span>$id_utente<\/span>.<\/span>\", '\"<\/span>.<\/span>$tabella<\/span>.<\/span>\"', '\"<\/span>.<\/span>$id_record<\/span>.<\/span>\"', '\"<\/span>.<\/span>addslashes<\/span>(<\/span>$query_report<\/span>)<\/span>.<\/span>\"', '\"<\/span>.<\/span>addslashes<\/span>(<\/span>$note<\/span>)<\/span>.<\/span>\"', '\"<\/span>.<\/span>$data<\/span>.<\/span>\"')\"<\/span>;<\/span>\r\n\t$query<\/span>=<\/span>mysql_query<\/span>(<\/span>$q<\/span>,<\/span> $db<\/span>)<\/span>;<\/span>\r\n\r\n}<\/span><\/pre>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
Un esempio d’uso della funzione<\/h2>\n\n
Come si usa la funzione qui sopra?
\nPoniamo il caso che abbiate nel database una tabella chiamata “categorie” e che il suo indice autoincrementale sia dato dal campo “id” (non ha importanza quali altri campi abbia la tabella).
\nMettiamo, inoltre, di essere un utente loggato il cui id nel database (salvato in un’ipotetica tabella “utenti”) sia 3. L’utente in questione clicca sul pulsante di eliminazione della categoria, il cui id sar\u00e0 quindi passato nella variabile $_POST['canc']<\/code>.<\/p>\n
In questo esempio, la funzione report<\/code> che abbiamo definito sopra sar\u00e0 richiamata subito dopo l’esecuzione della query<\/strong>, cos\u00ec da immagazzinare il suo risultato.<\/p>\n
\n\n\n\n
\n
1\r\n2\r\n3\r\n4\r\n5\r\n6\r\n7\r\n8\r\n9<\/pre>\n<\/td>\n
\n
\/\/eliminazione categoria<\/span>\r\nif<\/span>(<\/span>isset<\/span>(<\/span>$_POST<\/span>[<\/span>'canc'<\/span>]<\/span>)<\/span>)<\/span>{<\/span>\r\n\t$query<\/span>=<\/span>\"DELETE FROM categorie WHERE id=\"<\/span>.<\/span>$_POST<\/span>[<\/span>'canc'<\/span>]<\/span>;<\/span>\r\n\t$result<\/span>=<\/span>mysql_query<\/span>(<\/span>$query<\/span>,<\/span> DB)<\/span>;<\/span>\r\n\r\n\t\/\/salvataggio del report nel database<\/span>\r\n\treport(<\/span>3<\/span>,<\/span> \"Eliminata la categoria con ID \"<\/span>.<\/span>$_POST<\/span>[<\/span>'canc'<\/span>]<\/span>,<\/span> \"\"<\/span>,<\/span> \"categorie\"<\/span>,<\/span> $_POST<\/span>[<\/span>'canc'<\/span>]<\/span>,<\/span> $query<\/span>)<\/span>;<\/span>\r\n\tunset<\/span>(<\/span>$_POST<\/span>[<\/span>'canc'<\/span>]<\/span>)<\/span>;<\/span>\r\n}<\/span><\/pre>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n","protected":false},"excerpt":{"rendered":"
Uno script liberamente scaricabile per creare un report di salvataggio di qualsiasi azione nel sito che vada a intaccare il database. Utile per un ripristino.<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[78],"tags":[32,4,6],"class_list":["post-1437","post","type-post","status-publish","format-standard","hentry","category-php-mysql","tag-mysql","tag-php","tag-script","cat-78-id"],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/www.manuelmarangoni.it\/sir-bit\/wp-json\/wp\/v2\/posts\/1437"}],"collection":[{"href":"https:\/\/www.manuelmarangoni.it\/sir-bit\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.manuelmarangoni.it\/sir-bit\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.manuelmarangoni.it\/sir-bit\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.manuelmarangoni.it\/sir-bit\/wp-json\/wp\/v2\/comments?post=1437"}],"version-history":[{"count":18,"href":"https:\/\/www.manuelmarangoni.it\/sir-bit\/wp-json\/wp\/v2\/posts\/1437\/revisions"}],"predecessor-version":[{"id":2392,"href":"https:\/\/www.manuelmarangoni.it\/sir-bit\/wp-json\/wp\/v2\/posts\/1437\/revisions\/2392"}],"wp:attachment":[{"href":"https:\/\/www.manuelmarangoni.it\/sir-bit\/wp-json\/wp\/v2\/media?parent=1437"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.manuelmarangoni.it\/sir-bit\/wp-json\/wp\/v2\/categories?post=1437"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.manuelmarangoni.it\/sir-bit\/wp-json\/wp\/v2\/tags?post=1437"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}