git fetch и git pull: различия и деплой Laravel на VPS
git fetch скачивает новые коммиты из удалённого репозитория, но не меняет рабочую копию и текущую ветку. git pull делает то же самое и сразу сливает изменения в текущую ветку. На сервере это различие важно: git pull меняет код сайта, а git fetch позволяет сначала посмотреть, что придёт.
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.
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.
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".
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 не сможет перезаписать.
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.
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. Затем перезапустите обработчики очереди.
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/.
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.
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.
Ещё по теме
- Руководство · Деплой Как развернуть сайт на 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 и проверить результат.
- Руководство · Деплой Деплой PHP сайта на VPS: от чистого сервера до рабочего сайта Пошаговый деплой PHP-сайта и Laravel на VPS с Ubuntu 24.04: установка nginx, PHP 8.3, MySQL 8, настройка конфига, права и проверка.
Деплой Laravel на сервер: команды, конфиг и ошибки: все материалы темы