Installazione

TubePress si installa come qualsiasi classica applicazione PHP: carica i file, punta un browser sul tuo dominio e segui una breve procedura guidata web. Nessuna riga di comando, nessuna fase di build.

Calcola circa cinque minuti. Prima di iniziare, verifica che il server soddisfi i requisiti e tieni a portata di mano i dati del database.

Scarica TubePress

Scarica l’ultima versione dalla pagina di download. È un unico piccolo ZIP contenente il sorgente PHP completo e modificabile — senza chiave di licenza e senza ionCube.

Carica sul tuo server

Estrai lo ZIP e carica il contenuto sul tuo server tramite FTP/SFTP o il file manager del tuo host. La regola fondamentale: il web root deve puntare alla directory public/, non alla radice del progetto. Tutto il resto — config/, src/, storage/, themes/, plugins/ — si trova un livello sopra la document root e non viene mai servito direttamente.

Avvia il programma di installazione web

Visita il tuo dominio con un browser. Poiché non esiste ancora il marcatore config/installed.php, TubePress ti rimanda direttamente alla procedura guidata di configurazione. Si compone di sei passaggi:

1. Benvenuto. Una breve schermata introduttiva — clicca per iniziare.
2. Verifica del sistema. Controlla la versione PHP, le estensioni e le cartelle scrivibili. Quando tutti i controlli richiesti vengono superati, avanza automaticamente; se qualcosa fallisce, ogni voce si espande con le istruzioni per risolvere il problema.
3. Database. Inserisci l’host, il nome, l’utente e la password del database. TubePress si connette, crea il database se possibile (o ne usa uno esistente sull’hosting condiviso), esegue tutte le migrazioni SQL e scrive config/database.php. Il campo host accetta anche host:port o un percorso socket.
4. Amministratore. Crea il tuo account admin — un nome utente (3–50 caratteri), un’email valida e una password di almeno 8 caratteri.
5. Impostazioni. Assegna un nome al tuo sito (la descrizione è facoltativa). L’URL del sito viene rilevato automaticamente e i video per pagina hanno come valore predefinito 24 — entrambi modificabili in seguito.
6. Completamento. TubePress genera le pagine predefinite, le impostazioni e i valori SEO di default, scrive il marcatore di installazione e ti fornisce il link al nuovo pannello di amministrazione.

Permessi dei file

L’utente del server web (spesso www-data) deve essere proprietario e poter scrivere in tre posizioni: config/ (per salvare le impostazioni), storage/ (log, file temporanei e backup) e public/uploads/ (i tuoi file multimediali). La Verifica del sistema segnala quelle che non sono scrivibili.

# Give the web-server user ownership
chown -R www-data:www-data config storage public/uploads

# Directories 755, files 644
find config storage public/uploads -type d -exec chmod 755 {} \;
find config storage public/uploads -type f -exec chmod 644 {} \;

Solo questi tre percorsi devono essere scrivibili dal server; il resto della struttura può rimanere in sola lettura.

Apache vs Nginx

Entrambi sono completamente supportati e vengono rilevati automaticamente durante l’installazione.

• Apache — imposta AllowOverride All in modo che i file .htaccess inclusi gestiscano gli URL puliti e blocchino l’accesso alle cartelle sensibili. Al termine, TubePress crea i symlink public/themes e public/templates in modo che le risorse del tema vengano risolte correttamente.
• Nginx — aggiungi la regola standard try_files … /index.php?$query_string, crea alias /themes/ e /templates/ verso le cartelle del progetto e nega l’accesso ai percorsi config/, src/ e storage/. Gli snippet completi si trovano in Requisiti.

Sviluppo locale (localhost)

TubePress funziona su un’installazione localhost semplice in HTTP senza alcuna configurazione speciale — il programma di installazione, le sessioni e il login funzionano tutti senza HTTPS. Due semplici opzioni:

• Un server web locale (il più vicino alla produzione) — punta Apache o Nginx alla cartella public/, esattamente come sopra.
• Il server integrato di PHP (configurazione zero) — dalla radice del progetto, esegui il comando seguente, poi apri http://localhost:8000.

php -S localhost:8000 -t public public/router.php

Il file router.php incluso fornisce URL puliti, e il front controller serve direttamente le risorse del tema e dell’amministrazione — quindi lo stile funziona immediatamente anche senza configurare alias per le risorse.

Dopo l’installazione

Accedi a /admin con l’account appena creato e inizia a configurare il tuo sito. La guida ai primi passi ti guida attraverso l’identità del sito, il branding, i primi video e una checklist per il go-live. Vale anche la pena rafforzare il login admin fin da subito — vedi Sicurezza.

Prossimi passi