.env, Artisan e terminale

Modificare il file .env direttamente nel browser sotto Sites → .env. Utilizzare Ctrl/Cmd+S per salvare.

Installazione di server fresco

Il modo consigliato per bootstrap un nuovo server Herne è l'installatore unificato:

curl -fsSL https://raw.githubusercontent.com/fklavyenet/herne/main/install.sh | sudo bash

Installa lo stack core, scrive l'ambiente del pannello, crea il primo amministratore, installa le regole dei sudoer, configura nginx e può installare anche in modo facoltativo lo stack di posta.

Editore .env

Vai a Siti → .env per modificare il file di ambiente per la tua applicazione direttamente nel browser. L'editor legge e scrive {deploy_path}/.env.

  • Salva con Ctrl+S (o Cmd+S su macOS).
  • Il file viene scritto in modo atomico e riceve i permessi 640.
  • Fai clic su Load from .env.example per caricare i valori dal file di esempio, se presente.
  • Fai clic su Apply Redis defaults per inserire i valori di cache, sessione, coda e connessione predisposti da Herne per Redis.

Dopo aver modificato .env, eseguire optimize:clear o ricostruire le cache pertinenti dal runner Artisan in modo che l'applicazione legga i nuovi valori.

Esecuzione dei comandi Artisan

Eseguire qualsiasi php artisan command da Siti → Artisan. I metacaratteri conchiglia sono spogliati per la sicurezza. Vai a Siti → Artigianato e digita un comando senza il prefisso php artisan:

migrate --force
queue:restart
storage:link
key:generate

I metacaratteri conchiglia (&, |, ;, `, $(...), >, <) vengono rimossi per la sicurezza.

La pagina è particolarmente utile per azioni di follow-up comuni come key:generate, storage:link, migrazioni e ricostruzioni della cache dopo la modifica di .env.

Sicurezza APP_KEY

Le applicazioni Laravel hanno bisogno di un APP_KEY non vuoto. Installazione rapida protegge e genera come parte del flusso di installazione.

key:generate
optimize:clear

Non ruotare APP_KEY su un'applicazione di produzione esistente a meno che non si capisce l'impatto su cookie crittografati, sessioni e dati crittografati memorizzati.

Comando di migrazione del dominio canonico

Gli amministratori possono promuovere un dominio temporaneo del sito al dominio di produzione reale con il comando di migrazione canonica.

herne:sites:canonicalize-domain fklavye.webblocksui.com fklavye.net --www-alias --move-files --backup --dry-run

Applicare solo dopo aver esaminato il piano:

herne:sites:canonicalize-domain fklavye.webblocksui.com fklavye.net --www-alias --move-files --backup --force

Il comando aggiorna il dominio del sito, slug, aliases, metadati app, ambiente URL/name, percorso attivo, percorso di backup in pensione e configurazione Nginx. Non deve lasciare il vecchio dominio come alias o server_name.

Terminal Web

Il Web Terminal (Sites → Terminal) esegue i comandi come utente isolato nella directory di progetto web_root del sito. Vai a Siti → Terminal. I comandi vengono eseguiti come utente di shell isolato (shell_domainslug) all'interno della directory di progetto web_root del sito.

Restrizioni di sicurezza

Redirections di uscita (>, >>), sostituzione di comando ($(), backticks), e tubazioni sono bloccati nel terminale. I seguenti sono bloccati:

  • Redirection di uscita: >, >>
  • Sostituzione di comando: $(...), backticks
  • Tubo: |

Il terminale web ha un limite di 30 secondi per comando. Le operazioni lunghe, come il primo composer install, possono superarlo. In quel caso usa Deploy con il passaggio Composer attivo.

Log del server

Apri Siti → Log → Log del server per consultare i dati più recenti del server web per il sito corrente.

  • Passa tra i log di accesso di Nginx, i log degli errori di Nginx e quelli di PHP-FPM.
  • Le 200 righe più recenti sono mostrate per prime.
  • Usa Aggiorna per ricaricare il file corrente.
  • Usa Svuota per azzerare il file selezionato se i permessi del server lo consentono.
  • La scheda PHP-FPM è riservata agli amministratori.