TAKETHEMP3 WEB PHP 2.0 ====================== REQUISITI - Hosting PHP 8.1+ con estensione cURL e proc_open abilitata - FFmpeg con encoder libmp3lame installato sul SERVER (non sui PC degli utenti) - HTTPS e spazio disco per i video MP4 lunghi - Server web Apache o Nginx (per Apache sono inclusi .htaccess) INSTALLAZIONE 1. Carica sul server tutto il progetto mantenendo le cartelle "public" e "private" separate. 2. Imposta la DocumentRoot del sito o sottodominio alla cartella "public". 3. Configura "config.php": percorso FFmpeg, eventuale codice di accesso e limiti. 4. Assicurati che l'utente PHP possa scrivere nella cartella private/jobs. 5. Apri l'URL del sito via HTTPS. Se non puoi impostare DocumentRoot: carica la cartella "public" in una directory pubblica, ma lascia "config.php" e "private" FUORI dalla cartella accessibile dal web, e modifica in public/api.php il percorso di config.php e private/jobs se necessario. INFORMAZIONI IMPORTANTI - PHP da solo non offre una codifica MP3 performante: serve FFmpeg sul server. - Controlla che "proc_open" NON sia disabilitata (disable_functions) e che FFmpeg sia eseguibile. - Per file grandi configura PHP: upload_max_filesize=4096M, post_max_size=4100M, max_input_time=3600, e nel web server client_max_body_size (Nginx) o Limiti Apache. - Timeout di Nginx/Apache/PHP-FPM/proxy possono interrompere file molto lunghi; il browser mantiene aperta la richiesta di conversione. In alcuni hosting condivisi non è possibile alzare questi limiti. In quel caso è necessario un worker/cron separato. - Gli upload e MP4 temporanei sono cancellati dopo la conversione (anche in errore), mentre gli MP3 vengono mantenuti un'ora. La pulizia scatta al ricevimento di una richiesta API; per la rimozione puntuale anche quando il sito non riceve traffico, configura un cron job. - Imposta un access_token in config.php e restringi l'accesso, soprattutto se esposto su Internet. - Gli URL esterni sono limitati a HTTPS su indirizzi IP pubblici e con controlli sui redirect, per ridurre i rischi SSRF. Applica anche firewall/limiti a livello hosting. - Il server deve poter scaricare i file dalle sorgenti remote; alcuni fornitori potrebbero bloccarlo o richiedere cookie, oppure non supportare download dal server. - La modalità URL Camera usa il link ufficiale "SCARICA" nella pagina /evento/. - L'elaborazione MP3 ricodifica l'audio. Non effettua il semplice rinominare AAC in MP3. TEST - php -l public/api.php - php -l public/index.php - Usa un MP4 breve, verifica MP3 e cancellazione di "input.mp4" da private/jobs/. CRON FACOLTATIVO PER LA PULIZIA PUNTUALE Esegui ogni 10 minuti: /usr/bin/php /percorso/TakeTheMP3_Web_PHP_v2.0/cron_cleanup.php VERSIONE 2.1 - DIAGNOSTICA 1. Sostituire sul server i file public/api.php, public/assets/app.js e public/index.php. 2. Ricaricare la pagina con refresh forzato (Ctrl+Shift+R / Cmd+Shift+R). 3. Premere "Verifica compatibilita server" e leggere i controlli. 4. Se "FFmpeg presente ed eseguibile" e rosso, configurare 'ffmpeg' nel config.php con il percorso del binario realmente installato sul server. 5. Se "Processi esterni" e rosso, l'hosting deve abilitarli: questa versione non puo convertire senza esecuzione FFmpeg. 6. Se tutti i controlli sono verdi, riprovare la conversione. Copiare soltanto il messaggio mostrato nella pagina, senza credenziali. NOTA: La diagnostica non testa da sola il CDN della Camera e non elimina i limiti di timeout per richieste HTTP di durata elevata. NOVITA 2.2: aggiorna public/api.php, public/index.php, public/assets/app.js e public/assets/style.css. Ora la pagina mostra quattro fasi, MB/s e avanzamento rilevato da un endpoint di stato separato. Per maggiore velocita l'applicazione usa un buffer di download cURL piu ampio; il tempo complessivo dipende comunque dalla connessione del server della Camera. Non sostituire il tuo config.php gia configurato se contiene password e percorso FFmpeg personalizzati. Nota: l'hosting deve consentire almeno due richieste PHP contemporanee per il polling indipendente.