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

Деплой PHP сайта на VPS: от чистого сервера до рабочего сайта

Деплой PHP-сайта на VPS начинается с установки nginx, PHP 8.3 и MySQL 8, затем код клонируется из Git, зависимости ставятся через Composer, а nginx получает конфиг с корнем в /var/www/example.com/public. После миграций и сборки фронтенда сайт открывается по IP или домену. Проверка занимает минуту: curl -I http://203.0.113.10 и sudo nginx -t.

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

01Обновите пакеты и установите nginx

Подключитесь к серверу по SSH под пользователем с sudo. Обновите список пакетов и установите nginx из репозитория Ubuntu 24.04. Служба запускается автоматически, порт 80 открыт в ufw после добавления правила.

bash
sudo apt update && sudo apt upgrade -y
sudo apt install -y nginx
sudo ufw allow 'Nginx Full'

02Установите PHP 8.3 и расширения

В Ubuntu 24.04 PHP 8.3 есть в стандартном репозитории. Для Laravel нужны расширения mbstring, xml, curl, zip, mysql и bcmath. Пакет php8.3-fpm запускает отдельный пул, с которым работает nginx.

bash
sudo apt install -y php8.3-fpm php8.3-cli php8.3-mbstring php8.3-xml php8.3-curl php8.3-zip php8.3-mysql php8.3-bcmath
php -v
systemctl status php8.3-fpm --no-pager

03Установите MySQL 8 и создайте базу

MySQL 8 ставится одним пакетом, после установки выполните sudo mysql_secure_installation. Создайте базу и пользователя с паролем, который совпадает с данными в .env приложения. Права выдаются только на нужную базу.

bash
sudo apt install -y mysql-server
sudo mysql_secure_installation
sudo mysql -e "CREATE DATABASE example_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"
sudo mysql -e "CREATE USER 'example_user'@'localhost' IDENTIFIED BY 'StrongPass123!';"
sudo mysql -e "GRANT ALL PRIVILEGES ON example_db.* TO 'example_user'@'localhost'; FLUSH PRIVILEGES;"

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

Каталог сайта создайте в /var/www/example.com. Клонируйте репозиторий по SSH, ключ добавьте в GitHub заранее. Composer ставит только production-зависимости, npm собирает фронтенд. Для Laravel скопируйте .env.example в .env и сгенерируйте ключ.

bash
sudo mkdir -p /var/www/example.com
sudo chown -R $USER:$USER /var/www/example.com
git clone git@github.com:user/app.git /var/www/example.com
cd /var/www/example.com
cp .env.example .env
composer install --no-dev --optimize-autoloader
php artisan key:generate
npm ci
npm run build

05Настройте nginx для сайта

Создайте файл /etc/nginx/sites-available/example.com с корнем в подкаталоге public. Директива try_files отдаёт статику и передаёт остальное в index.php. Симлинк в sites-enabled включает сайт, после чего конфиг проверяется через sudo nginx -t.

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;
    }
}

06Выполните миграции и настройте права

Миграции создают таблицы в базе из .env. Каталоги storage и bootstrap/cache должны быть доступны пользователю www-data, иначе Laravel вернёт 500 при записи логов и кеша. Кеш конфига и маршрутов собирается командой php artisan optimize.

bash
cd /var/www/example.com
php artisan migrate --force
sudo chown -R www-data:www-data storage bootstrap/cache
sudo chmod -R 775 storage bootstrap/cache
php artisan optimize
php artisan queue:restart

07Проверьте работу сайта

Перезагрузите nginx и PHP-FPM, чтобы применить конфиг. Запрос curl -I должен вернуть код 200 или 302. Если сайт отвечает 500, смотрите /var/log/nginx/error.log и storage/logs/laravel.log.

bash
sudo nginx -t
sudo systemctl reload nginx
sudo systemctl restart php8.3-fpm
curl -I http://203.0.113.10
sudo tail -n 50 /var/log/nginx/error.log

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

  • Сайт отдаёт 403 Forbidden, потому что корень nginx указывает на /var/www/example.com, а не на public.

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

  • Laravel возвращает 500 после деплоя: в storage/logs/laravel.log ошибка доступа к файлу.

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

  • php artisan migrate падает с ошибкой подключения к MySQL, хотя база создана.

    Проверьте DB_HOST, DB_DATABASE, DB_USERNAME и DB_PASSWORD в .env, затем очистите кеш конфига командой php artisan config:clear.

  • nginx отдаёт 502 Bad Gateway: PHP-FPM не слушает сокет /run/php/php8.3-fpm.sock.

    Проверьте systemctl status php8.3-fpm и путь сокета в /etc/php/8.3/fpm/pool.d/www.conf, перезапустите службу.

Deploykin

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

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

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

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

Нужен ли отдельный пользователь для деплоя PHP-сайта?

Да, работать под root нежелательно. Создайте пользователя с sudo, клонируйте код от его имени, а права на storage и bootstrap/cache передайте www-data.

Как подключить домен к VPS после деплоя?

В DNS-провайдере создайте A-запись домена на IP сервера, например 203.0.113.10. После обновления DNS укажите домен в server_name конфига nginx и перезагрузите nginx.

Чем отличается деплой Laravel от обычного PHP-сайта?

Laravel требует Composer, .env, миграций и прав на storage. Обычному сайту достаточно скопировать файлы в корень и указать его в root nginx.

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

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

Ещё по теме

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

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