Files
Studio_Grasso/deploy/optional-php-form/contact.php
T
Alby96andClaude Opus 5.5 3befe7e266 fix: CI adattata a Forgejo, revisione completa del codice e avvio in debug
Le run della CI restavano «in attesa» perché l'unico runner dell'istanza («Ferrari») non si è
mai collegato: il runner resta da configurare. La revisione completa del codice ha trovato
anche difetti che avrebbero fatto fallire la CI con il runner online, oltre ad altri problemi
del sito, dei controlli e della documentazione.

CI e rilascio:
- continue-on-error sullo step dei link esterni: Forgejo lo ignora sul job, e un sito esterno
  irraggiungibile avrebbe reso rossa la CI;
- artifact con i file nascosti (report Lighthouse e .htaccess non venivano mai caricati);
- token personale RELEASE_TOKEN: FORGEJO_TOKEN è riservato ed è sempre il token automatico;
- dominio in un solo punto (site.config.mjs) e variabile del repository SITE_URL;
- ripiego REST: release in bozza, file, poi pubblicazione; tag verificato sul server;
  sostituzione dei file senza mai lasciarli mancanti;
- tar.gz identico su Windows, macOS e Linux (byte del sistema operativo nell'header gzip).

Sito: CSS compatibile con Safari/iOS 15 (media query classiche, backdrop-filter), anello di
focus con contrasto di almeno 3:1, bersagli touch di 44 px dove servono, intestazione desktop
senza voci o logo a capo, HTML valido in /servizi/, colore delle chip, stampa senza mappe,
giorni di apertura, ricerca e titolo delle mappe e numero breve ricavati dai dati.

Modulo di contatto e contact.php: stesse regole nel browser e sul server (spazi, e-mail,
a capo, lunghezze), tempo minimo misurato con un solo orologio (ts_invio), corpo in
quoted-printable e oggetto RFC 2047, funzionamento con PHP a 32 bit, costante
MODALITA_PREDEFINITA per attivarlo.

Controlli e test: valori letti dai dati del sito, i sei servizi del brief con le ancore,
«commercialista» anche in meta, attributi e dati strutturati, .htaccess su righe attive,
HSTS attivabile con una scelta esplicita, contrasto del focus misurato nei test.

Esempi di pubblicazione: nginx con gli header di sicurezza in un solo punto (HSTS compreso),
deploy automatico che parte alla pubblicazione e sincronizza solo una cartella confermata,
procedura nginx che toglie i file delle versioni precedenti.

Debug: .vscode/launch.json e tasks.json, F5 avvia il server Astro e apre il browser con il
debugger collegato.

Documentazione aggiornata (README, DEPLOY, CONTENUTI, CONFORMITA, TODO-STUDIO, CHANGELOG) e
decisioni D-045…D-055.

Verificato: npm run verify su Windows e nel container della CI (Playwright 1.56.1, root);
job dei link esterni in node:24; contact.php con PHP 7.4 e 8.3, a 64 e 32 bit; nginx in
Docker; release-upload.sh e deploy di esempio contro API e shell simulate.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-16 13:40:16 +02:00

307 lines
13 KiB
PHP
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<?php
/**
* Studio Grasso — gestore del modulo di contatto (modalità "php", brief §10.1).
*
* Installazione: in src/data/studio.ts impostare `MODALITA_PREDEFINITA = 'php'`, copiare
* questo file in public/contact.php, rivedere DESTINATARIO e MITTENTE qui sotto, eseguire
* `npm run verify` e pubblicare (vedi docs/DEPLOY.md, sezione 6).
* Requisiti: PHP 7.4 o successivo con la funzione mail() abilitata dall'hosting (l'estensione
* mbstring è usata se presente, ma non è necessaria).
*
* Cosa fa:
* - accetta solo POST e valida tutti i campi (obbligatori, lunghezze, e-mail, telefono, presa
* visione dell'informativa) con le stesse regole del browser (src/scripts/form.ts): spazi
* iniziali e finali esclusi, a capo contati come un carattere;
* - anti-spam senza cookie né servizi esterni: campo trappola `sito_web` (se compilato la
* richiesta viene scartata in silenzio), tempo minimo di compilazione (campi `ts` e
* `ts_invio`, entrambi dall'orologio del dispositivo) e massimo 5 invii all'ora per
* indirizzo IP. Il contatore è un file per IP in una cartella privata (permessi 0700/0600),
* con nome HMAC-SHA256 dell'IP e di un segreto casuale generato al primo uso: mai l'IP in
* chiaro. I file più vecchi di un'ora vengono cancellati a ogni invio (informativa: privacy
* policy, blocco «moduloPhp»);
* - invia un'e-mail in testo semplice al destinatario configurato con mail(), con il corpo in
* quoted-printable (righe brevi: nessun rifiuto per «lines too long» dai server di posta);
* - NON salva né registra il contenuto dei messaggi;
* - risponde con redirect a /contatti/grazie/ oppure con una pagina d'errore leggibile.
*/
declare(strict_types=1);
// orario italiano nella data dell'e-mail, anche se php.ini non imposta date.timezone
date_default_timezone_set('Europe/Rome');
// ---------------------------------------------------------------- configurazione
const DESTINATARIO = 'info@studiograssoezio.it';
// Mittente tecnico: una casella ESISTENTE di un dominio da cui l'hosting può spedire (coperto
// da SPF/DKIM), es. noreply@ sul dominio del sito o della posta. È usata anche come mittente
// della busta (Return-Path, opzione -f di sendmail), necessario per SPF/DMARC.
const MITTENTE = 'noreply@studiograssoezio.it';
const NOME_MITTENTE = 'Sito Studio Grasso';
const PREFISSO_OGGETTO = '[Sito] ';
const PAGINA_GRAZIE = '/contatti/grazie/';
const PAGINA_CONTATTI = '/contatti/';
const MAX_INVII_ORA = 5;
const TEMPO_MINIMO_MS = 3000;
const LUNGHEZZE = ['nome' => 120, 'email' => 160, 'telefono' => 25, 'oggetto' => 160, 'messaggio' => 5000];
// Cartella privata per i contatori del limite di invii, FUORI dalla cartella pubblica del sito
// (predefinita: accanto a public_html/httpdocs). Se non si può usare, si prova una sottocartella
// della cartella temporanea di sistema; se nemmeno quella è sicura il limite non si applica.
const CARTELLA_LIMITI = __DIR__ . '/../.studio-grasso-form';
// ---------------------------------------------------------------- funzioni
/**
* Valore di un campo senza spazi iniziali e finali, con gli a capo normalizzati in LF: il
* browser invia CRLF ma conta ogni a capo come un carattere (maxlength), e così fa il server.
*/
function campo(string $nome): string
{
$valore = $_POST[$nome] ?? '';
return is_string($valore) ? trim(str_replace(["\r\n", "\r"], "\n", $valore)) : '';
}
/** Lunghezza in caratteri (UTF-8), anche senza l'estensione mbstring. */
function lunghezza(string $testo): int
{
return function_exists('mb_strlen')
? mb_strlen($testo, 'UTF-8')
: (int) preg_match_all('/./us', $testo);
}
function h(string $testo): string
{
return htmlspecialchars($testo, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8');
}
/** Pagina d'errore semplice, in italiano, con link per tornare al modulo. */
function errore(string $messaggio, int $stato = 400): void
{
http_response_code($stato);
header('Content-Type: text/html; charset=utf-8');
header('Cache-Control: no-store');
header('X-Robots-Tag: noindex');
echo '<!doctype html><html lang="it"><head><meta charset="utf-8">'
. '<meta name="viewport" content="width=device-width, initial-scale=1">'
. '<meta name="robots" content="noindex"><title>Richiesta non inviata — Studio Grasso</title>'
. '<style>body{font-family:system-ui,sans-serif;max-width:40rem;margin:4rem auto;padding:0 1rem;'
. 'color:#16202a;line-height:1.6}h1{color:#0b1f33}a{color:#163a5c}</style></head><body>'
. '<h1>Richiesta non inviata</h1><p>' . h($messaggio) . '</p>'
. '<p><a href="' . h(PAGINA_CONTATTI) . '">Torna alla pagina Contatti</a> oppure scrivi a '
. '<a href="mailto:' . h(DESTINATARIO) . '">' . h(DESTINATARIO) . '</a>.</p></body></html>';
exit;
}
function vai(string $percorso): void
{
header('Location: ' . $percorso, true, 303);
exit;
}
/** Cartella privata (permessi 0700, non accessibile ad altri utenti) oppure null. */
function cartellaLimiti(): ?string
{
$candidate = [CARTELLA_LIMITI, sys_get_temp_dir() . '/studio-grasso-form-' . md5(__DIR__)];
// controlli silenziati: con open_basedir le cartelle fuori dai percorsi ammessi producono
// avvisi che, con display_errors attivo, impedirebbero il redirect finale
foreach ($candidate as $cartella) {
if (!@is_dir($cartella)) {
@mkdir($cartella, 0700, true);
}
if (!@is_dir($cartella) || !@is_writable($cartella)) {
continue;
}
@chmod($cartella, 0700);
clearstatcache(true, $cartella);
$permessi = @fileperms($cartella);
if ($permessi !== false && ($permessi & 0077) === 0) {
return $cartella;
}
}
return null;
}
/** Segreto casuale dell'installazione, generato al primo uso e salvato nella cartella privata. */
function segreto(string $cartella): string
{
$file = $cartella . '/segreto';
$valore = @file_get_contents($file);
if (is_string($valore) && preg_match('/^[0-9a-f]{64}$/', $valore)) {
return $valore;
}
$valore = bin2hex(random_bytes(32));
if (@file_put_contents($file, $valore, LOCK_EX) !== false) {
@chmod($file, 0600);
}
return $valore;
}
/** Limite di invii per IP: un file per IP, con nome HMAC dell'indirizzo (mai l'IP in chiaro). */
function limiteSuperato(string $ip): bool
{
$cartella = cartellaLimiti();
if ($cartella === null) {
return false; // nessuna cartella sicura: non si blocca l'utente
}
$adesso = time();
// cancellazione dei contatori più vecchi di un'ora (conservazione minima, art. 5.1.e GDPR)
foreach (@glob($cartella . '/ip-*') ?: [] as $vecchio) {
$modificato = @filemtime($vecchio);
if ($modificato !== false && $modificato < $adesso - 3600) {
@unlink($vecchio);
}
}
$file = $cartella . '/ip-' . hash_hmac('sha256', $ip, segreto($cartella));
$mascheraPrecedente = umask(0077);
$fp = @fopen($file, 'c+');
umask($mascheraPrecedente);
if ($fp === false) {
return false; // se il file non è scrivibile non si blocca l'utente
}
@chmod($file, 0600);
flock($fp, LOCK_EX);
$invii = [];
$dati = stream_get_contents($fp);
if (is_string($dati) && $dati !== '') {
$decodificati = json_decode($dati, true);
if (is_array($decodificati)) {
$invii = array_values(array_filter($decodificati, static function ($t) use ($adesso) {
return is_int($t) && $t > $adesso - 3600;
}));
}
}
$superato = count($invii) >= MAX_INVII_ORA;
if (!$superato) {
$invii[] = $adesso;
}
ftruncate($fp, 0);
rewind($fp);
fwrite($fp, (string) json_encode($invii));
fflush($fp);
flock($fp, LOCK_UN);
fclose($fp);
return $superato;
}
/**
* Testo codificato secondo RFC 2047 (lettere accentate) in parole di al massimo 75 caratteri:
* pezzi di al massimo 45 byte senza spezzare i caratteri UTF-8. Lo spazio tra due parole
* codificate viene ignorato da chi le legge, quindi il testo arriva intero.
*/
function oggettoMime(string $testo): string
{
$pezzi = [''];
foreach (preg_split('//u', $testo, -1, PREG_SPLIT_NO_EMPTY) ?: [] as $carattere) {
$ultimo = count($pezzi) - 1;
if (strlen($pezzi[$ultimo] . $carattere) > 45) {
$pezzi[] = $carattere;
} else {
$pezzi[$ultimo] .= $carattere;
}
}
return implode(' ', array_map(static function (string $pezzo): string {
return '=?UTF-8?B?' . base64_encode($pezzo) . '?=';
}, $pezzi));
}
// ---------------------------------------------------------------- richiesta
if (($_SERVER['REQUEST_METHOD'] ?? 'GET') !== 'POST') {
header('Allow: POST');
errore('Il modulo va inviato dalla pagina Contatti.', 405);
}
// 1) campo trappola: compilato solo dai programmi automatici → si finge l'invio riuscito
if (campo('sito_web') !== '') {
vai(PAGINA_GRAZIE);
}
// 2) tempo minimo di compilazione. I campi ts (apertura della pagina) e ts_invio (invio) sono
// valorizzati via JavaScript con l'orologio del dispositivo: la durata si calcola con lo
// stesso orologio, perché quello del dispositivo può essere avanti o indietro rispetto al
// server. Senza ts_invio (es. invio senza l'evento submit) si usa l'ora del server; senza
// JavaScript mancano entrambi e il controllo non si applica.
// Calcolo in virgola mobile: i millisecondi (13 cifre) superano PHP_INT_MAX di PHP a 32 bit,
// dove (int) li satura e la durata risulterebbe sempre 0; un float li rappresenta esatti.
$ts = campo('ts');
$tsInvio = campo('ts_invio');
if ($ts !== '' && ctype_digit($ts)) {
$trascorsi = ($tsInvio !== '' && ctype_digit($tsInvio))
? (float) $tsInvio - (float) $ts
: microtime(true) * 1000 - (float) $ts;
if ($trascorsi >= 0 && $trascorsi < TEMPO_MINIMO_MS) {
errore('Il modulo è stato inviato troppo rapidamente. Attendi qualche secondo e riprova.', 429);
}
}
// 3) validazione
$dati = [];
foreach (LUNGHEZZE as $nome => $max) {
$valore = campo($nome);
if ($valore === '') {
errore('Compila tutti i campi obbligatori del modulo.');
}
if (!preg_match('//u', $valore)) {
errore('Uno dei campi contiene caratteri non consentiti.'); // UTF-8 non valido
}
if (lunghezza($valore) > $max) {
errore('Uno dei campi supera la lunghezza consentita.');
}
$dati[$nome] = $valore;
}
foreach (['nome', 'email', 'telefono', 'oggetto'] as $nome) {
if (preg_match('/[\r\n]/', $dati[$nome])) {
errore('Uno dei campi contiene caratteri non consentiti.');
}
}
if (filter_var($dati['email'], FILTER_VALIDATE_EMAIL) === false) {
errore('L’indirizzo e-mail non è valido.');
}
if (!preg_match('/^[0-9 +().\/-]{6,25}$/', $dati['telefono'])) {
errore('Il numero di telefono non è valido: usa da 6 a 25 caratteri tra cifre, spazi e i segni + ( ) . / -');
}
if (lunghezza($dati['messaggio']) < 10) {
errore('Il messaggio deve contenere almeno 10 caratteri.');
}
if (campo('privacy') !== '1') {
errore('Per inviare la richiesta conferma di aver letto l’informativa sulla privacy.');
}
// 4) limite di invii per IP
if (limiteSuperato((string) ($_SERVER['REMOTE_ADDR'] ?? ''))) {
errore('Hai inviato troppe richieste in poco tempo. Riprova più tardi o scrivici per e-mail.', 429);
}
// 5) invio
$corpo = "Nuova richiesta dal modulo di contatto del sito.\n\n"
. 'Nome e cognome: ' . $dati['nome'] . "\n"
. 'E-mail: ' . $dati['email'] . "\n"
. 'Telefono: ' . $dati['telefono'] . "\n"
. 'Oggetto: ' . $dati['oggetto'] . "\n\n"
. "Messaggio:\n" . $dati['messaggio'] . "\n\n"
. "--\nPresa visione dell'informativa privacy: sì\n"
. 'Data: ' . date('d/m/Y H:i') . "\n";
// Quoted-printable: righe di al massimo 76 caratteri anche per un messaggio scritto senza andare
// a capo (oltre 998 byte per riga i server di posta lo rifiutano o lo spezzano, RFC 5322) e testo
// UTF-8 invariato. Gli a capo diventano CRLF prima della codifica, che li conserva come tali.
$corpo = quoted_printable_encode(str_replace("\n", "\r\n", $corpo));
$intestazioni = [
'From' => oggettoMime(NOME_MITTENTE) . ' <' . MITTENTE . '>',
'Reply-To' => $dati['email'],
'MIME-Version' => '1.0',
'Content-Type' => 'text/plain; charset=UTF-8',
'Content-Transfer-Encoding' => 'quoted-printable',
'X-Mailer' => 'studio-grasso-form',
];
$inviato = mail(
DESTINATARIO,
oggettoMime(PREFISSO_OGGETTO . $dati['oggetto']),
$corpo,
$intestazioni,
'-f' . MITTENTE // costante, nessun dato dell'utente nei parametri di sendmail
);
if (!$inviato) {
errore('Non è stato possibile inviare la richiesta per un problema tecnico.', 500);
}
vai(PAGINA_GRAZIE);