Il file config.php di Nextcloud: tutto ciò che devi sapere per la con­fi­gu­ra­zio­ne

Il file config.php di Nextcloud è il prin­ci­pa­le file di con­fi­gu­ra­zio­ne di questo famoso software cloud ed è re­spon­sa­bi­le della gestione di numerosi aspetti fon­da­men­ta­li per il fun­zio­na­men­to del server. Il file è mo­di­fi­ca­bi­le con un semplice editor di testo. Ogni modifica deve essere però fatta con cautela, in quanto una con­fi­gu­ra­zio­ne errata può causare ra­pi­da­men­te in­sta­bi­li­tà ed errori.

De­fi­ni­zio­ne: che cos’è il file config.php di Nextcloud?

Su Nextcloud, il file config.php svolge la funzione di file di con­fi­gu­ra­zio­ne centrale per molte im­po­sta­zio­ni di base del server. Queste com­pren­do­no anche la con­fi­gu­ra­zio­ne fon­da­men­ta­le del server e le con­nes­sio­ni ai database, oltre a variabili relative a sicurezza e pre­sta­zio­ni. In questo file sono definite anche le opzioni per i log di Nextcloud, ad esempio per l’im­po­sta­zio­ne del livello di log o per scegliere i metodi di registro. Tuttavia, sono numerose le im­po­sta­zio­ni di Nextcloud che non si trovano all’interno del file config.php. Ad esempio, le im­po­sta­zio­ni delle app di Nextcloud sono gestite di solito di­ret­ta­men­te dalle singole ap­pli­ca­zio­ni.

Il file di con­fi­gu­ra­zio­ne è uno strumento in­di­spen­sa­bi­le per per­so­na­liz­za­re e gestire Nextcloud. So­li­ta­men­te viene mo­di­fi­ca­to durante l’in­stal­la­zio­ne del software, quando si apportano modifiche all’in­fra­strut­tu­ra cloud e durante la ri­so­lu­zio­ne dei problemi. Per questi motivi è im­por­tan­te che gli am­mi­ni­stra­to­ri di Nextcloud sappiano come gestire il file config.php.

Il formato del file config.php

In generale, config.php di Nextcloud è un normale file di testo che prevede alcuni requisiti di for­mat­ta­zio­ne speciali per i diversi parametri e valori. Tali requisiti as­si­cu­ra­no la pos­si­bi­li­tà di ampliare il file e rendono più semplice l’in­te­ra­zio­ne con il software Nextcloud. Inoltre, è possibile vi­sua­liz­za­re il file in qualsiasi vi­sua­liz­za­to­re di testo o tramite riga di comando.

Da un punto di vista tecnico, il file di con­fi­gu­ra­zio­ne è un file PHP con un array speciale de­no­mi­na­to $CONFIG. Si tratta di una mappa ordinata che collega valori e chiavi. I singoli parametri possono quindi cor­ri­spon­de­re a diversi tipi di dati:

• Integer: numeri interi, come “0”, “1”, “2” e “3”
• Float: numeri a virgola mobile come “1.234” o “77.55”
• String: sequenze di caratteri, come “abcdefg”, con una lunghezza massima di quattro kilobyte
• Boolean: valore booleano, che può essere true (vero) o false (falso)

Ca­ri­ca­men­to del file config.php di Nextcloud

Il file di con­fi­gu­ra­zio­ne config.php si trova nella cartella config/ dell’in­stal­la­zio­ne di Nextcloud ed è possibile com­ple­tar­lo con ulteriori dati me­mo­riz­za­ti al suo interno. A tal fine è ne­ces­sa­rio de­no­mi­na­re il file secondo lo schema *.config.php e for­mat­tar­lo cor­ret­ta­men­te.

All’avvio, Nextcloud analizza au­to­ma­ti­ca­men­te il percorso del file config.php per rilevare eventuali modifiche e lo controlla re­go­lar­men­te durante il fun­zio­na­men­to. Con le im­po­sta­zio­ni pre­de­fi­ni­te di OPcache, il software controlla la cartella alla ricerca di ag­gior­na­men­ti ogni due secondi; nella maggior parte delle versioni pre­de­fi­ni­te il controllo viene eseguito invece ogni 60 secondi circa.

Come si lavora con il file config.php di Nextcloud?

Se desideri mo­di­fi­ca­re il file config.php di Nextcloud, procedi come segue:

1. Crea sempre un backup prima di mo­di­fi­ca­re il file di con­fi­gu­ra­zio­ne. Il comando per farlo è: sudo cp /var/snap/nextcloud/current/nextcloud/config/config.php config.php.bak.
2. Apri quindi il file nel tuo editor di testo locale con il seguente comando: sudo nano /var/snap/nextcloud/current/nextcloud/config/config.php.
3. Aggiungi i parametri de­si­de­ra­ti o modifica le voci già presenti.
4. Salva le modifiche, quindi controlla se il server Nextcloud funziona come previsto.

As­si­cu­ra­ti di uti­liz­za­re la sintassi corretta, perché anche una virgola mancante o un errato po­si­zio­na­men­to delle vir­go­let­te possono avere con­se­guen­ze sull’intero sistema, nel peggiore dei casi. Una sintassi errata può non soltanto com­pro­met­te­re la fun­zio­na­li­tà, ma anche causare problemi di sicurezza e un degrado delle pre­sta­zio­ni. Per in­di­vi­dua­re e risolvere ra­pi­da­men­te eventuali problemi, ti con­si­glia­mo di eseguire le modifiche gra­dual­men­te.

I parametri più im­por­tan­ti

Il file config.php di Nextcloud permette di regolare numerosi parametri in modo fles­si­bi­le. Un elenco completo di tutti i parametri di con­fi­gu­ra­zio­ne di­spo­ni­bi­li con commenti utili si trova nel file config.sample.php, caricato durante l’in­stal­la­zio­ne di Nextcloud. La do­cu­men­ta­zio­ne di Nextcloud contiene una de­scri­zio­ne det­ta­glia­ta delle singole variabili. La pa­no­ra­mi­ca seguente mostra i parametri prin­ci­pa­li che gli am­mi­ni­stra­to­ri e le am­mi­ni­stra­tri­ci devono conoscere e saper mo­di­fi­ca­re a seconda delle necessità:

Im­po­sta­zio­ni di base

• dbtype: tipo di database
• dbname: nome del database uti­liz­za­to
• dbhost: nome dell’host o indirizzo IP del server del database
• trusted_domains: definisce i domini o gli indirizzi IP da cui è possibile accedere

User ex­pe­rien­ce (espe­rien­za utente)

• default.language: indica la lingua pre­de­fi­ni­ta
• default.phone.region: imposta la regione pre­de­fi­ni­ta per i numeri di telefono

User session (sessione utente)

• remember_login_cookie_lifetime: definisce la durata del cookie di accesso
• session_lifetime: indica quando ha termine una sessione inattiva

Mail

• mail_domain: definisce l’indirizzo del mittente per le e-mail in uscita