Как установить фреймворк Laravel PHP на Ubuntu 24.04

Laravel — это фреймворк веб-приложений на основе PHP, который используется для создания корпоративных веб-приложений. Это бесплатный и открытый веб-фреймворк, который следует архитектуре модель-вид-контроллер (MVC) и основан на Symfony. Он предоставляет элегантный синтаксис, который позволяет создавать приложения с чистым кодом, который легко читать и понимать.

Laravel — это фреймворк веб-приложений корпоративного уровня для создания надежных полнофункциональных веб-приложений. Приложения Laravel могут быть быстро развернуты без головной боли, от процесса разработки до производства.

Этот гид научит вас, как установить веб-фреймворк Laravel на сервер Ubuntu 24.04. Вы установите Laravel с помощью стека LAMP (Linux, Apache, MySQL/MariaDB и PHP) и менеджера пакетов PHP Composer.

Предварительные требования

Перед началом этого руководства убедитесь, что у вас есть следующее:

• Сервер Ubuntu 24.04.
• Пользователь без прав root с правами администратора

Установка стека LAMP и Composer

Laravel — это популярный фреймворк PHP для современного веб-разработки. Поэтому вы должны убедиться, что PHP и другие зависимости установлены на вашем сервере Ubuntu. В этом разделе вы установите Laravel с помощью стека LAMP (Linux, Apache, MySQL/MariaDB и PHP) и Composer.

Перед установкой пакета выполните следующую команду, чтобы обновить репозиторий Ubuntu.

sudo apt update

Теперь выполните следующую команду, чтобы установить зависимости Laravel, включая стек LAMP (Linux, Apache, MySQL/MariaDB и PHP), Composer и Git.

sudo apt install apache2 mariadb-server php php-curl php-bcmath php-json php-mysql php-mbstring php-xml php-tokenizer php-zip composer git

Введите Y, чтобы продолжить установку.

После завершения установки проверьте статус службы Apache и MariaDB. Затем проверьте версии PHP и Composer.

Проверьте статус службы Apache с помощью следующей команды. Служба Apache по умолчанию на Ubuntu должна быть включена и работать автоматически.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Вывод:

Теперь проверьте службу MariaDB, используя команду ниже. Сервер MariaDB должен быть включен и работать на вашей системе Ubuntu.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Вывод:

Наконец, проверьте версии PHP и Composer, используя команду ниже. Вы увидите установленный PHP 8.3 и Composer 2.7.1 на вашей системе.

php -v  
sudo -u www-data composer -v

Дополнительно: Установка Node.js и NPM (менеджер пакетов Node.js)

Node.js и NPM необходимы, если вы используете Laravel с шаблонизатором, таким как Blade и JavaScript. В этом разделе вы установите как Node.js, так и NPM (менеджер пакетов Node.js) через репозиторий Ubuntu.

Чтобы установить Node.js и NPM на вашу систему Ubuntu, выполните следующее:

sudo apt install nodejs npm

Введите Y, чтобы подтвердить установку.

Когда установка завершится, введите команду ниже, чтобы проверить версии Node.js и NPM.

node --version  
npm --version

Следующий вывод показывает, что установлены Node.js 18 и NPM 9.5.

Настройка PHP

Чтобы запустить Laravel, вы должны убедиться, что некоторые расширения PHP включены, такие как fileinfo, mbstring и openssl. Теперь вы загружаете эти расширения PHP, изменив файл ‘php.ini’.

Используя редактор nano, отредактируйте файл конфигурации PHP по умолчанию ‘/etc/php/8.3/apache2/php.ini’.

sudo nano /etc/php/8.3/apache2/php.ini

Уберите комментарий с следующих строк, чтобы включить расширения PHP fileinfo, mbstring и openssl.

extension=fileinfo  
extension=mbstring  
extension=openssl

Сохраните файл и выйдите из редактора.

Теперь выполните команду ниже, чтобы перезапустить службу Apache и применить изменения в PHP.

sudo systemctl restart apache2

Затем проверьте расширения PHP fileinfo, mbstring и openssl с помощью следующей команды. Если эти расширения включены, будет показано имя каждого расширения.

sudo php -m | grep 'fileinfo\|mbstring\|openssl'

Кроме того, вы можете проверить список включенных расширений PHP через PHPINFO. Создайте новый файл PHPINFO с помощью следующей команды.

echo "" > /var/www/html/info.php

Затем перейдите по адресу http://192.168.5.30/info.php. Проверьте наличие расширений fileinfo, mbstring и openssl, чтобы убедиться, что эти расширения включены.

Настройка сервера MariaDB

После настройки PHP вам необходимо защитить сервер MariaDB и создать новую базу данных и пользователя для Laravel.

Выполните команду ‘mariadb-secure-installation’ ниже, чтобы защитить ваш сервер MariaDB. Теперь вам будет предложено выполнить настройки сервера MariaDB.

sudo mariadb-secure-installation

Когда вам будет предложено, введите Y, чтобы применить новую конфигурацию, или введите N, чтобы отклонить её.

• Стандартная установка MariaDB не имеет пароля. Нажмите ENTER, когда вас попросят ввести пароль.
• Теперь введите Y, чтобы установить пароль root для MariaDB. Затем введите новый пароль для MariaDB и повторите пароль.
• Введите Y, чтобы удалить анонимного пользователя из вашей установки MariaDB.
• Введите Y снова, когда вас попросят отключить удаленный вход для пользователя root MariaDB.
• Введите Y, чтобы удалить тестовую базу данных по умолчанию из вашей MariaDB.
• Наконец, введите Y, чтобы перезагрузить привилегии таблиц и применить новые изменения.

После защиты сервера MariaDB вам необходимо создать новую базу данных и пользователя для вашего проекта Laravel.

Войдите на сервер MariaDB, используя команду ниже. Введите свой пароль root для MariaDB, когда вас попросят.

sudo mariadb -u root -p

Теперь выполните следующие запросы, чтобы создать новую базу данных и пользователя ‘laravelapp‘ с паролем ‘password‘.

CREATE DATABASE laravelapp;  
CREATE USER laravelapp@localhost IDENTIFIED BY 'password';  
GRANT ALL PRIVILEGES ON laravelapp.* TO laravelapp@localhost;  
FLUSH PRIVILEGES;

Затем выполните следующий запрос, чтобы проверить привилегии для пользователя ‘laravelapp‘. Это обеспечит доступ вашего пользователя к базе данных Laravel ‘laravelapp‘.

SHOW GRANTS FOR laravelapp@localhost;

Наконец, введите quit, чтобы выйти из сервера MariaDB.

Установка Laravel через Composer

Теперь, когда вы настроили PHP и создали базу данных MySQL/MariaDB и пользователя, вы можете установить Laravel. В этом разделе вы создадите каталог проекта, установите Laravel через Composer и интегрируете Laravel с базой данных MySQL/MariaDB.

Сначала выполните команду ниже, чтобы создать каталоги /var/www/.cache (для кэша Composer), /var/www/.config (для дополнительной конфигурации Composer) и /var/www/laravelapp (для вашего проекта Laravel).

sudo mkdir -p /var/www/{.cache,.config,laravelapp}

Теперь измените владельца каталогов /var/www/.cache, /var/www/.config и /var/www/laravelapp на пользователя ‘www-data‘.

sudo chown -R www-data:www-data /var/www/{.cache,.config,laravelapp}

Затем перейдите в каталог /var/www/laravelapp и установите Laravel с помощью команды Composer ниже.

cd /var/www/laravelapp/  
sudo -u www-data composer create-project laravel/laravel .

Установка Laravel должна начаться следующим образом:

Теперь откройте файл ‘.env’ с помощью команды редактора nano ниже.

nano .env

Измените значение по умолчанию ‘APP_URL‘ на ваше локальное доменное имя. В этом примере Laravel будет работать на домене ‘laravelapp.local’.

APP_URL=http://laravelapp.local

Измените значение по умолчанию ‘DB_CONNECTION‘ на ‘mysql‘, уберите комментарий и измените данные базы данных на вашу информацию.

DB_CONNECTION=mysql  
DB_HOST=127.0.0.1  
DB_PORT=3306  
DB_DATABASE=laravelapp  
DB_USERNAME=laravelapp  
DB_PASSWORD=password

Сохраните и выйдите из файла.

Наконец, выполните команду ниже, чтобы выполнить миграцию базы данных для вашего проекта Laravel.

sudo -u www-data php artisan migrate

Вывод миграции базы данных Laravel:

Настройка виртуального хоста для Laravel

В этом разделе вы настроите файл виртуального хоста для Laravel. Убедитесь, что у вас есть локальное доменное имя, готовое для разработки Laravel.

Перед созданием виртуального хоста включите модуль Apache ‘rewrite‘ с помощью команды ниже.

sudo a2enmod rewrite

Создайте новую конфигурацию виртуального хоста ‘/etc/apache2/sites-available/laravelapp.conf‘ с помощью редактора nano.

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

Добавьте следующую конфигурацию и измените опцию ServerName на ваше доменное имя Laravel, например ‘laravelapp.local‘.

  
  
  ServerAdmin [email protected]  
  ServerName laravelapp.local  
  DocumentRoot /var/www/laravelapp/public  
  
    
    Options FollowSymLinks  
    AllowOverride None  
    
    
    AllowOverride All  
    
  
  ErrorLog ${APACHE_LOG_DIR}/error.log  
  CustomLog ${APACHE_LOG_DIR}/access.log combined  
  

Сохраните файл и выйдите из редактора.

Теперь выполните команду ниже, чтобы активировать виртуальный хост ‘laravelapp.conf‘ и проверить синтаксис Apache. Если ошибок нет, вы должны увидеть вывод ‘Syntax OK‘.

sudo a2ensite laravelapp.conf  
sudo apachectl configtest

Перезапустите службу Apache, чтобы применить новый файл виртуального хоста Laravel. После перезапуска Apache ваша установка Laravel готова.

sudo systemctl restart apache2

Доступ к проекту Laravel

На этом этапе вы готовы получить доступ к вашей установке Laravel через файл ‘hosts’.

Для пользователей Linux или MacOS измените файл ‘/etc/hosts‘ с правами root. Для пользователей Windows откройте файл ‘C:\Windows\System32\drivers\etc\hosts‘ с правами администратора.

Добавьте IP-адрес вашего сервера Ubuntu, за которым следует доменное имя Laravel, как показано ниже:

192.168.5.30 laravelapp.local

Сохраните и выйдите из файла.

Теперь посетите http://laravelapp.local/ с помощью вашего веб-браузера. Если ваша установка Laravel успешна, вы должны увидеть следующую страницу:

Заключение

Поздравляем! Вы завершили установку Laravel на Ubuntu 24.04. Вы запустили Laravel с помощью стека LAMP (Linux, Apache, MySQL/MariaDB и PHP) и узнали основные команды Composer для создания проекта.