Analizzare il configuration.php

Details

Category: Labs

Nei forum di supporto viene spesso chiesto di aiutare utenti con problemi di percorsi, password, connessioni database e altre questioni di configurazione generale. Spesso questi problemi si manifestano particolarmente dopo una migrazione o lo spostamento di un sito.

Molti non sanno che la maggior parte delle correzioni per questi problemi possono essere fatte nel file configuration.php e, anche se consigliamo queste operazioni solo ad utenti con conoscenze leggermente superiori a quelle di base in campo informatico, onde evitare spiacevoli conseguenze, (dato che agiremo su un file che è la linfa vitale di tutto il sito), analizzeremo a fondo il suddetto file e inizieremo a conoscere bene cosa questo file contiene e gestisce ricordando nuovamente che questo file molto importante per la stabilità del vostro sito... quindi non abusatene anche perchè tutte le modifiche possono essere tranquillamente effettuate direttamente da Cpanel Backend Joomla!.

Questa non è una guida completa di codifica, ma è un riferimento generale per aiutarvi a capire questo file.

Analizzeremo quindi dove trovare e individuare il file configuration.php e poi analizzaremo cosa significa e cosa dirige ogni impostazione contenuta in ogni riga.

Posizione del file configuration.php

Il file configuration.php si trova nella root della vostra installazione di Joomla.

Su uno spazio web remoto se si trova nella directory principale il percorso potrebbe essere simile a questo:

/home/nomesito/public_html/configuration.php

Su uno spazio web remoto se invece si trova in una sottodirectory il percorso potrebbe essere simile a questo:

/home/nomesito/public_html/sottodirectory/configuration.php

Se invece lavoriamo in locale utlizzando ad esempio XAMPP il percorso potrebbe essere simile a questo:

C:\Documents and Settings\My Documents\xampp\htdocs\J25\configuration.php

Prima di effettuare qualsiasi modifica a quest'importante file eseguite un backup del file configuration.php corrente.

Apriamo il file configuration.php con un editor di testo (assolutamente mai programmi come word o wordpad ). Scorriamo le righe proposte riga per riga e visualizziamo un riferimento rapido per ogni riga, con note e ulteriori spiegazioni che per molti potrebbero non solo essere utili ma necessarie.

Impostazioni sito

 
	public $offline = '0';
	public $offline_message = 'Sito fuori servizio per manutenzione.';
	public $display_offline_message = '1';
	public $offline_image = '';
	public $sitename = 'Nome del sito';
	public $editor = 'tinymce';
	public $captcha = '0';
	public $list_limit = '10';
	public $access = '1';

• $offline : Quando è impostato su "0" il sito è online. Di coseguenza quando impostato su "1" il sito è offline
• $offline_message : È possibile scrivere un messaggio di testo su questa linea. (Si consiglia di non inserire apici nella descrizione, e, se ossibile evitare anche caratteri speciali che potrebbero non essere visualizzati correttamente.)
• $display_offline_message :Se impostato su "0" utilizzaremo un messaggio predefinito della lingua, le altre due opzioni possibili sono, mostra un messaggio personalizzato, oppure non mostrare nulla
• $offline_image :In questa linea troviamo il riferimento ad un'immagine, se impostata, altrimenti il campo rimane vuoto.
• $sitename : Il nome del sito così come appare nel sito.
• $editor : L'editor scelto mone predefinito nelle configurazioni globali.
• $captcha : Le impostazioni di attivazione o disattivazione del captcha e scelta dello stesso nel caso fossero disponibili più opzioni (al momento di default solo recaptcha). 0 sta nessuna selezione
• $list_limit :La lunghezza delle liste nel Pannello di controllo per tutti gli utenti. Come impostazione predefinita il valore è fissato a 20.
• $access : Il livello di accesso predefinito al sito, Il livello di accesso predefinito che assumono gli utenti che si registrano sul sito il valore "1" significa accesso pubblico; "2" utenti registrati; "3" utenza speciale

Impostazioni di debug

 
	public $debug = '0';
	public $debug_lang = '0';

• $debug : "0" è disattivato. "1" è attivo.
• $debug_lang : "0" è disattivato. "1" è attivo.

Note

$debug : Questo attiverà il sistema di debug di Joomla!. Quando è impostato su Sì, questo strumento fornirà informazioni di diagnostica, le traduzioni in lingua, e gli errori SQL. Il tutto verrà visualizzato nella parte inferiore di ogni pagina, sia nel front-end che nel back-end.

$debug_lang : Questo evidenzia indicatori di debug (* ... *) o (? ...?) per i file lingua Joomla!.

Il Debug Lingua è indipendente e funziona senza lo strumento di sistema di debug attivato.

Questo strumento però non fornisce ulteriori riferimenti dettagliati che aiutano a correggere gli eventuali errori.

Impostazioni database

 
	public $dbtype = 'mysqli';
	public $host = 'localhost';
	public $user = 'utente sql';
	public $password = 'password sql';
	public $db = 'nome database';
	public $dbprefix = 'prefisso_';

• $dbtype : "mysqli" oppure "mysql" o altri.
• host : "localhost" su molti server, ma non su tutti.
• $user : Nome utente che ha accesso al database.
• $password : Password associata all'utente che ha accesso al database. Non è la password di amministrazione Joomla o la password FTP.
• $db : Nome creato al momento della creazione del database su cui si appoggia joomla.
• $dbprefix : Almeno tre caratteri che terminano in un carattere di sottolineatura. (Impostata quando si è installato joomla)

Note

Queste informazioni sono necessarie quando si installa il sito.

Dimenticare questi dati è spesso causa di problemi quando si sposta un sito.

Prima di spostare qualsiasi sito, effettuare una copia di backup del configuration.php in modo da poter fare riferimento alle impostazioni originali se ne avete bisogno.

$dbtype : cambiare solo se avete cambiato server e tipo di piattaforma database.

$host : Sulla maggior parte dei server è localhost. Altri hanno nomi diversi. Controllare con il vostro servizio di hosting, se non siete sicuri.

$user : Su server condivisi cPanel è spesso preceduto dal nome utente, ad esmpio mioutente_er3456

Sulla vostra macchina locale non ci sarà un prefisso a meno che non ne avete creato uno in questo caso potrà essere semplicemente root.

$password :Se si crea un sito sul tuo server locale è possibile non specificare la password quando si crea un database, sarete quindi in grado di accedere ai dati senza una password.

Questo non è possibile quando ci si sposta al server web online e in questo caso la pasword è richiesta

$db : Su server condivisi cPanel è spesso preceduto dal nome utente, ad esmpio mioutente_er3456

Sulla vostra macchina locale non ci sarà un prefisso a meno che non ne avete creato uno.

$dbprefix : Questo deve essere quello che è stato utilizzato quando è stato creato il database, o che viene effettivamente utilizzato dal database. Se si dispone di più di un prefisso è possibile modificarlo ma non è possibile crearne uno nuovo.

Altre funzioni extra

 
	public $live_site = '';
	public $secret = 'mkXQiYsnRfp3EmiT';
	public $gzip = '0';
	public $error_reporting = 'development';
	public $helpurl = 'http://help.joomla.org/proxy/....';

• $live_site: l'URL effettivo del sito, ad esempio - http://tuodominio.com (a meno che il sito è in una sottodirectory)
• $secret : NON CAMBIARE
• $gzip : "0" è disattivata la funzione, "1" è attiva la funzione. (Attiva la compressione delle pagine generate, se il tuo server lo supporta è consigliato attivarlo).
• $error_reporting : "-1" è il livello adeguato.
• $HelpURL : di default punta al sito joomla.org. Può essere impostato per le pagine di aiuto.

Note

$live_site : Nelle versioni più recenti non dovrebbe avere un valore.

Ma possono esserci dei casi in cui si ha bisogno di compilare un valore. Se si reindirizza un url devi mettere l'URL effettivo del sito direttamente su questa linea. Oppure, se si sta creando una copia di un sito per effettuare test o modifiche.

Ad esempio, ho un sito di prova in http://dmiosito.com/joomla25 che è una copia del mio sito principale quindi è obbligatorio cambiare questa riga nel file configuration.php sulla copia altrimenti si otterrà un errore di pagina non trovata se non è impostata a 'http://dmiosito.com/directory "o, nel caso di un sottodominio" http://sottodomino.dmiosito.com "Joomla usa questo URL per creare percorsi relativi. indispensabile verificare questo su siti di test.

$secret : Questo viene generato da Joomla! alla prima installazione e non è modificabile. Viene utilizzato internamente da Joomla! per motivi di sicurezza.

$error_reporting : Questo imposta il livello appropriato di reporting. L'impostazione è predefinita del sistema. Gli errori che possono accadere possono anche non avere alcun effetto sul sito. Non è necessario registrare tutti gli errori meno che non stiate facendo un lavoro dettagliato di debug. I registri potrebbero consumare il vostro spazio su disco altrimenti.

$helpurl : Il posto dove cercare informazioni di aiuto quando si fa clic sul pulsante Guida (visibile in molte schermate e le opzioni del pannello di amministrazione). Per impostazione predefinita, utilizza il sito principale della guida Joomla!, ma si potrebbe creare il proprio sito aiuto, o un link al tuo sistema di ticket per un aiuto.

Impostazioni FTP

Premettiamo che non è necessario inserire i dati di accesso FTP, e se si desidera utilizzare questa funzione assicurarsi che il server sia pienamente compatibile con le specifiche dettate da Joomla.

 
	public $ftp_host = '127.0.0.1';
	public $ftp_port = '21';
	public $ftp_user = '';
	public $ftp_pass = '';
	public $ftp_root = '';
	public $ftp_enable = '0';

• $ftp_host : "127.0.0.1" è l'indirizzo IP di default per localhost. Il server potrebbe essere diverso.
• $ftp_port : "21" di default è normale. Verificare con il proprio host se si hanno problemi. Non tutti i server sono uguali.
• $ftp_user : Nome utente FTP
• $ftp_pass : Password FTP
• $ftp_root : di solito un percorso tipo / home / username / public_html (senza slash finale)
• $ftp_enable : Questa impostazione dice a Joomla! di utilizzare la funzione built-in FTP al posto del processo utilizzato da PHP.

Impostazioni Time Zone

 
	public $offset = 'UTC';
	public $offset_user = 'UTC';

• $offset : predefinito è UTC
• $offset_user : predefinito è UTC

Note

$offset Questo strumento imposta la data e l'ora correnti. La data impostata deve essere quella in cui si trova il server.

L'impostazione predefinita è (00:00 UTC) Western Europe, Londra, Lisbona, Casablanca.

Impostazioni Email

 
	public $mailer = 'mail';
	public $mailfrom = 'vostramail';
	public $fromname = 'Utente';
	public $sendmail = '/usr/sbin/sendmail';
	public $smtpauth = '0';
	public $smtpuser = '';
	public $smtppass = '';
	public $smtphost = 'localhost';
	public $smtpsecure = 'none';
	public $smtpport = '25';

• $mailer : "mail" utilizza la funzione PHP mail; "sendmail" utilizza la funzione Sendmail; "smtp" utilizza il protocollo SMTP.
• $mailfrom : From E-mail. L'indirizzo email utilizzato da Joomla! per inviare le e-mail dal sito.
• $sendmail : il percorso in cui si trova il programma Sendmail. Questo percorso viene utilizzato solo se Mailer è impostato su Sendmail.
• $smtpauth : Se il server SMTP richiede l'autenticazione per inviare la posta, impostare questa opzione su Sì. In caso contrario, lasciare No. Questo viene utilizzato solo se Mailer è impostato su Sendmail.
• $smtpuser : Il nome utente da utilizzare per accedere all'host SMTP. Questo viene utilizzato solo se Mailer è impostato su SMTP.
• $smtppass : La password da utilizzare per accedere all'host SMTP. Questo viene utilizzato solo se Mailer è impostato su SMTP.
• $smtphost : Host SMTP. L'indirizzo SMTP da utilizzare per l'invio della posta. Questo viene utilizzato solo se Mailer è impostato su SMTP.
• $smtpsecure : Selezionare il modello di sicurezza che il server SMTP utilizza - Il valore predefinito è None. Le opzioni sono SSL e TTL.
• $smtpport : SMTP Port. La maggior parte dei server non protetti utilizzano la porta 25 e server più sicuri utilizzano la porta 465. Verificare con il proprio host.

Impostazioni cache

 
	public $caching = '0';
	public $cache_handler = 'file';
	public $cachetime = '15';

• $caching : "0" è off; "1" Impostazione Conservativa; "2" Impostazione Progressiva
• $cache_handler : "file" full cacheing ; "cachelite" lite cacheing

Notes

$caching : Questa impostazione imposta la durata massima del tempo (in minuti) per cui un file di cache deve essere immagazzinato prima di essere aggiornato. L'impostazione predefinita è 15 minuti.

$cache_handler : Questa impostazione imposta il funzionamento della cache. Esiste solo un meccanismo di caching, che è basato su file. Cachelite è un'alternativa al caching completo.

Impostazioni Metadata

 
	public $MetaDesc = '';
	public $MetaKeys = '';
	public $MetaTitle = '1';
	public $MetaAuthor = '1';
	public $robots = '';

• $MetaDesc : Inserire una descrizione testuale del sito. Utile per i motori di ricerca.
• $MetaKeys : Inserire parole chiave separate da una virgola.
• $MetaTitle : "0" è no; "1" è si.
• $MetaAuthor : "0" è no; "1" è si.
• $robots : Utilizza l'impostazione selezionata.

Notes

$MetaDesc : Questa è la descrizione del sito che viene indicizzata dai motori di ricerca.

$MetaKeys : Queste parole chiave descrivono il sito e sono la base per migliorare la posizione nei motori di ricerca ed aumentano la capacità degli spiders di indicizzare il sito.

$MetaTitle Questo è il titolo del contenuto che viene indicizzato dai motori di ricerca.

$MetaAuthor : Mostra le informazioni Meta Autore degli articoli e viene utilizzato dagli spider dei motori di ricerca per l'indicizzazione del sito

$robots Viene utilizzato dagli spider dei motori di ricerca per l'indicizzazione del sito e le impostazioni possono ad esempio essere follow o nofollow

Impostazioni SEO

 
	public $sef = '1';
	public $sef_rewrite = '1';
	public $sef_suffix = '0';
	public $unicodeslugs = '0';
	public $feed_limit = '10';

• $sef : "0: è no; "1" è sì
• $sef_rewrite : "0" è no; "1" è sì
• $sef_suffix : "0" è no; "1" è sì
• $unicodeslugs : "0" è no; "1" è sì
• $feed_limit : predefinito è 10 - ogni valore intero può essere usato

Notes

$sef: Search Engine Friendly URLs. Se impostata su Sì, gli URL sono riscritti per essere più amichevoli per gli spider dei motori di ricerca. Ad esempio, l'URL: www.esempio.com/index.php?option=com_content&view=etc ..., si trasformerebbe in: www.esempio.com/alias. La maggior parte degli elementi creati in Joomla! ha una alias che può essere inserito nelle URL per rendere più amichevole il lavoro dei motori di ricerca. L'impostazione predefinita è No.

$sef_rewrite : Se impostata su Sì, Joomla! utilizzerà le impostazioni mod_rewrite di Apache durante la creazione di URL durante la creazione di URL amichevoli per il motore di ricerca. Attenzione: si consiglia di non modificare alcun file htaccess senza avere le dovute conoscenze o senza avere la comprensione di come funziona. È necessario utilizzare il file htaccess fornito con Joomla! al fine di utilizzare questa impostazione. Per utilizzare questo file, rinominare il file htaccess.txt (che si trova nella directory root) in .htaccess Per impostazione predefinita, questa opzione è impostata su No.

$sef_suffix : Se impostata su Sì, Joomla! aggiungerà. html alla fine della URL. L'impostazione predefinita è No.

$unicodeslugs : Scegliere tra traslitterazione e alias unicode. La traslitterazione è impostata di default. Si tratta di una impostazione avanzata e probabilmente non sarà necessario cambiare questa se non si è esperti in SEO.

Impostazioni rapporti - Log

 
	public $log_path = '//home/username/public_html/j/logs';
	public $tmp_path = '//home/username\public_html/tmp';

• $log_path : 'Qua viene indicato il percorso assoluto alla cartella logs';
• $tmp_path : 'Qua viene indicato il percorso assoluto alla cartella tmp';

Notes

$log_path : Il percorso in cui i log devono essere conservati. L'installazione di Joomla! deve aver compilato automaticamente il percorso di questa cartella. Non è fondamentale per il funzionamento del sito, quindi se è errato lo sapremo solo se si tenta di controllare i log.

$tmp_path : Si tratta di un'impostazione importante e dovrebbe essere completata correttamente. Molti problemi nascono quando i siti sono spostati da locale a remoto, e gli errori sono causati dal fatto che joomla cerca la cartella tmp (temporanea) in una posizione diversa, probabilmente quella precedente. Se si manifestano degli errori per quanto riguarda la cartella tmp controllare questo percorso e assicurarsi che sia corretto e scrivibile.

Impostazioni Sessione

 
	public $lifetime = '15';
	public $session_handler = 'database';

• $lifetime : Un numero intero che indica i minuti.
• $session_handler = "database" oppure "none"

Notes

$lifetime : Questa impostazione definisce la durata di una sessione e quanto tempo può rimanere aperto l'accesso per un utente (prima di essere inattivo). L'impostazione predefinita è 15 minuti.

$session_handler : Questa impostazione imposta come la sessione dovrebbe essere gestita una volta che un utente si collega e accede al sito. Di default è impostato su Database.

Altre Impostazioni

 
	public $MetaRights = '';
	public $sitename_pagetitles = '0';
	public $force_ssl = '0';
	public $feed_email = 'author';
	public $cookie_domain = '';
	public $cookie_path = '';

• $MetaRights : Impostazione aggiuntiva per i Meta Tag
• $sitename_pagetitles : Se impostato inserisce il titolo del sito nelle pagine
• $force_ssl : Impostazione per attivare o meno il servizio SSL
• $feed_email : Impostazione per indicare l'indirizzo mail nei feed
• $cookie_domain : Dominio da indicare nei cookie
• $cookie_path : Percorso per il salvataggio dei cookie.

• < Prev
• Next >