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

git fetch и git pull: различия и деплой Laravel на VPS

git fetch скачивает новые коммиты из удалённого репозитория, но не меняет рабочую копию и текущую ветку. git pull делает то же самое и сразу сливает изменения в текущую ветку. На сервере это различие важно: git pull меняет код сайта, а git fetch позволяет сначала посмотреть, что придёт.

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

01Разберитесь, что делают git fetch и git pull

git fetch обновляет удалённые ветки в локальном репозитории: после него origin/main указывает на свежий коммит, а файлы в рабочем каталоге остаются прежними. git pull выполняет git fetch, а затем git merge (или git rebase при настроенном pull.rebase) в текущую ветку, поэтому файлы на диске меняются. На сервере git pull запускают от пользователя, который владеет файлами проекта, иначе появится error: cannot open .git/FETCH_HEAD: Permission denied.

bash
git fetch origin
git log --oneline HEAD..origin/main
git pull origin main

02Подготовьте сервер и клонируйте репозиторий

Установите nginx, PHP 8.3 с расширениями и MySQL 8.0. Приватный репозиторий клонируют по SSH-ключу пользователя, который деплоит: публичный ключ добавляют в GitHub как deploy key, проверка ssh -T git@github.com. Клонируйте проект в /var/www/example.com от этого же пользователя, без sudo.

bash
sudo apt update
sudo apt install -y nginx mysql-server php8.3-fpm php8.3-cli php8.3-mbstring php8.3-xml php8.3-curl php8.3-zip php8.3-bcmath php8.3-intl php8.3-mysql composer
git clone git@github.com:user/app.git /var/www/example.com
cd /var/www/example.com

03Установите зависимости и соберите фронтенд

composer install --no-dev --optimize-autoloader ставит пакеты из composer.lock без dev-зависимостей. Если Composer пишет Your requirements could not be resolved to an installable set of packages, в сообщении указано, чего не хватает: расширения вида ext-intl или версии PHP. Фронтенд собирают через npm ci и npm run build. При нехватке памяти процесс убивает OOM-killer, это видно по Killed и проверяется командой sudo dmesg -T | grep -i "killed process".

bash
composer install --no-dev --optimize-autoloader
npm ci
npm run build

04Настройте права на storage и bootstrap/cache

Владелец файлов проекта: пользователь, который деплоит. www-data пишет только в storage и bootstrap/cache через группу, остальные файлы читает. Каталоги получают 755, файлы 644, chmod 777 не нужен. Если сделать sudo chown -R www-data:www-data storage bootstrap/cache, composer install и php artisan optimize упадут у владельца проекта с Permission denied, а запущенные через sudo оставят файлы root, которые PHP-FPM не сможет перезаписать.

bash
sudo chown -R $USER:www-data storage bootstrap/cache
sudo chmod -R ug+rwX storage bootstrap/cache

05Заполните.env и создайте ключ приложения

Скопируйте .env.example в .env и укажите доступы к MySQL 8.0. APP_KEY создают один раз командой php artisan key:generate: новый ключ разлогинивает всех и ломает зашифрованные данные, при переезде ключ переносят вместе с .env. На рабочем сайте оставьте APP_DEBUG=false, иначе посетители увидят пароли из .env.

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

06Примените миграции и закэшируйте конфиг

--force у migrate нужен при APP_ENV=production, иначе команда ждёт подтверждения. php artisan optimize кэширует конфиг, маршруты, события и шаблоны. После кэша конфига env() вне файлов config/ возвращает null, а правка .env действует только после нового php artisan optimize или php artisan config:clear. Затем перезапустите обработчики очереди.

bash
php artisan migrate --force
php artisan optimize
php artisan queue:restart

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

Для Laravel root в nginx смотрит в /var/www/example.com/public: .env и код вне public наружу не отдаются. PHP подключается строками include snippets/fastcgi-php.conf; и fastcgi_pass unix:/run/php/php8.3-fpm.sock;. Заголовки запроса, в том числе Cookie и X-CSRF-TOKEN, nginx передаёт в PHP-FPM сам, строки вида fastcgi_param HTTP_COOKIE $http_cookie; не нужны. Сайт лежит в /etc/nginx/sites-available/ и включается симлинком в /etc/nginx/sites-enabled/.

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

    index index.php;

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

08Проверьте конфиг и перезагрузите службы

sudo nginx -t проверяет все файлы конфига. sudo systemctl reload nginx применяет конфиг без обрыва соединений, а с ошибкой в конфиге nginx продолжает работать со старым. sudo php-fpm8.3 -t проверяет конфиг FPM и пулов, sudo systemctl reload php8.3-fpm применяет его без остановки службы. С opcache.validate_timestamps=0 новый код подхватывается только после перезагрузки PHP-FPM.

bash
sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/example.com
sudo nginx -t
sudo systemctl reload nginx
sudo php-fpm8.3 -t
sudo systemctl reload php8.3-fpm

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

  • После sudo chown -R www-data:www-data storage bootstrap/cache команда composer install падает с file_put_contents(/var/www/example.com/bootstrap/cache/packages.php): Failed to open stream: Permission denied.

    Верните группу владельцу проекта: sudo chown -R $USER:www-data bootstrap/cache и sudo chmod -R ug+rwX bootstrap/cache. Запускайте composer install и php artisan optimize без sudo.

  • git pull на сервере завершается с error: cannot open .git/FETCH_HEAD: Permission denied.

    Файлы репозитория принадлежат другому пользователю, например после sudo git clone или chown -R www-data на весь проект. Верните владельца без смены группы: sudo chown -R $USER /var/www/example.com, затем повторите git pull от этого пользователя.

  • Форма входа отдаёт 419 Page Expired, хотя nginx передаёт Cookie.

    Проверьте @csrf в форме или заголовок X-CSRF-TOKEN в AJAX. Убедитесь, что SESSION_DOMAIN совпадает с доменом, SESSION_SECURE_COOKIE=true не стоит на сайте без HTTPS, а у драйвера database есть таблица sessions из миграций. После правки .env выполните php artisan optimize.

  • После правки .env сайт работает со старыми значениями, а env() вне config/ возвращает null.

    Конфиг закэширован командой php artisan optimize. Выполните php artisan config:clear или новый php artisan optimize и перезагрузите PHP-FPM при отключённой проверке меток времени opcache.

Deploykin

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

В Deploykin репозиторий GitHub подключается к сайту из панели, и после каждого пуша панель сама запускает деплой с миграциями и кэшами. git pull по SSH не нужен.

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

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

Чем git fetch отличается от git pull?

git fetch скачивает коммиты и обновляет удалённые ветки, но не трогает рабочую копию и текущую ветку. git pull делает git fetch и сразу сливает изменения в текущую ветку.

Можно ли делать git pull на рабочем сервере?

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

Почему после git pull изменения не видны на сайте?

Проверьте, что root в nginx смотрит в /var/www/example.com/public, и что git pull выполнен в этом каталоге. При opcache.validate_timestamps=0 нужен sudo systemctl reload php8.3-fpm.

Как откатить неудачный git pull?

Посмотрите историю через git log --oneline и вернитесь на нужный коммит командой git reset --hard <хеш>. Затем повторите composer install --no-dev --optimize-autoloader и php artisan optimize.

Ещё по теме

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

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