Comment installer CodeIgniter sur Linux

CodeIgniter est un framework PHP open source léger qui fournit une boîte à outils simple et élégante pour développer des applications web. L’installation de CodeIgniter sur votre système est rapide et facile. Dans ce guide complet, nous allons parcourir le processus d’installation de CodeIgniter étape par étape. Nous couvrirons le téléchargement et le dézippage de CodeIgniter, la configuration d’un serveur web, la mise en place d’une base de données, la connexion de CodeIgniter à la base de données et le test que tout fonctionne correctement. Que vous soyez nouveau sur CodeIgniter ou que vous cherchiez à mettre en place un environnement de développement, ce didacticiel vous couvre. Commençons !

Conditions préalables

Avant d’installer CodeIgniter, vous devez avoir configuré les éléments suivants sur votre système :

• PHP version 7.2 ou supérieure
• Logiciel de serveur web comme Apache ou Nginx
• MySQL ou tout autre logiciel de base de données
• Logiciel éditeur de texte comme Visual Studio Code, Sublime Text, Atom etc.
• Connaissances de base en PHP et serveur web

PHP doit être installé et configuré correctement pour fonctionner avec CodeIgniter. Vous devez également avoir accès pour créer une nouvelle base de données via MySQL ou tout autre logiciel de base de données. La familiarité avec la syntaxe de base PHP et l’expérience de la configuration d’un serveur web vous aideront à comprendre la configuration de CodeIgniter.

Étape 1 – Télécharger CodeIgniter

Tout d’abord, nous devons télécharger la dernière version de CodeIgniter depuis son site officiel. Voici les étapes :

• Accédez à https://codeigniter.com/download
• Sur cette page, vous trouverez la version stable actuelle de CodeIgniter (qui est 4.x.x au moment de la rédaction).
• Cliquez sur le bouton Télécharger pour obtenir une archive zip de CodeIgniter.

Vous pouvez également télécharger CodeIgniter en cliquant sur le lien GitHub fourni sur le site. Cela vous amènera sur la page du référentiel CodeIgniter4. Ici, vous pouvez télécharger le fichier zip de la dernière validation.

Une fois téléchargé, décompressez l’archive et vous trouverez les fichiers CodeIgniter dans un dossier.

Étape 2 – Mettre en place un serveur Web

Nous devons maintenant mettre en place un serveur web qui servira notre application CodeIgniter. Pour ce guide, nous utiliserons Apache, mais vous pouvez utiliser n’importe quel serveur web comme Nginx à la place. Voici les étapes pour configurer un serveur web Apache :

• Installez Apache si vous ne l’avez pas déjà. Pour Ubuntu :

$ sudo apt update
$ sudo apt install apache2 

• Démarrer le serveur Apache :

$ sudo systemctl start apache2

• Créez un fichier de configuration d’hôte virtuel comme codeigniter.conf sous /etc/apache2/sites-available/ avec le contenu suivant :

<VirtualHost *:80>
    ServerName localhost
    ServerAlias localhost 
    DocumentRoot /var/www/html/codeigniter
    <Directory /var/www/html/codeigniter>
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

Cela configure un hôte virtuel nommé localhost pointant vers le répertoire d’installation de CodeIgniter.

• Activez l’hôte virtuel :

$ sudo a2ensite codeigniter.conf

• Redémarrez Apache pour que les modifications prennent effet :

$ sudo systemctl restart apache2

Le serveur web Apache est maintenant prêt à servir l’application CodeIgniter.

Étape 3 – Mettre en place une base de données

CodeIgniter nécessite une base de données pour stocker les données d’application comme les utilisateurs, les messages, les produits, etc. Créons une base de données MySQL pour notre application.

• Installez le serveur MySQL si vous ne l’avez pas déjà :

$ sudo apt update
$ sudo apt install mysql-server

• Connectez-vous à la console MySQL en tant que root :

$ sudo mysql

• Créez une base de données, disons ci_db :

mysql> CREATE DATABASE ci_db;

• Créez un nouvel utilisateur et accordez des autorisations :

mysql> CREATE USER 'ci_user'@'localhost' IDENTIFIED BY 'password'; 
mysql> GRANT ALL ON ci_db.* TO 'ci_user'@'localhost';

Cela crée une base de données nommée ci_db et un utilisateur ci_user avec tous les privilèges. Souvenez-vous du nom d’utilisateur, du mot de passe et du nom de la base de données car nous devons les configurer avec CodeIgniter plus tard.

Étape 4 – Configurer CodeIgniter

Nous devons maintenant configurer CodeIgniter pour se connecter à la base de données et le pointer vers les bons répertoires.

• Copiez le dossier CodeIgniter dézippé dans la racine du document Apache qui est /var/www/html/. Vous pouvez renommer le dossier ici.

$ sudo cp -r codeigniter-4.x.x /var/www/html/codeigniter  

• Ouvrez /var/www/html/codeigniter/app/Config/App.php et définissez l’URL de base :

public $baseURL = 'http://localhost/codeigniter/';

• Ouvrez /var/www/html/codeigniter/app/Config/Database.php et entrez les informations d’identification de la base de données :

public $default = [
    'DSN' => '',
	'hostname' => 'localhost',
	'username' => 'ci_user',
	'password' => 'password',
	'database' => 'ci_db',  
];

• Ouvrez /var/www/html/codeigniter/app/Config/Paths.php et définissez le chemin du dossier système :

public $systemDirectory = __DIR__ . '/../system';

Cela termine la configuration de base de CodeIgniter.

Étape 5 – Définir les autorisations

Pour la sécurité, nous devons définir les bonnes autorisations sur les fichiers et dossiers CodeIgniter.

• Donnez l’autorisation d’écriture au dossier system :

$ sudo chmod -R 755 /var/www/html/codeigniter/system  

• Donnez l’autorisation d’écriture au dossier app/Logs pour créer des fichiers journaux :

$ sudo chmod -R 755 /var/www/html/codeigniter/app/Logs

• Changez le propriétaire du répertoire racine CodeIgniter en le serveur web :

$ sudo chown -R www-data:www-data /var/www/html/codeigniter 

Dans Apache, www-data est l’utilisateur et le groupe par défaut. Changez-le en conséquence pour d’autres serveurs web.

Étape 6 – Tester CodeIgniter

Il est temps de tester notre installation de CodeIgniter.

• Visitez http://localhost/codeigniter/public/ dans votre navigateur. C’est le point de départ par défaut.
• Vous devriez voir la page d’accueil de CodeIgniter avec les informations php de base.
• Pour tester la connectivité de la base de données, créez un nouveau fichier info.php sous app/Controllers avec le code suivant :

<?php
namespace App\Controllers;
use CodeIgniter\Controller;
class Info extends Controller {
    public function index() {
        
        $db = \Config\Database::connect();
        $result = $db->query("SELECT * FROM ci_db.tables LIMIT 1");
        echo 'Base de données connectée avec succès. Nombre de tables : ' . $result->getResultArray()[0]->TABLE_NAME;
    }
}

• Visitez http://localhost/codeigniter/public/info pour voir le test de connectivité à la base de données.

Si vous voyez le nom de la table imprimé, CodeIgniter est configuré correctement et connecté à la base de données.

Dépannage

Voici quelques problèmes courants rencontrés pendant l’installation et comment les résoudre :

• Erreur page non trouvée – Vérifiez le baseURL défini dans App.php et essayez de naviguer vers /codeigniter/public au lieu de juste /codeigniter. Vérifiez également si le fichier .htaccess est présent dans le dossier public.
• Erreur de connexion à la base de données – Vérifiez à nouveau les informations d’identification de la base de données définies dans Database.php. Essayez de coder en dur les informations d’identification au lieu d’utiliser des variables.
• Erreurs d’autorisation refusée – Exécutez correctement les commandes chmod et chown pour les dossiers et fichiers CodeIgniter.
• Erreurs de configuration Apache – Vérifiez la syntaxe de la configuration de l’hôte virtuel. Activez-le à l’aide de la commande a2ensite. Redémarrez Apache après tout changement de configuration.
• La page d’accueil CodeIgniter ne s’affiche pas – Vérifiez les erreurs PHP consignées dans le dossier app/Logs. Corrigez les erreurs de syntaxe. Effacez également le cache du navigateur.
• Contactez votre fournisseur d’hébergement web si Apache, MySQL ou PHP n’est pas installé/configuré correctement.

Conclusion

Voilà qui conclut le tutoriel d’installation de CodeIgniter ! Nous avons téléchargé le dernier CodeIgniter, configuré le serveur web Apache, créé une base de données MySQL, configuré les chemins du système et les informations d’identification de la base de données, défini les autorisations de fichiers et testé la sortie. CodeIgniter est maintenant prêt pour le développement d’applications. Avec sa syntaxe simple, son riche ensemble de bibliothèques et sa documentation claire, vous pouvez rapidement construire des applications PHP puissantes avec CodeIgniter.