Как установить Laravel на Debian 12

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

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

Сочетание веб-фреймворка Laravel с другим фреймворком, таким как React или Vue, позволяет создавать красивый и интерактивный интерфейс. Кроме того, он поддерживает несколько баз данных, включая MySQL, PostgreSQL, SQLite и SQL Server. Laravel также предоставляет каркас для безопасной аутентификации.

В этом руководстве мы покажем вам, как установить Laravel шаг за шагом на Debian 12, чтобы вы могли начать работу с проектом Laravel. Мы покажем вам, как установить Laravel с веб-сервером Apache2, MariaDB и PHP 8.2.

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

Ниже приведены требования, которые вам необходимо выполнить, чтобы следовать этому руководству:

• Сервер Debian 12.
• Пользователь, не являющийся root, с правами администратора.

Установка LAMP-стека

Первый шаг, который вам нужно сделать, — установить LAMP-стек (Apache2, MariaDB и PHP) на ваш сервер Debian. Затем вы также проверите службы Apache2 и MariaDB, чтобы убедиться, что они работают.

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

sudo apt update

После обновления репозитория установите пакеты LAMP-стека (Apache2, PHP и MariaDB), выполнив команду apt install ниже. Следующая команда также устанавливает некоторые расширения PHP, необходимые для Laravel.

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

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

С установленным LAMP-стеком выполните команду systemctl ниже, чтобы проверить службы apache2 и mariadb. Если служба работает, вы должны получить вывод active (running).

sudo systemctl status apache2  
sudo systemctl status mariadb

Для службы apache2 вы должны получить вывод, похожий на этот:

А ниже приведен статус службы mariadb.

Далее выполните команду php ниже, чтобы проверить версию PHP и включенные модули в PHP. Вы должны увидеть установленную PHP 8.2 с некоторыми включенными модулями, такими как curl, date, dom и exif.

php -v  
php -m

Наконец, запустите веб-браузер и посетите IP-адрес вашего сервера Debian (т.е.: http://192.168.10.15/). Если установка прошла успешно, вы должны увидеть страницу index.html веб-сервера Apache.

Настройка PHP

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

Используйте следующий редактор nano, чтобы открыть файл конфигурации PHP /etc/php/8.2/apache2/php.ini.

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

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

extension=fileinfo  
extension=mbstring  
extension=openssl

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

Далее выполните следующую команду systemctl, чтобы перезапустить службу apache2 и применить изменения.

sudo systemctl restart apache2

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

sudo php -m

Теперь создайте новый файл phpinfo /var/www/html/info.php, используя команду ниже. Если ваша установка PHP и веб-сервера Apache2 прошла успешно, это покажет вам подробную информацию о вашей установке PHP.

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

Откройте свой предпочтительный веб-браузер и посетите IP-адрес сервера, за которым следует путь к файлу info.php (т.е.: http://192.168.10.15/info.php). Если все прошло успешно, вы должны увидеть вывод, похожий на этот:

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

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

Сначала выполните команду mariadb-secure-installation ниже, чтобы обеспечить безопасность вашей установки сервера MariaDB. В процессе вам будет предложено ввести некоторые настройки MariaDB, введите Y, чтобы подтвердить настройку, или n для Нет.

sudo mariadb-secure-installation

Ниже приведены некоторые настройки MariaDB, о которых вам будет предложено ответить в процессе:

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

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

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

sudo mariadb -u root -p

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

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

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

SHOW GRANTS FOR testapp@localhost;

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

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

Установка Composer

Laravel можно установить разными способами, и самый простой — установить его через Composer, менеджер пакетов PHP. Теперь вы установите Composer на свой сервер Debian.

Чтобы установить менеджер пакетов PHP Composer, выполните команду apt install ниже. Введите y, когда вас попросят, чтобы продолжить установку.

sudo apt install composer

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

which composer  
sudo -u www-data composer --version

Исполняемый файл composer находится по адресу /usr/bin/composer, и установлен composer 2.5.5.

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

С учетом всего этого вы готовы установить и создать первый проект Laravel. Вы создадите первый проект Laravel с MariaDB в качестве базы данных.

Сначала создайте новый корневой каталог документа /var/www/testapp для вашего проекта и измените владельца на пользователя www-data с помощью команды ниже. Вы также создадите каталоги /var/www/.cache и /var/www/.config, которые будут использоваться Composer.

sudo mkdir -p /var/www/{.cache,.config,testapp}  
sudo chown -R www-data:www-data /var/www/{.cache,.config,testapp}

Теперь перейдите в каталог /var/www/testapp/ и выполните команду composer ниже, чтобы создать первый проект Laravel. Ваш первый проект Laravel хранится в каталоге /var/www/testapp/.

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

Во время установки вы должны получить вывод, похожий на этот:

С созданным проектом Laravel далее вы настроите базу данных для вашего проекта через файл конфигурации .env. Файл .env используется в качестве базовой конфигурации для вашего проекта Laravel.

Используйте следующую команду редактора nano, чтобы открыть файл .env.

nano .env

Измените параметр APP_URL на локальное доменное имя вашего проекта Laravel. Таким образом, вы сможете получить доступ к вашему проекту через локальное доменное имя. В данном случае доменное имя — testapp.local.

APP_URL=http://testapp.local

Теперь измените конфигурацию базы данных DB_CONNECTION на mysql и измените данные DB_DATABASE, DB_USERNAME и DB_PASSWORD на ваши данные базы данных и пользователя MariaDB.

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

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

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

sudo -u www-data php artisan migrate

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

На следующем шаге вы создадите новую конфигурацию виртуального хоста Apache2 для вашего проекта Laravel. После этого вам необходимо активировать виртуальный хост и проверить конфигурации Apache2, а затем перезапустить веб-сервер Apache2, чтобы изменения вступили в силу.

Перед созданием конфигурации виртуального хоста Apache2 для Laravel вам необходимо включить модуль rewrite в Apache2 с помощью команды ниже.

sudo a2enmod rewrite

Используйте следующую команду редактора nano, чтобы создать конфигурацию виртуального хоста Apache2 /etc/apache2/sites-available/laravel.conf.

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

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

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

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

Далее выполните следующую команду, чтобы активировать конфигурацию виртуального хоста laravel.conf и проверить конфигурации Apache2. Если у вас правильные конфигурации, вы должны получить сообщение, такое как Syntax OK.

sudo a2ensite laravel.conf  
sudo apachectl configtest

Наконец, перезапустите службу apache2, выполнив команду ниже и применив изменения, которые вы сделали.

sudo systemctl restart apache2

Доступ к Laravel

Если вы находитесь на клиенте Linux, измените файл /etc/hosts с помощью команды редактора nano ниже.

sudo nano /etc/hosts

Если вы находитесь на машине Windows, измените файл C:\Windows\System32\drivers\etc\hosts.

Вставьте доменное имя вашего проекта Laravel и IP-адрес вашего сервера Debian следующим образом:

192.168.10.15   testapp.local

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

Наконец, запустите веб-браузер и посетите локальное доменное имя вашего проекта Laravel (т.е.: http://testapp.local). Если все прошло успешно, вы должны увидеть страницу Laravel, похожую на эту:

Заключение

В заключение, вы установили Laravel с LAMP-стеком (Apache2, MariaDB и PHP) на сервер Debian 12. Вы также установили Composer, менеджер пакетов PHP, и использовали его в качестве средства установки для Laravel. Учитывая это, вы теперь можете разрабатывать свое приложение, используя веб-фреймворк Laravel и MariaDB в качестве базы данных для ваших приложений.