Login
Libri
Home Le Classi Classe Config

Classe Config

Share

La Classe Config fornisce un mezzo per recuperare le preferenze di configurazione. Tali preferenze possono provenire dal file di configurazione di default (application/config/config.php) oppure da propri files di configurazione personalizzati.

Nota: Queata classe è inizializzata autamaticamente dal sistema così ché non è necessario farlo manualmente.

Anatomia di un file Config

Di dafult, CodeIgniter ha un file di configurazione principale, situato in application/config/config.php. Se si apre il file con un normale edito di testo ci si accorge che tutti gli oggetti di configurazione sono salvati in un array chiamato $config.

E' possibile aggiungere proprio oggetti di configurazione a questo file, oppure, se lo si preferisce, si ha la possibilità di creare propri parametri di configurazione in un file diverso, creando e salvando il file nella cartella config.


$this->load->library('cart');

Nota: Se si creare un nuovo file di configurazione è bene utilizzare lo stesso formato di quello principale, salvando i proprio oggetti in un array chiamato $config. Sarà poi CodeIgniter a gestire intelligentemente questi file così non ci saranno conflitti con array con lo stesso nome (ovviamente non ci devono essere indici chiamati nello stesso modo).

Caricare un file di configurazione

Nota: CodeIgniter carica automaticamente il file di configurazione principale (application/config/config.php), solo se si è creato un proprio file di configurazione sarà necessario segurire la seguente procedura.

Esitono due modi per caricare un file di configurazione:

  1. Caricamento Manuale

    Per caricare un file di configurazione occorrerà utilizzare la seguente funzione all'interno del controller desiderato:

    
    $this->config->load('filename');
    
    

    Dove filename is the name of your config file, without the .php file extension.

    Se occorre caricare più file di configurazione, normalmente vengono uniti in un unico array master di configurazione. Potrebbero esistere dei nomi di indici duplicati. Per evitare problemi è possibile aggiugere, come secondo parametro, TRUE ed ogni file di configurazione verrà memorizzato in un array avente il nome del file stesso. Esempio:

    
    // Stored in an array with this prototype: $this->config['blog_settings'] = $config
    $this->config->load('blog_settings', TRUE);
    
    

    Si rimanda alla sezione Recuperare i Parametri di Configurazione per imparare come recuperare i valori configurati.

    Il terzo parametro permette di non considerare errore l'eventalità che il file di configurazione non esista:

    
    $this->config->load('blog_settings', FALSE, TRUE);
    
    
  2. Caricamento Automatico

    Se si ritiene che un particolare file di configurazione sia necessario a livello di intera applicazione, è possibile farlo caricare direttamente dal sistema. Per fare ciò, sarà sufficiente aprire il file file, situato in application/config/autoload.php, ed aggiungere il proprio file come indicato nel file stesso.

Recuperare i parametri di configurazione

Per recuperare un parametro dal proprio file di configurazione, utilizzare la seguente funzione:


$this->config->item('item name');

Dove item name è l'inidce dell'array $config che si intende recuperare. Per esempio, per recuperare il linguaggio si procederà:


$lang = $this->config->item('language');

La funzione restituirà FALSE (boolean) quando l'indice che si sta cercando di recuperare non esiste.

Se si utilizza il secondo parametro della funzione $this->config->load in modo da assegnare i propri parametri di configurazione in uno specifico indice, è pessibile recuperarlo specificando il nome dell'indice come secondo parametro della funzione $this->config->item(). Per esempio:


// Loads a config file named blog_settings.php and assigns it to an index named "blog_settings"
$this->config->load('blog_settings', TRUE);

// Retrieve a config item named site_name contained within the blog_settings array
$site_name = $this->config->item('site_name', 'blog_settings');

// An alternate way to specify the same item:
$blog_config = $this->config->item('blog_settings');
$site_name = $blog_config['site_name'];

Impostare un Parametro di Configurazione

Se si vuole impostare un parametro di configurazione in modo dinamico, oppure cambiarne uno esistente, è possibile usare:


$this->config->set_item('item_name', 'item_value');

Dove item_name è l'indice dell'array $config che si vuole cambiare, e item_value ne è il valore.

Funzioni di Helper

La classe Config ha le seguenti funzioni di aiuto:

$this->config->site_url();

Questa funzione recupera l'URL del proprio sito, This function retrieves the URL to your site, cioé il valore che è stato specificato nel file di configurazione.

$this->config->system_url();

Questa funzione restituisce l'URL della cartella di systema.

Ultimo aggiornamento ( Giovedì 13 Gennaio 2011 05:14 )