polnoe-rukovodstvo-po-ustanovke-laravel-na-ubuntu-2404

Laravel — это мощный PHP-фреймворк для разработки веб-приложений, построенный поверх Symfony и использующий архитектуру MVC. Благодаря элегантному синтаксису и продуманной структуре, Laravel предоставляет комфортную и эффективную среду для разработки. В этом руководстве вы узнаете, как развернуть Laravel-приложение на Ubuntu 24.04.

Шаг 1: Установка LAMP-стека

Для начала необходимо установить базовые компоненты: веб-сервер Apache, СУБД MariaDB и PHP с нужными расширениями.

sudo apt update
sudo apt install apache2 mariadb-server git php php-cli php-mcrypt php-mbstring php-xml php-mysql php-bcmath php-json php-zip php-curl

Шаг 2: Установка Composer

Composer — менеджер зависимостей для PHP. Лучше установить его вручную:

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php
php -r "unlink('composer-setup.php');"

sudo mv composer.phar /usr/local/bin/composer
sudo chmod +x /usr/local/bin/composer

Шаг 3: Создание базы данных

Подключитесь к MySQL через терминал или phpMyAdmin и выполните следующие SQL-запросы:

CREATE DATABASE laravel;
CREATE USER 'laravel'@'localhost' IDENTIFIED BY 'СЛОЖНЫЙ_ПАРОЛЬ';
GRANT ALL ON laravel.* TO 'laravel'@'localhost';
FLUSH PRIVILEGES;

Шаг 4: Установка Laravel

Перейдите в директорию, где хотите создать проект, и выполните:

cd /var/www
composer create-project laravel/laravel laravel-app

Laravel будет установлен в директорию laravel-app. Замените имя по желанию.

Шаг 5: Настройка Laravel

Перейдите в корень проекта и откройте .env файл. Укажите параметры подключения к базе данных:

DB_DATABASE=laravel
DB_USERNAME=laravel
DB_PASSWORD=СЛОЖНЫЙ_ПАРОЛЬ

Сохраните изменения. Laravel готов к запуску.

Шаг 6: Запуск Laravel в dev-среде

Для локальной разработки выполните:

php artisan serve

Приложение будет доступно по адресу http://localhost:8000. Чтобы слушать на всех интерфейсах (например, для удалённого доступа):

php artisan serve --host=0.0.0.0

Возможные ошибки:

Если вы указали SESSION_DRIVER=database в .env, что говорит Laravel хранить сессии в таблице sessions. Однако Laravel не создаёт эту таблицу автоматически — её нужно создать вручную.

php artisan session:table
php artisan migrate

Это создаст таблицу sessions в вашей базе данных laravel.

Запускаем:

Шаг 7: Настройка Apache для Laravel

На сервере или в продакшене рекомендуется использовать полноценную настройку веб-сервера Apache.

Создайте конфигурационный файл:

sudo nano /etc/apache2/sites-available/example.com.conf

Пропишите настройки:

<VirtualHost *:80>
    ServerName example.com
    ServerAlias www.example.com
    DocumentRoot /var/www/laravel-app/public

    <Directory /var/www/laravel-app>
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/example.com_error.log
    CustomLog ${APACHE_LOG_DIR}/example.com_access.log combined
</VirtualHost>

Активируйте сайт и перезапустите Apache:

sudo a2ensite example.com.conf
sudo a2enmod rewrite
sudo systemctl reload apache2

Установите корректные права:

sudo chown -R www-data:www-data /var/www/laravel-app
sudo chmod -R 755 /var/www/laravel-app

Теперь Laravel-доступен по адресу http://example.com (убедитесь, что DNS домена указывает на IP сервера).

Заключение

Вы успешно установили Laravel на Ubuntu 24.04. Руководство охватывает установку зависимостей, настройку БД, развертывание и запуск Laravel как в dev-среде, так и через Apache. Рекомендуется регулярно проверять официальную документацию Laravel для изучения расширенных возможностей фреймворка.

Полное руководство по установке Laravel на Ubuntu 24.04