Перейти к содержимому

Статья 57 из 141

Гайды

Как развернуть Laravel на VPS: PHP 8.3-FPM, Nginx, MariaDB, очереди и планировщик

Laravel на сервере состоит из нескольких частей: Nginx принимает запросы, PHP-FPM выполняет код, MariaDB хранит данные, воркер очереди обрабатывает фоновые задачи, а cron раз в минуту запускает планировщик. Ниже все части настроены по шагам.

Инструкция проверена на Ubuntu 24.04 с PHP 8.3.6, Composer 2.11, Laravel 13.43 и MariaDB 10.11 (ноябрь 2026).

Ресурс Минимум Комментарий
vCPU 1
RAM 1–2 ГБ PHP-FPM, MariaDB и воркер очереди
Диск 10 ГБ код, vendor/, логи, загрузки
Домен example.com A-запись на IP сервера (DNS)
Окно терминала
apt update
apt install -y nginx mariadb-server git unzip certbot python3-certbot-nginx \
php8.3-fpm php8.3-cli php8.3-mysql php8.3-mbstring php8.3-xml \
php8.3-curl php8.3-zip php8.3-bcmath php8.3-intl

PHP 8.3 есть в стандартных репозиториях Ubuntu 24.04. Расширения ctype, fileinfo, tokenizer, pdo и другие из списка требований Laravel входят в php8.3-cli и php8.3-common.

Composer поставьте официальным установщиком:

Окно терминала
cd /tmp
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php --install-dir=/usr/local/bin --filename=composer
rm composer-setup.php
composer --version

На странице getcomposer.org/download есть строка с проверкой хеша установщика. Её можно выполнить перед php composer-setup.php.

Окно терминала
mariadb
CREATE DATABASE myapp CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'myapp'@'localhost' IDENTIFIED BY 'ДЛИННЫЙ_ПАРОЛЬ';
GRANT ALL PRIVILEGES ON myapp.* TO 'myapp'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Подробнее о настройке и защите: MySQL и MariaDB на VPS.

Приложение будет работать от отдельного пользователя laravel. Nginx (www-data) добавим в его группу, чтобы он мог читать public/:

Окно терминала
adduser --system --group --home /var/www/myapp --shell /bin/bash laravel
usermod -aG laravel www-data
sudo -u laravel git clone https://github.com/ваш_аккаунт/ваш_проект.git /var/www/myapp

Системный пользователь создаётся с пустым домашним каталогом, поэтому git clone в него сработает.

Окно терминала
cd /var/www/myapp
sudo -u laravel composer install --no-dev --optimize-autoloader --no-interaction
sudo -u laravel cp .env.example .env
sudo -u laravel php artisan key:generate

--no-dev не ставит пакеты для разработки и тестов. key:generate записывает APP_KEY, которым Laravel шифрует сессии и cookie. Не меняйте ключ на работающем сайте: все пользователи разлогинятся.

Отредактируйте .env:

APP_NAME=MyApp
APP_ENV=production
APP_DEBUG=false
APP_URL=https://example.com
DB_CONNECTION=mariadb
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=myapp
DB_USERNAME=myapp
DB_PASSWORD=ДЛИННЫЙ_ПАРОЛЬ
SESSION_DRIVER=database
QUEUE_CONNECTION=database
CACHE_STORE=database

В свежем Laravel по умолчанию стоит SQLite, а строки DB_HOST и другие закомментированы. Раскомментируйте их. APP_DEBUG=false обязателен: с true при ошибке посетитель увидит пароли из конфигурации.

Окно терминала
chmod 640 .env
Окно терминала
sudo -u laravel php artisan migrate --force
sudo -u laravel php artisan storage:link
chown -R laravel:laravel /var/www/myapp
chmod -R ug+rwX storage bootstrap/cache
chmod 750 /var/www/myapp

--force нужен, потому что в режиме production Laravel спрашивает подтверждение перед миграциями. storage:link создаёт ссылку public/storage для загруженных файлов. Laravel пишет только в storage/ и bootstrap/cache/.

Окно терминала
sudo -u laravel php artisan optimize
INFO Caching framework bootstrap, configuration, and metadata.
config ........................................................ 10.06ms DONE
events ......................................................... 1.65ms DONE
routes ........................................................ 10.00ms DONE
views ......................................................... 19.55ms DONE

Команда объединяет config:cache, event:cache, route:cache и view:cache. После кеширования Laravel больше не читает .env: при каждом изменении .env снова выполняйте php artisan optimize. Сбросить кеш: php artisan optimize:clear.

Отдельный пул запускает PHP от пользователя laravel. Создайте /etc/php/8.3/fpm/pool.d/myapp.conf:

[myapp]
user = laravel
group = laravel
listen = /run/php/php8.3-fpm-myapp.sock
listen.owner = www-data
listen.group = www-data
listen.mode = 0660
pm = dynamic
pm.max_children = 10
pm.start_servers = 2
pm.min_spare_servers = 1
pm.max_spare_servers = 3
Окно терминала
php-fpm8.3 -t
systemctl reload php8.3-fpm

Подробнее о пулах и лимитах: PHP-FPM и Nginx.

Конфиг основан на примере из документации Laravel. Создайте /etc/nginx/sites-available/myapp:

server {
listen 80;
server_name example.com;
root /var/www/myapp/public;
add_header X-Frame-Options "SAMEORIGIN";
add_header X-Content-Type-Options "nosniff";
index index.php;
charset utf-8;
client_max_body_size 20M;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location = /favicon.ico { access_log off; log_not_found off; }
location = /robots.txt { access_log off; log_not_found off; }
error_page 404 /index.php;
location ~ ^/index\.php(/|$) {
fastcgi_pass unix:/run/php/php8.3-fpm-myapp.sock;
fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
include fastcgi_params;
fastcgi_hide_header X-Powered-By;
}
location ~ /\.(?!well-known).* {
deny all;
}
}

root указывает на public/, а не на корень проекта. Иначе .env и исходный код станут доступны из интернета.

Окно терминала
ln -s /etc/nginx/sites-available/myapp /etc/nginx/sites-enabled/
rm -f /etc/nginx/sites-enabled/default
nginx -t && systemctl reload nginx
certbot --nginx -d example.com

Проверка: curl -I https://example.com/up должен вернуть 200. Это встроенный маршрут проверки здоровья Laravel. На тестовом сервере главная и /up вернули 200, /.env вернул 403.

Задачи из dispatch() выполняет отдельный процесс queue:work. Создайте /etc/systemd/system/myapp-queue.service:

[Unit]
Description=Laravel queue worker (myapp)
After=network.target mariadb.service
[Service]
User=laravel
Group=laravel
WorkingDirectory=/var/www/myapp
ExecStart=/usr/bin/php artisan queue:work --sleep=3 --tries=3 --max-time=3600
Restart=always
RestartSec=5
[Install]
WantedBy=multi-user.target
Окно терминала
systemctl daemon-reload
systemctl enable --now myapp-queue
journalctl -u myapp-queue -f

Выполненная задача в журнале выглядит так:

php[17986]: 2026-11-18 15:16:27 Closure (console.php:11) ....................... RUNNING
php[17986]: 2026-11-18 15:16:27 Closure (console.php:11) .................. 11.31ms DONE

--max-time=3600 раз в час завершает воркер, и systemd запускает его снова. Это защищает от утечек памяти.

Задачи из routes/console.php (Schedule::...) запускает одна строка cron. Добавьте её в crontab пользователя laravel:

Окно терминала
crontab -u laravel -e
* * * * * cd /var/www/myapp && php artisan schedule:run >> /dev/null 2>&1

Список задач и время следующего запуска: sudo -u laravel php artisan schedule:list.

Окно терминала
cd /var/www/myapp
sudo -u laravel php artisan down
sudo -u laravel git pull
sudo -u laravel composer install --no-dev --optimize-autoloader --no-interaction
sudo -u laravel php artisan migrate --force
sudo -u laravel php artisan optimize
sudo -u laravel php artisan queue:restart
sudo -u laravel php artisan up
systemctl reload php8.3-fpm

queue:restart просит воркер завершиться после текущей задачи, а systemd запускает его с новым кодом.

Окно терминала
mariadb-dump --single-transaction myapp > /root/myapp-$(date +%F).sql
tar -czf /root/myapp-files-$(date +%F).tar.gz -C /var/www/myapp .env storage/app

Копии храните вне сервера: бэкапы.

Симптом Причина и решение
500 и в логе Permission denied для storage/logs/laravel.log файл создан от root: chown -R laravel:laravel storage bootstrap/cache
Изменения в .env не применяются включён кеш конфигурации: php artisan optimize
502 Bad Gateway PHP-FPM не запущен или неверный путь к сокету: ls /run/php/
No application encryption key has been specified не выполнен php artisan key:generate
SQLSTATE[HY000] [1045] Access denied неверные DB_USERNAME/DB_PASSWORD или пользователь создан не для localhost
Задачи из очереди не выполняются воркер не запущен: systemctl status myapp-queue
Задачи по расписанию не запускаются нет строки в crontab пользователя laravel: crontab -u laravel -l
Воркер выполняет старый код после деплоя не вызван php artisan queue:restart