К содержимому

Как развернуть сайт на VPS: Laravel и PHP на Ubuntu 24.04

Сайт на VPS разворачивают за несколько шагов: обновить пакеты, поставить nginx, PHP 8.3 и MySQL 8, склонировать код, собрать зависимости и направить корень сайта в каталог public.

Руководство Деплой 3 мин чтения

01Обновите систему и создайте каталог сайта

Подключитесь к серверу по SSH под пользователем с правами sudo. Обновите список пакетов и установите базовые утилиты, которые понадобятся для git и сборки. Затем создайте каталог /var/www/example.com, куда будет склонирован проект.

bash
sudo apt update && sudo apt upgrade -y
sudo apt install -y git unzip curl
sudo mkdir -p /var/www/example.com

02Установите nginx, PHP 8.3 и MySQL 8

В Ubuntu 24.04 в стандартном репозитории лежит PHP 8.3, отдельный PPA не нужен. Поставьте nginx, MySQL и набор расширений, которые требуют Laravel и WordPress: mbstring, xml, curl, zip, mysql. После установки включите автозапуск сервисов.

bash
sudo apt install -y nginx mysql-server php8.3-fpm php8.3-cli php8.3-mysql php8.3-mbstring php8.3-xml php8.3-curl php8.3-zip
sudo systemctl enable --now nginx mysql php8.3-fpm

03Создайте базу данных и пользователя MySQL

Зайдите в консоль MySQL под root и создайте базу с кодировкой utf8mb4. Пользователю выдайте права только на эту базу и задайте пароль. Эти же значения потом попадут в .env проекта.

sql
sudo mysql
CREATE DATABASE example_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'example_user'@'localhost' IDENTIFIED BY 'StrongPassword123';
GRANT ALL PRIVILEGES ON example_db.* TO 'example_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

04Склонируйте проект и установите зависимости

Перейдите в каталог сайта и склонируйте репозиторий. Для продакшена ставьте зависимости без dev-пакетов и с оптимизированным автозагрузчиком. Фронтенд собирайте через npm ci и npm run build, если в проекте есть package.json.

bash
cd /var/www/example.com
git clone git@github.com:user/app.git .
composer install --no-dev --optimize-autoloader
npm ci
npm run build

05Настройте.env и выполните миграции

Скопируйте .env.example в .env и укажите данные подключения к MySQL, созданные на предыдущем шаге. Сгенерируйте ключ приложения и прогоните миграции с флагом --force, иначе на продакшене artisan спросит подтверждение. Затем закешируйте конфиг и маршруты командой php artisan optimize.

bash
cp .env.example .env
php artisan key:generate
php artisan migrate --force
php artisan optimize

06Выдайте права на storage и bootstrap/cache

PHP-FPM работает от пользователя www-data, и Laravel пишет логи и кеш в storage и bootstrap/cache. Без прав на запись сайт отдаст 500 с ошибкой failed to open stream. Смените владельца этих каталогов.

bash
sudo chown -R www-data:www-data storage bootstrap/cache
sudo chmod -R 775 storage bootstrap/cache

07Создайте конфиг nginx для сайта

Корень сайта указывает на подкаталог public, а не на корень проекта: иначе .env и исходники доступны по HTTP. PHP-запросы передаются в сокет php8.3-fpm.sock. Файл положите в /etc/nginx/sites-available/example.com и включите симлинком в sites-enabled.

nginx
server {
    listen 80;
    server_name example.com www.example.com;
    root /var/www/example.com/public;
    index index.php index.html;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.3-fpm.sock;
    }

    location ~ /\.ht {
        deny all;
    }
}

08Включите сайт и перезагрузите nginx

Симлинк в sites-enabled активирует конфиг, после чего проверьте синтаксис через nginx -t. Если проверка прошла, перезагрузите nginx без разрыва соединений. Ошибка в конфиге не даст перезагрузиться, и старый конфиг продолжит работать.

bash
sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

Частые ошибки

  • Корень сайта указывает на каталог проекта, а не на public. По адресу /example.com/.env открываются пароли к базе.

    Поставьте в конфиге nginx root /var/www/example.com/public; и перезагрузите nginx через sudo systemctl reload nginx.

  • После деплоя сайт отдаёт 500, в логах Laravel failed to open stream: Permission denied для storage/logs.

    Выполните sudo chown -R www-data:www-data storage bootstrap/cache и sudo chmod -R 775 storage bootstrap/cache.

  • php artisan migrate на продакшене останавливается с вопросом о подтверждении и деплой зависает.

    Запускайте миграции с флагом --force: php artisan migrate --force.

  • nginx отвечает 502 Bad Gateway, хотя PHP установлен.

    Проверьте sudo systemctl status php8.3-fpm и что в fastcgi_pass указан существующий сокет /run/php/php8.3-fpm.sock.

Deploykin

Как это делается в Deploykin

В Deploykin сайт обновляется после пуша в GitHub: панель запускает deploy-скрипт с миграциями и кэшами, на тарифе Про без простоя. Каждый релиз остаётся в истории, откат делается в один клик.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Нужен ли отдельный PPA для PHP 8.3 на Ubuntu 24.04?

Нет, PHP 8.3 входит в стандартный репозиторий Ubuntu 24.04. Достаточно sudo apt install php8.3-fpm php8.3-mysql и остальных расширений.

Как развернуть WordPress на этом же сервере?

Скачайте WordPress в /var/www/example.com, создайте базу в MySQL и укажите её в wp-config.php. Корень nginx оставьте на каталог с WordPress, а try_files замените на /index.php?$args.

Почему после git clone сайт пустой?

Скорее всего не выполнен composer install или не скопирован .env. Проверьте ls vendor и наличие .env, затем выполните php artisan key:generate.

Как обновить сайт после нового коммита?

Зайдите в каталог проекта, выполните git pull, затем composer install --no-dev --optimize-autoloader, php artisan migrate --force, php artisan optimize и php artisan queue:restart.

Ещё по теме

Деплой Laravel на сервер: команды, конфиг и ошибки: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.