Деплой 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.
01Обновите пакеты и установите nginx
Подключитесь к серверу по SSH под пользователем с sudo. Обновите список пакетов и установите nginx из репозитория Ubuntu 24.04. Служба запускается автоматически, порт 80 открыт в ufw после добавления правила.
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.
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 приложения. Права выдаются только на нужную базу.
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 и сгенерируйте ключ.
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.
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.
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.
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.
Ещё по теме
- Руководство · Деплой Как развернуть сайт на VPS: Laravel и PHP на Ubuntu 24.04 Пошаговый деплой сайта на VPS: nginx, PHP 8.3, MySQL 8, git clone, composer install, миграции, права на storage и проверка через curl.
- Руководство · Деплой git pull rebase при деплое Laravel на VPS Как включить git pull rebase для деплоя Laravel на VPS: настройка git config, порядок команд, права на storage, проверка через git log и artisan.
- Руководство · Деплой CI CD на Jenkins: деплой Laravel и PHP-сайтов на VPS Пошаговая настройка CI CD на Jenkins для деплоя Laravel и PHP-сайтов на Ubuntu 24.04: команды сборки, права, миграции и проверка результата.
- Руководство · Деплой git pull submodules при деплое Laravel на VPS Как настроить git pull submodules при деплое Laravel на Ubuntu 24.04: клонирование с подмодулями, обновление, права, composer install и проверка результата.
- Руководство · Деплой Как отменить git pull на сервере: пошаговый разбор Как отменить git pull на Ubuntu 24.04: сохранить правки, вернуть коммиты через git reset и git revert, восстановить деплой Laravel и проверить результат.
- Руководство · Деплой git fetch и git pull: различия и деплой Laravel на VPS Чем git fetch отличается от git pull, как настроить деплой Laravel на Ubuntu 24.04: команды, права на storage, nginx и проверка работы сайта.
Деплой Laravel на сервер: команды, конфиг и ошибки: все материалы темы