Як встановити CodeIgniter на Ubuntu

CodeIgniter давно став фаворитом серед PHP-розробників завдяки простоті використання, відмінній продуктивності та мінімальним вимогам до конфігурації. У міру розвитку веб-технологій CodeIgniter продовжує адаптуватися, пропонуючи надійну платформу для створення сучасних веб-додатків. Цей посібник присвячено встановленню CodeIgniter 4, останньої основної версії, яка привнесла значні поліпшення і нові можливості у фреймворк.

Необхідні умови

Сервер під управлінням однієї з наступних операційних систем: Ubuntu і будь-який інший дистрибутив на базі Debian, наприклад Linux Mint.
Рекомендується використовувати свіжу інсталяцію ОС, щоб уникнути можливих проблем.
Базове знайомство з терміналом та інтерфейсом командного рядка.
SSH-доступ до сервера (або просто відкрийте Terminal, якщо ви перебуваєте на робочому столі).
Активне підключення до Інтернету. Інтернет-з’єднання знадобиться для завантаження необхідних пакетів і залежностей.
Система Ubuntu 24.04 з правами root або користувач із привілеями sudo.

Встановлення CodeIgniter на Ubuntu 24.04

Крок 1. Оновлення репозиторію пакетів.

Підтримка системи в актуальному стані має вирішальне значення для безпеки та продуктивності. Почніть з оновлення списків пакетів і оновлення встановлених пакетів:

sudo apt update
sudo apt upgrade

Ці команди отримають останню інформацію про пакети й оновлять усі застарілі пакети до останніх версій.

Крок 2. Встановлення веб-сервера Apache.

Apache – це популярний веб-сервер, який чудово поєднується з CodeIgniter. Щоб встановити Apache:

sudo apt install apache2

Після встановлення запустіть і ввімкніть Apache для запуску під час завантаження системи:

sudo systemctl start apache2
sudo systemctl enable apache2

Переконайтеся в правильності встановлення, відкривши IP-адресу вашого сервера у веб-браузері. Ви повинні побачити стандартну сторінку вітання Apache.

Крок 3. Встановлення PHP і необхідних розширень.

CodeIgniter 4 вимагає PHP 7.4 або пізнішої версії. Ubuntu 24.04 за замовчуванням постачається з PHP 8.3, який сумісний з CodeIgniter 4. Встановіть PHP і необхідні розширення:

sudo apt install php libapache2-mod-php php-mysql php-curl php-json php-cgi php-xsl php-intl php-mbstring php-zip php-xml -y

Ця команда встановлює PHP разом із розширеннями, широко використовуваними у веб-розробці. Після встановлення перезапустіть Apache, щоб застосувати зміни:

sudo systemctl restart apache2

Щоб перевірити встановлення PHP, створіть файл PHP info:

echo "<?php phpinfo(); ?>" | sudo tee /var/www/html/phpinfo.php

Зайдіть у цей файл через веб-браузер (http://your_server_ip/phpinfo.php), щоб побачити подробиці конфігурації PHP.

Крок 4. Встановлення сервера баз даних MySQL.

Хоча CodeIgniter підтримує різні бази даних, MySQL є популярним вибором. Встановіть сервер MySQL:

sudo apt install mysql-server

Захистіть свою установку MySQL, запустивши скрипт безпеки:

sudo mysql_secure_installation

Дотримуйтесь підказок, щоб встановити пароль root і видалити небезпечні налаштування за замовчуванням.

Крок 5. Встановлення Composer.

Composer – це інструмент управління залежностями для PHP, який спрощує процес встановлення та оновлення CodeIgniter. Встановіть Composer за допомогою наступних команд:

curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer
sudo chmod +x /usr/local/bin/composer

Перевірте встановлення:

composer --version

Крок 6. Встановлення CodeIgniter через Composer.

Встановивши Composer, ви можете легко налаштувати CodeIgniter. Перейдіть у кореневий каталог вашого сайту:

cd /var/www/html

Створіть новий проєкт CodeIgniter:

sudo composer create-project codeigniter4/appstarter ci4-project

Ця команда створює нову директорію ci4-project, що містить свіжу установку CodeIgniter 4.

Крок 7. Налаштуйте Apache для CodeIgniter.

Створіть нову конфігурацію віртуального хоста Apache для вашої програми CodeIgniter:

sudo nano /etc/apache2/sites-available/codeigniter.conf

Додайте таку конфігурацію, замінивши your_domain.com на ваш реальний домен:

<VirtualHost *:80>
ServerAdmin webmaster@your_domain.com
ServerName your_domain.com
DocumentRoot /var/www/html/ci4-project/public

<Directory /var/www/html/ci4-project/public>
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

Збережіть і закрийте файл. Увімкніть нову конфігурацію і вимкніть сайт за замовчуванням:

sudo a2ensite codeigniter.conf
sudo a2dissite 000-default.conf

Увімкніть модуль перезапису і перезапустіть Apache:

sudo a2enmod rewrite
sudo systemctl restart apache2

Переконайтеся, що Apache може читати і записувати в потрібні каталоги:

sudo chown -R www-data:www-data /var/www/html/ci4-project
sudo chmod -R 755 /var/www/html/ci4-project

Крок 8. Налаштуйте підключення до бази даних.

Відредагуйте файл конфігурації бази даних:

sudo nano /var/www/html/ci4-project/app/Config/Database.php

Оновіть налаштування бази даних за замовчуванням:

public $default = [
'DSN' => '',
'hostname' => 'localhost',
'username' => 'your_mysql_username',
'password' => 'your_mysql_password',
'database' => 'your_database_name',
'DBDriver' => 'MySQLi',
'DBPrefix' => '',
'pConnect' => false,
'DBDebug' => (ENVIRONMENT !== 'production'),
'charset' => 'utf8',
'DBCollat' => 'utf8_general_ci',
'swapPre' => '',
'encrypt' => false,
'compress' => false,
'strictOn' => false,
'failover' => [],
'port' => 3306,
];

Замініть your_mysql_username, your_mysql_password і your_database_name на ваші реальні облікові дані MySQL та ім’я бази даних.

Крок 9. Перевірте встановлення CodeIgniter.

Зайдіть у ваш додаток CodeIgniter через веб-браузер: http://your_domain.com. Ви маєте побачити сторінку привітання CodeIgniter, що свідчить про успішне встановлення.

Якщо у вас виникли проблеми, перевірте журнали помилок Apache:

sudo tail -f /var/www/log/error.log

Вітаємо! Ви успішно встановили CodeIgniter. Для отримання додаткової допомоги або корисної інформації ми рекомендуємо вам відвідати офіційний сайт CodeIgniter.