Installazione mediante Composer

Composer può essere utilizzato in diversi modi per installare CodeIgniter4 sul tuo sistema.

Le prime due tecniche descrivono la creazione di uno scheletro per un nuovo progetto utilizzando CodeIgniter4, che utilizzeresti quindi come base per una nuova webapp. La terza tecnica descritta di seguito consente di aggiungere CodeIgniter4 ad una webapp esistente,

Note

se stai usando un repository Git per memorizzare il tuo codice, o per collaborazione con altri, quindi la cartella vendor sarebbe normalmente essere “git ignorato”. In tal caso, dovrai eseguire un composer update quando cloni il repository su un nuovo sistema.

App Starter

Il repository CodeIgniter 4 app starter contiene un’applicazione scheletro, con una dipendenza del compositore all’ultima versione rilasciata del framework.

Questa tecnica di installazione sarebbe adatta a uno sviluppatore che desidera iniziare un nuovo progetto basato su CodeIgniter4.

Installazione e configurazione

Nella cartella superiore rispetto alla radice del progetto:

> composer create-project codeigniter4/appstarter project-root

Il comando sopra creerà una cartella “project-root”.

Se ometti l’argomento “project-root”, il comando creerà un cartella “appstarter”, che può essere rinominata a seconda dei casi.

Se non hai bisogno o non vuoi installare phpunit e tutte le dipendenze del suo compositore, aggiungi l’opzione --no-dev alla fine della riga di comando sopra indicata. Ciò installerà solo il framework e l’albero delle dipendenze fidate, essendo installate dal compositore.

Un esempio di tale comando di installazione, utilizzando il “appstarter” di root del progetto predefinito:

> composer create-project codeigniter4/appstarter --no-dev

Dopo l’installazione è necessario seguire i passaggi nella sezione “Aggiornamento”.

Aggiornamento

Ogni volta che c’è una nuova versione, quindi dalla riga di comando nella radice del progetto:

> composer update

Se vuoi confrontare l’ultima struttura dei sorgenti del framework per directory non di sistema (app, public, ecc.), puoi aggiornare con --prefer-source:

> composer update codeigniter4/framework --prefer-source

Se --prefer-source non si aggiorna automaticamente per estrarre la struttura di origine del framework più recente, puoi rimuovere prima:

rm -rf vendor/codeigniter4/framework && composer update codeigniter4/framework --prefer-source

Se hai usato l’opzione --no-dev quando hai creato il progetto, sarebbe opportuno farlo anche qui, ad esempio composer update --no-dev.

Leggi le istruzioni di aggiornamento e controlla le cartelle designate app/Config per le modifiche interessate.

Pro

Installazione semplice; facile da aggiornare

Contro

Devi ancora controllare le modifiche di app/Config dopo l’aggiornamento

Struttura

Cartelle nel tuo progetto dopo la configurazione:

  • app, public, tests, writable

  • vendor/codeigniter4/framework/system

  • vendor/codeigniter4/framework/app & public (confronta con il tuo dopo l’aggiornamento durante l’utilizzo --prefer-source)

Latest Dev

The App Starter repo comes with a builds scripts to switch Composer sources between the current stable release and the latest development branch of the framework. Use this script for a developer who is willing to live with the latest unreleased changes, which may be unstable.

The development user guide is accessible online. Note that this differs from the released user guide, and will pertain to the develop branch explicitly.

In your project root:

php builds development

The command above will update composer.json to point to the develop branch of the working repository, and update the corresponding paths in config and XML files. To revert these changes run:

php builds release

After using the builds command be sure to run composer update to sync your vendor folder with the latest target build.

Adding CodeIgniter4 to an Existing Project

The same CodeIgniter 4 framework repository described in “Manual Installation” can also be added to an existing project using Composer.

Develop your app inside the app folder, and the public folder will be your document root.

In your project root:

> composer require codeigniter4/framework --prefer-source

As with the earlier two composer install methods, you can omit installing phpunit and its dependencies by adding the --no-dev argument to the composer require command.

Set Up

Copy the app, public, and writable folders from vendor/codeigniter4/framework to your project root

Copy the env, phpunit.xml.dist and spark files, from vendor/codeigniter4/framework to your project root

You will have to adjust the system path to refer to the vendor one, e.g., ROOTPATH . '/vendor/codeigniter4/framework/system', - the $systemDirectory variable in app/Config/Paths.php

Upgrading

Whenever there is a new release, then from the command line in your project root:

> composer update --prefer-source

Read the upgrade instructions, and check designated app/Config folders for affected changes.

Pros

Relatively simple installation; easy to update

Cons

You still need to check for app/Config changes after updating

Structure

Folders in your project after set up:

  • app, public, writable (when using --prefer-source)

  • vendor/codeigniter4/framework/system

Translations Installation

If you want to take advantage of the system message translations, they can be added to your project in a similar fashion.

From the command line inside your project root:

> composer require codeigniter4/translations

These will be updated along with the framework whenever you do a composer update.