Struttura dell'applicazione Yii

Prima di proseguire nella guida è bene soffermarci un momento sulla struttura del file system della nostra applicazione. Abbiamo organizzato nella seguente tabella le informazioni dettagliate su come il framework organizza i file e le directory di una webapp. Per ogni cartella e file è presente una breve descrizione della sua funzione che vi aiuterà nel capire a cosa serve quella specifica cartella o specifico file.

applicazione
   index.php                	//il file di ingresso per l’applicazione
   index-test.php           	//il file di ingresso per i test sull’applicazione
   assets/                   	//contiene file pubblicati in precedenza
   css/                      	//contiene i fogli di stile
   images/                  	//contiene le nostre immagini
   themes/                  	//contiene i temi dell’applicazione
   protected/               	//contiene i file protetti dell’applicazione
      yiic                   	//yiic command line script per utenti Linux
      yiic.bat              	//yiic command line script per utenti Windows
      yiic.php               	//yiic command line PHP script
      commands/             	//contiene i comandi personalizzati per le applicazioni consolle
         shell/              	//contiene i comandi shell personalizzati per le applicazioni console
      components/            	//contiene i componenti 
         Controller.php      	//la classe base del controller
         UserIdentity.php    	//classe usata per l’autenticazione
      config/                	//contiene i file di configurazione
         console.php         	//file di configurazione per le applicazioni console
         main.php            	//file di configurazione per le applicazioni web
         test.php            	//file di configurazione per le unit test
      controllers/           	//contiene le classi controller
         SiteController.php  	//il controller di deafult dell’applicazione
      data/                  	//dati di esempio del database
         schema.mysql.sql    	//the DB schema di MySql
         schema.sqlite.sql   	//the DB schema di SqlLite
         testdrive.db        	//dati esempio di SqlLite
      extensions/            	//contiene le estensioni di terze parti
      messages/              	//contiene la traduzione del testo nelle varie lingue
      models/                	//contiene le classi di tipo model
         LoginForm.php       	//model login
         ContactForm.php     	//model contatti
      runtime/               	//file temporanei generati in fase di esecuzione
      tests/                 	//contiene i file di test
      views/                 	//contiene le viste e il layout dell’applicazione
         layouts/            	//contiene il layout
            main.php        	//il layout condiviso da tutte le pagine
            column1.php      	//layout a singola colonna
            column2.php      	//layout a doppia colonna
         site/               	//vista per il controllo site
            pages/           	//contiene pagine statiche
               about.php     	//vista  della pagina about
            contact.php     	//la vista della pagina contatti
            error.php        	//la vista degli errori
            index.php        	//la vista della pagina index
            login.php        	//la vista per l’action login

Ricordo che queste cartelle sono situate all'interno della directory della nostra applicazione poiché in fase di creazione abbiamo scelto questa soluzione. Si veda il paragrafo installazione per ulteriori chiarimenti.

Path e alias

Yii dispone di una serie di alias che ci consentono facilmente di puntare alle cartelle con pochi comandi. In un'applicazione Yii ci sono delle cartelle ritenute fondamentali ed è proprio su di esse che sono definiti gli alias.

Esistono 5 alias predefiniti che sono:

• System: la directory principale del framework, framework appunto
• Zii: si riferisce alla directory zii di cui parleremo più avanti
• Application: si riferisce alla directory protected
• Webroot: si riferisce alla cartella in cui abbiamo creato l'applicazione
• Ext: la cartella extensions