Как установить PHP-фреймворк Laravel с Apache 2 на Ubuntu 22.04

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

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

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

В этом руководстве вы узнаете, как установить Laravel на последней версии Ubuntu 22.04 LTS. Это также будет включать в себя настройку стека LAMP для разработки Laravel.

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

• Машина с Ubuntu 22.04. В этом примере используется сервер Ubuntu.
• Непривилегированный пользователь с правами администратора sudo или вы также можете использовать пользователя root.

Установка веб-сервера Apache

На этом первом этапе вы будете устанавливать веб-сервер Apache2 на вашу систему Ubuntu. В этом примере вы будете запускать веб-фреймворк Laravel с веб-сервером Apache.

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

sudo apt update

Далее установите пакет веб-сервера Apache2, используя следующую команду.

sudo apt install apache2

Введите Y, чтобы подтвердить, и нажмите ENTER, чтобы начать установку. Установка веб-сервера Apache начнется.

После завершения установки Apache2 вам нужно будет добавить службы HTTP и HTTPS в брандмауэр UFW.

Выполните команду ufw ниже, чтобы добавить службы HTTP и HTTPS в брандмауэр UFW.

sudo ufw allow "Apache Full"

Наконец, откройте ваш веб-браузер и введите IP-адрес сервера в адресной строке (например, http://192.168.10.15). Теперь вы должны увидеть страницу по умолчанию index.html веб-сервера Apache2.

Установка PHP 8.1

После установки веб-сервера Apache вы установите и настроите PHP на машине с Ubuntu 22.04. Стандартный репозиторий Ubuntu 22.04 предоставляет пакет PHP версии 8.1, который хорошо поддерживается для веб-фреймворка Laravel.

Выполните команду apt ниже, чтобы установить пакеты PHP для веб-фреймворка Laravel.

sudo apt install php php-curl php-bcmath php-json php-mbstring php-xml php-tokenizer php-zip

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

Теперь после завершения установки PHP отредактируйте конфигурацию php.ini с помощью редактора nano.

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

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

extension=fileinfo  
extension=mbstring  
extension=openssl

Сохраните и закройте файл, когда закончите.

Далее перезапустите службу Apache2, чтобы применить новые изменения к вашей конфигурации PHP.

sudo systemctl restart apache2

Наконец, протестируйте и проверьте вашу конфигурацию PHP, выполнив следующую команду.

Проверьте версию PHP, установленную на вашей машине с Ubuntu.

php --version

На скриншоте ниже вы можете увидеть, что PHP 8.1.2 установлен на машине с Ubuntu.

Проверьте все включенные расширения в вашей среде PHP.

php -m

Установка сервера MariaDB

Теперь вы установили веб-сервер Apache2 и пакеты PHP. Теперь вы будете устанавливать и настраивать сервер базы данных MariaDB на машине с Ubuntu 22.04. Вы также создадите новую базу данных MariaDB и пользователя для проекта Laravel.

Чтобы установить базу данных MariaDB на машину с Ubuntu, вы можете выполнить команду apt ниже.

sudo apt install mariadb-server

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

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

sudo mysql -u root -p

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

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

Теперь выполните запрос “EXIT“, чтобы выйти из оболочки MariaDB. Вы теперь установили сервер базы данных MariaDB и создали новую базу данных и пользователя для проекта Laravel.

Установка Composer

В этом разделе вы будете устанавливать Composer. Это менеджер пакетов для языка программирования PHP, он похож на pip для Python, gem для Ruby, npm или yarn для Node.js.

Веб-фреймворк Laravel можно установить несколькими способами. В этом примере вы будете устанавливать веб-фреймворк Laravel с помощью Composer.

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

curl -sS https://getcomposer.org/installer -o composer-setup.php

Теперь выполните скрипт установщика “composer-setup.php”, чтобы установить Composer. Это установит Composer в директорию /usr/local/bin.

php composer-setup.php --install-dir=/usr/local/bin --filename=composer

Ниже приведен скриншот во время установки Composer.

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

Проверьте версию Composer.

sudo -u www-data composer --version

Показать содержимое справки Composer.

sudo -u www-data composer --help

Теперь вы готовы начать установку Laravel.

Начало установки Laravel

Перед началом установки Laravel давайте создадим новые директории для проекта Laravel.

В этом примере вы создадите три директории: “.cache” для хранения кэша пакетов PHP, директорию “.config” для хранения дополнительной конфигурации Composer и директорию “laravelapp” для самого проекта Laravel. Все эти директории будут доступны в директории “/var/www“.

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

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

Теперь измените владельца директорий Laravel и Composer на пользователя и группу www-data.

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

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

cd /var/www/laravelapp/

Затем установите веб-фреймворк Laravel, используя команду composer ниже. Точка в конце команды установит Laravel в текущую рабочую директорию /var/www/laravelapp.

sudo -u www-data composer create-project laravel/laravel .

Ниже приведен скриншот процесса установки Laravel.

А ниже приведен результат после завершения установки Laravel.

Далее, после завершения установки отредактируйте файл “.env” с помощью редактора nano. Эта конфигурация является основной конфигурацией окружения для Laravel, которая включает URL установки, данные базы данных и т. д.

nano .env

Измените конфигурацию APP_URL на ваш домен для установки Laravel. В этом примере Laravel будет работать на доменном имени laravelapp.howtoforge.local.

APP_URL=http://laravelapp.howtoforge.local

Теперь измените данные базы данных на вашу конфигурацию базы данных.

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

Сохраните и закройте файл, когда закончите.

Теперь вы завершили установку веб-фреймворка Laravel с сервером базы данных MariaDB.

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

Теперь пришло время настроить виртуальный хост Apache2 для веб-фреймворка Laravel. В этом примере проект Laravel будет работать на локальном домене laravelapp.howtoforge.local.

Создайте новый файл “/etc/apache2/sites-available/laravel.conf“ с помощью редактора nano.

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

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

  
  
    ServerAdmin [email protected]  
    ServerName laravelapp.howtoforge.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  
  

Сохраните и закройте файл, когда закончите.

Далее активируйте модуль переопределения Apache2 и активируйте конфигурацию виртуального хоста laravel.conf с помощью следующей команды.

sudo a2enmod rewrite  
sudo a2ensite laravel.conf

Теперь проверьте конфигурацию Apache2 и убедитесь, что нет ошибок.

sudo apachectl configtest

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

sudo systemctl restart apache2

Теперь вы завершили конфигурацию виртуального хоста Apache для Laravel.

На вашей машине отредактируйте файл /etc/hosts с помощью редактора nano/vim.

sudo nano /etc/hosts

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

192.168.10.15 laravelapp.howtoforge.local

Сохраните и закройте файл, когда закончите.

Наконец, вернитесь в ваш веб-браузер и введите URL установки laravel (т.е. http://laravelapp.howtoforge.local) в адресной строке. И вы должны увидеть страницу по умолчанию веб-фреймворка Laravel. Также внизу вы можете увидеть версию Laravel, которую вы только что установили, и версию PHP, которую вы в настоящее время используете.

Заключение

Поздравляем! Вы теперь успешно установили веб-фреймворк Laravel на Ubuntu 22.04. Вы также узнали основную конфигурацию стека LAMP для веб-фреймворка Laravel.