Деплой PHP приложения на VPS: пошаговое руководство

Введение

Деплой (развертывание) PHP-приложения на виртуальном частном сервере (VPS) — это ключевой этап перехода от локальной разработки к продакшену. В отличие от общего хостинга, VPS дает полный контроль над средой выполнения, что критично для современных фреймворков (Laravel, Symfony) и высоконагруженных проектов.

В этом руководстве мы разберем полный цикл деплоя PHP-приложения на VPS с Ubuntu 22.04. Вы узнаете, как настроить сервер, установить необходимые компоненты и автоматизировать процесс развертывания. Все примеры кода готовы к использованию.

1. Подготовка VPS и начальная настройка

1.1. Подключение к серверу

После покупки VPS вы получите IP-адрес, логин (обычно root) и пароль. Подключитесь через SSH:

ssh root@ваш_ip_адрес

Если вы используете SSH-ключи (рекомендуется), добавьте свой публичный ключ на сервер.

1.2. Обновление системы и создание пользователя

Обновите пакеты и создайте непривилегированного пользователя для работы:

apt update && apt upgrade -y
adduser deployer
usermod -aG sudo deployer

Теперь подключайтесь под новым пользователем:

ssh deployer@ваш_ip_адрес

1.3. Настройка файрвола

Используйте UFW для базовой защиты:

sudo ufw allow OpenSSH
sudo ufw allow 'Nginx Full'
sudo ufw enable
sudo ufw status

2. Установка стека LEMP (Linux, Nginx, MySQL, PHP)

2.1. Установка Nginx

sudo apt install nginx -y
sudo systemctl start nginx
sudo systemctl enable nginx

Проверьте работу, открыв в браузере http://ваш_ip_адрес. Вы должны увидеть страницу приветствия Nginx.

2.2. Установка PHP и PHP-FPM

Для современных фреймворков используйте PHP 8.x:

sudo apt install php8.1-fpm php8.1-mysql php8.1-xml php8.1-mbstring php8.1-curl php8.1-zip php8.1-gd -y

Проверьте версию и запустите PHP-FPM:

php -v
sudo systemctl start php8.1-fpm
sudo systemctl enable php8.1-fpm

2.3. Установка MySQL

sudo apt install mysql-server -y
sudo mysql_secure_installation

Создайте базу данных для вашего приложения:

sudo mysql -u root -p
CREATE DATABASE your_database_name;
CREATE USER 'your_user'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON your_database_name.* TO 'your_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

3. Настройка виртуального хоста и деплой приложения

3.1. Создание виртуального хоста Nginx

Создайте конфигурационный файл для вашего домена:

sudo nano /etc/nginx/sites-available/yourdomain.com

Вставьте следующую конфигурацию (адаптируйте под свой проект):

server {
    listen 80;
    server_name yourdomain.com www.yourdomain.com;
    root /var/www/yourdomain.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:/var/run/php/php8.1-fpm.sock;
    }

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

Активируйте сайт:

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

3.2. Деплой кода через Git

Установите Git и клонируйте репозиторий:

sudo apt install git -y
cd /var/www
sudo git clone https://github.com/yourusername/your-repo.git yourdomain.com

Настройте права доступа:

sudo chown -R www-data:www-data /var/www/yourdomain.com
sudo chmod -R 755 /var/www/yourdomain.com/storage
sudo chmod -R 755 /var/www/yourdomain.com/bootstrap/cache

3.3. Установка зависимостей Composer

Установите Composer глобально:

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php
php -r "unlink('composer-setup.php');"
sudo mv composer.phar /usr/local/bin/composer

Установите зависимости проекта:

cd /var/www/yourdomain.com
composer install --no-dev --optimize-autoloader

3.4. Настройка окружения

Создайте файл .env и сгенерируйте ключ приложения (для Laravel):

cp .env.example .env
php artisan key:generate

Отредактируйте .env, указав параметры базы данных и другие настройки:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_database_name
DB_USERNAME=your_user
DB_PASSWORD=your_password

Выполните миграции:

php artisan migrate --force

4. Автоматизация деплоя с помощью bash-скрипта

Чтобы не повторять ручные действия при каждом обновлении, создайте скрипт автоматического деплоя:

nano /var/www/deploy.sh

Содержимое скрипта:

#!/bin/bash

PROJECT_DIR="/var/www/yourdomain.com"
BRANCH="main"

echo "Starting deployment..."

cd $PROJECT_DIR

# Сохраняем текущую версию
git stash

# Обновляем код
git pull origin $BRANCH

# Устанавливаем зависимости
composer install --no-dev --optimize-autoloader

# Очищаем кеш
php artisan optimize:clear
php artisan config:cache
php artisan route:cache
php artisan view:cache

# Выполняем