Comment installer CodeIgniter sous Ubuntu ?

Introduction

Les instructions de cette page ont été testées sur un serveur Cloud9 avec les versions suivantes :

Linux 4.9.120-c9 (Comment connaître ma version de Linux ?)
Ubuntu 14.04.5 LTS Trusty (Comment connaître ma version d'Ubuntu ?)
PHP 7.2.9 (Comment connaître ma version de PHP ?)
CodeIgniter v3.1.9

Configuration du serveur

Installer MySQL

Si MySQL n'est pas installé, suivez les instructions suivantes :

Comment installer MySQL sous Ubuntu 14.04 ?

Installation de phpMyAdmin

Si phpMyAdmin n'est pas encore installé, il faut le faire grâce aux instructions de la page suivante:

Conserver le mot de passe et le nom d'utilisateur pour plus tard. Nous en aurons besoin pour configurer CodeIgniter.

Mise à jour de PHP

La première étape est la mise à jour de PHP. Ce n'est pas obligatoire, mais il est fortement recommandé d'utiliser la même version de PHP dans l'environnement de développement et de production. Dans mon cas, le serveur de production utilise PHP 7.2. Les instructions suivantes permettent de mettre PHP à jour vers la version 7.2 :

Comment passer à PHP 7.2 sur Ubuntu ?

Après la mise à jour :

username:~/workspace $ php -v
PHP 7.2.10-1+ubuntu14.04.1+deb.sury.org+1 (cli) (built: Oct  1 2018 12:19:38) ( NTS )
Copyright (c) 1997-2018 The PHP Group
Zend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies
    with Zend OPcache v7.2.10-1+ubuntu14.04.1+deb.sury.org+1, Copyright (c) 1999-2018, by Zend Technologies

Mettre à niveau MySQL

Commencez par vérifier la version de MySQL installée :

Comment connaître la version de MySQL ?

Pour mettre à niveau MySQL, suivez les instructions adéquates:

Installation et configuration du module Xdebug

Vérifiez si Xdebug est installé et correctement configuré. En cas de doute ou de réponse négative, je recommande fortement d'installer ce formidable outil de débug grâce aux instructions mentionnées sur cette page :

Comment installer et configurer Xdebug sous Ubuntu ?

Après installation et configuration, la fonction var_dump doit produire un affichage formaté conformément à l'illustration suivante :

Installation de CodeIgniter

Télécharger CodeIgniter sur cette page.
Décompressez l'archive.
Uploadez le contenu du répertoire CodeIgniter sur votre serveur. Le fichier Index.php doit être à la racine de votre serveur.

La première chose à faire est d'ouvrir le fichier application/config/config.php et de configurer l'URL du serveur :

$config['base_url'] = 'https://www.example.com/';

$config['base_url'] = 'https://localhost/';

Configuration de la base de données

Ouvrir le fichier application/config/database.php et configurez les paramètres de la base de données :

//application/config/database.php

// Adresse du serveur SQL
'hostname' => 'localhost',

// Nom d'utilisateur du serveur SQL
'username' => 'myUserName',

// Mot de passe associé à l'utilisateur ci-dessous
'password' => '********',

// Nom de la base de données (créez la base de données avec phpMyAdmin si nécessaire)
'database' => 'myDatabaseName',

Sécurité

Il est fortement recommandé d'utiliser un driver PDO en lieu et place de mysqli pour se prémunir des injections SQL :

//application/config/database.php

// Configure le driver PDO
'dsn'   => 'mysql:host=localhost; dbname=CodeIgniter; charset=utf8;',
'dbdriver' => 'pdo',

Il est également recommandé de reconner les dossiers system et application. une fois renommés, ouvrir le fichier index.php et modifier les variables $system_path et $application_folder avec les nouveaux noms que vous avez choisi.

Configuration des e-mails

Si l'application envoie des e-mails et que ces message sont toujours envoyés avec le même serveur, je vous recommande de configurer l'envoi des e-mails globalement au niveau de l'application. Créez un fichier email.php dans le dossier /application/config. Configurez votre paramètres dans ce fichier comme sur l'exemple suivant :

<?php
//applications/config/email.php

$config['protocol']     = 'smtp';
$config['smtp_host']    = 'mail.smtp_host.com';
$config['smtp_port']    = '465'; // 8025, 587 and 25 can also be used. Use Port 465 for SSL.
$config['smtp_crypto']  = 'ssl';
$config['smtp_user']    = 'username';
$config['smtp_pass']    = 'password';
$config['charset']      = 'utf-8';
$config['mailtype']     = 'html';
$config['newline']      = "\r\n";

La liste détaillée des paramètre peut être consultée dans la documentation de CodeIgniter.

Démarrer CodeIgniter

Démarrer le serveur et allez à la racine du site. Si tout s'est bien passé, vous devriez avoir une page d'accueil conformément à celle illustrée ci-dessous :

Voir aussi

Dernière mise à jour : 23/11/2021