Как развернуть сайт на VPS: Laravel и PHP на Ubuntu 24.04
Сайт на VPS разворачивают за несколько шагов: обновить пакеты, поставить nginx, PHP 8.3 и MySQL 8, склонировать код, собрать зависимости и направить корень сайта в каталог public.
01Обновите систему и создайте каталог сайта
Подключитесь к серверу по SSH под пользователем с правами sudo. Обновите список пакетов и установите базовые утилиты, которые понадобятся для git и сборки. Затем создайте каталог /var/www/example.com, куда будет склонирован проект.
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. После установки включите автозапуск сервисов.
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 проекта.
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.
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.
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. Смените владельца этих каталогов.
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.
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 без разрыва соединений. Ошибка в конфиге не даст перезагрузиться, и старый конфиг продолжит работать.
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.
Ещё по теме
- Руководство · Деплой 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 и проверка работы сайта.
- Руководство · Деплой Деплой PHP сайта на VPS: от чистого сервера до рабочего сайта Пошаговый деплой PHP-сайта и Laravel на VPS с Ubuntu 24.04: установка nginx, PHP 8.3, MySQL 8, настройка конфига, права и проверка.
Деплой Laravel на сервер: команды, конфиг и ошибки: все материалы темы