Как установить фреймворк Laravel PHP на Alma Linux 9

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

Этот учебник покажет вам, как установить Laravel на сервер Alma Linux 9. Мы проведем вас через установку Laravel с использованием LAMP Stack (Linux, Apache/Httpd, MariaDB и PHP) и Composer.

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

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

Сервер Alma Linux 9.
Непривилегированный пользователь с правами администратора.
Локальное доменное имя.
SELinux в разрешающем режиме.

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

Laravel является одним из самых популярных фреймворков PHP для создания веб-приложений. Чтобы установить Laravel, вам нужно установить зависимости, включая LAMP Stack (Apache/Httpd, MariaDB и PHP) и Composer. В настоящее время Laravel требует PHP 8.3. Вы должны установить PHP 8.3 через сторонний репозиторий.

Сначала добавьте сторонние репозитории EPEL и Remi на ваш сервер Alma Linux с помощью команды ниже. Репозиторий EPEL будет использоваться для установки пакетов, таких как Composer, в то время как репозиторий Remi предоставляет несколько версий PHP для Laravel.

sudo dnf install epel-release dnf-utils http://rpms.remirepo.net/enterprise/remi-release-9.rpm

add repo

Теперь включите репозиторий PHP 8.3 через Remi с помощью команды ниже.

sudo dnf reset php -y  
sudo dnf module enable php:remi-8.3 -y

Далее установите пакеты LAMP Stack (Apache/Httpd, MariaDB и PHP) и Composer с помощью следующей команды. Введите y для подтверждения установки.

sudo dnf install httpd mariadb-server composer php php-curl php-bcmath php-json php-mbstring php-xml php-tokenizer php-zip

install deps

После завершения установки запустите и включите службу httpd с помощью команды ниже.

sudo systemctl start httpd  
sudo systemctl enable httpd

Затем запустите и включите сервер MariaDB с помощью следующей команды.

sudo systemctl start mariadb  
sudo systemctl enable mariadb

Теперь проверьте версии PHP и Composer с помощью команды ниже. Вы должны увидеть, что установлены PHP 8.3 и Composer 2.7.1.

php -v  
sudo -u apache composer -v

check php and composer

Наконец, выполните команду ниже, чтобы проверить ваши модули PHP. Убедитесь, что fileinfo, mbstring и openssl включены.

php -m

Настройка MariaDB

С настроенным PHP вы обеспечите безопасность сервера MariaDB и создадите новую базу данных и пользователя для Laravel. Сервер MariaDB предоставляет утилиту mariadb-secure-installation для обеспечения безопасности сервера MariaDB и клиент MariaDB для подключения к серверу MariaDB через командную строку.

Чтобы обеспечить безопасность сервера MariaDB, выполните команду ниже, и вам будут заданы некоторые настройки сервера MariaDB. Введите Y или N, чтобы согласиться или не согласиться с применением новых изменений MariaDB.

sudo mariadb-secure-installation

Ниже приведены некоторые настройки сервера MariaDB, о которых вас спросят:

Переключиться на аутентификацию unix_socket?. Введите n и нажмите ENTER. Пользователь root MariaDB уже защищен. Опционально, вы также можете включить его, введя y для да.
Изменить пароль root?. Введите y, чтобы подтвердить и установить новый пароль root для MariaDB.
Удалить анонимного пользователя?. Введите y, чтобы подтвердить.
Запретить удаленный вход root? Введите y, чтобы подтвердить. Только локальное соединение будет разрешено, если вы используете пользователя root MariaDB.
Удалить тестовую базу данных и доступ к ней?. Введите y, чтобы подтвердить и удалить базу данных по умолчанию ‘test’.
Наконец, введите y снова, чтобы перезагрузить все привилегии таблиц на вашем сервере MariaDB и применить новые изменения.

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

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

sudo mariadb -u root -p

Теперь выполните следующие запросы, чтобы создать новую базу данных и пользователя для Laravel. В этом примере вы создадите новую базу данных laravelapp, пользователя laravel с паролем p4ssw0rd. Настройте детали базы данных и пользователя ниже с вашей информацией.

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

create database

Далее выполните запрос ниже, чтобы проверить привилегии для пользователя laravel. Убедитесь, что пользователь laravel может получить доступ к базе данных laravelapp.

SHOW PRIVILEGES FOR laravel@localhost;

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

show privileges

Создание проекта Laravel

Теперь, когда вы настроили как PHP, так и MariaDB, давайте загрузим и установим Laravel на вашу систему. Вы создадите и настроите каталог проекта, затем загрузите и установите проект Laravel через Composer.

Создайте новые каталоги для проекта Laravel /var/www/laravelapp и дополнительные каталоги .cache и .config для хранения кэша и конфигурации Composer. Затем измените владельца этих каталогов на пользователя apache.

mkdir -p /var/www/laravelapp /usr/share/httpd/.composer/{.cache,.config}  
sudo chown -R apache:apache /var/www/laravelapp /usr/share/httpd/.composer

Перейдите в каталог /var/www/laravelapp и выполните команду composer ниже, чтобы загрузить и установить Laravel.

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

Процесс загрузки должен выглядеть следующим образом:

install Laravel

После загрузки Laravel откройте файл .env с помощью следующей команды редактора nano.

nano .env

Измените APP_URL на ваше локальное доменное имя, затем измените данные базы данных на информацию вашей базы данных MariaDB.

APP_URL=http://dev.hwdomain.local  
DB_CONNECTION=mysql  
DB_HOST=127.0.0.1  
DB_PORT=3306  
DB_DATABASE=laravelapp  
DB_USERNAME=laravel  
DB_PASSWORD=password

Когда закончите, сохраните файл и выйдите.

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

sudo -u apache php artisan migrate  
sudo -u apache php artisan db:seed

migrate database

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

После установки Laravel вы создадите новую конфигурацию виртуального хоста Httpd, которую будет использовать Laravel. Для этого убедитесь, что у вас есть локальное доменное имя или любое/случайное доменное имя, которое вы хотите. Вы можете настроить этот домен позже.

Создайте новую конфигурацию виртуального хоста httpd /etc/httpd/conf.d/laravel.conf с помощью следующей команды редактора nano.

sudo nano /etc/httpd/conf.d/laravel.conf

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

  
  
 ServerAdmin [email protected]  
 ServerName dev.hwdomain.local  
 DocumentRoot /var/www/laravelapp/public  
  
   
 Options FollowSymLinks  
 AllowOverride None  
   
   
 AllowOverride All  
   
  
 ErrorLog /var/log/httpd/laravel-error.log  
 CustomLog /var/log/httpd/laravel-access.log combined

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

Теперь выполните команду ниже, чтобы проверить вашу конфигурацию httpd. Если у вас правильный синтаксис httpd, вы должны получить вывод Syntax OK.

sudo apachectl configtest

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

sudo systemctl restart httpd

setup vhost

Настройка Firewalld

Перед тем как получить доступ к вашей установке Laravel, вы должны открыть порты HTTP и HTTPS на вашей системе, что можно сделать через Firewalld.

Откройте трафик HTTP и HTTPS на вашем сервере Alma Linux с помощью команды ниже.

sudo firewall-cmd --add-service=http --permanent  
sudo firewall-cmd --add-service=https --permanent

Теперь перезагрузите firewalld, чтобы применить изменения.

sudo firewall-cmd --reload

Наконец, проверьте список правил firewalld с помощью следующей команды. Вы увидите, что оба сервиса HTTP и HTTPS добавлены в firewalld.

sudo firewall-cmd --list-all

setup firewalld

Доступ к Laravel с локального компьютера

Чтобы настроить локальное доменное имя для вашей установки Laravel, используйте следующее:

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

Вставьте конфигурацию ниже и убедитесь, что вы изменили IP-адрес и доменное имя на вашу информацию.

192.168.5.60 dev.hwdomain.local

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

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

laravel

Заключение

Поздравляем! Вы завершили установку Laravel на Alma Linux 9 с использованием LAMP Stack (Linux, Apache/Httpd, MariaDB и PHP) и Composer. Вы также настроили firewalld для открытия портов HTTP и HTTPS, а затем также настроили локальное доменное имя для вашей разработки Laravel через файл /etc/hosts или файл C:\Windows\System32\drivers\etc\hosts.