git pull для деплоя Laravel на VPS: пошаговая настройка
git pull забирает коммиты из удалённого репозитория и сливает их в текущую ветку. На сервере эта команда запускает цепочку деплоя: обновление кода, зависимости Composer, права на каталоги, миграции и кэш.
01Подготовьте SSH-ключ для git pull
Приватный репозиторий клонируют по SSH-ключу пользователя, который деплоит. Публичный ключ добавьте в GitHub как deploy key с правом записи, если планируете пушить с сервера. Проверка соединения выполняется от того же пользователя, под которым будет работать git pull.
ssh-keygen -t ed25519 -C "deploy@example.com"
cat ~/.ssh/id_ed25519.pub
ssh -T git@github.com
02Клонируйте репозиторий в каталог сайта
Клонируйте проект в /var/www/example.com от пользователя, который деплоит. Не запускайте git clone через sudo: файлы репозитория достанутся root, и следующий git pull упадёт с error: cannot open .git/FETCH_HEAD: Permission denied. Каталог /var/www принадлежит root, поэтому создание подкаталога требует прав.
sudo mkdir -p /var/www/example.com
sudo chown $USER:www-data /var/www/example.com
git clone git@github.com:user/app.git /var/www/example.com
cd /var/www/example.com
03Установите зависимости Composer
composer install --no-dev --optimize-autoloader ставит пакеты строго по composer.lock без dev-зависимостей и собирает оптимизированный автозагрузчик. Запускайте команду от владельца проекта, без sudo. Если Composer пишет Your requirements could not be resolved to an installable set of packages, в тексте указано, какого расширения не хватает, например ext-intl ставится пакетом php8.3-intl.
composer install --no-dev --optimize-autoloader
04Соберите фронтенд
Если в проекте есть package.json, зависимости ставят через npm ci, а сборку через npm run build. npm ci ставит версии строго по package-lock.json и падает, если файл расходится с package.json. Сборка на сервере с малым объёмом памяти может закончиться Killed: процесс убил OOM-killer, проверьте sudo dmesg -T | grep -i "killed process" и добавьте swap.
npm ci
npm run build
05Выдайте права на storage и bootstrap/cache
Владелец файлов проекта: пользователь, который деплоит. www-data пишет только в storage и bootstrap/cache, доступ даёт группа. Остальные файлы www-data только читает, поэтому chown -R www-data:www-data на весь сайт не нужен: он позволяет PHP переписать собственный код.
sudo chown -R $USER:www-data storage bootstrap/cache
sudo chmod -R ug+rwX storage bootstrap/cache
06Проверьте.env и создайте APP_KEY
Файл .env на сервере создают из .env.example и заполняют APP_ENV=production, APP_DEBUG=false, параметры DB_* и APP_URL. APP_KEY создают один раз командой php artisan key:generate: новый ключ разлогинивает всех и ломает зашифрованные данные, при переезде ключ переносят вместе с .env. Без ключа Laravel отвечает No application encryption key has been specified.
cp .env.example .env
php artisan key:generate
07Примените миграции
php artisan migrate --force выполняет неприменённые миграции. Флаг --force обязателен при APP_ENV=production, иначе команда ждёт подтверждения и деплой зависает. При ошибке SQLSTATE[HY000] [1045] Access denied for user проверьте DB_USERNAME и DB_PASSWORD в .env, при SQLSTATE[HY000] [2002] Connection refused проверьте, что MySQL запущен и слушает адрес из DB_HOST.
php artisan migrate --force
08Соберите кэш конфига и маршрутов
php artisan optimize кэширует конфиг, маршруты, события и шаблоны. После кэша конфига env() вне файлов config/ возвращает null, а правка .env действует только после нового php artisan optimize или php artisan config:clear. Команда пишет в bootstrap/cache, поэтому запускайте её от владельца проекта: иначе получите file_put_contents(/var/www/example.com/bootstrap/cache/packages.php): Failed to open stream: Permission denied.
php artisan optimize
Частые ошибки
-
git pullпадает сerror: cannot open .git/FETCH_HEAD: Permission denied.Файлы репозитория принадлежат другому пользователю, обычно после
sudo git cloneилиchown -R www-dataна весь проект. Верните владельца:sudo chown -R $USER:www-data /var/www/example.com. -
composer installилиphp artisan optimizeпадает сFailed to open stream: Permission deniedвbootstrap/cache.Каталог принадлежит
www-dataпослеchown -R www-data:www-data. Верните группу:sudo chown -R $USER:www-data storage bootstrap/cacheи запускайте команды без sudo от владельца проекта. -
git pullпо SSH отвечаетgit@github.com: Permission denied (publickey).У пользователя, который делает
git pull, нет ключа, добавленного в GitHub. Проверьтеssh -T git@github.comот этого пользователя и добавьте публичный ключ как deploy key. -
Сайт отдаёт 419 Page Expired на формах.
Laravel не нашёл CSRF-токен в сессии: проверьте
@csrfв форме,SESSION_DOMAIN,SESSION_SECURE_COOKIEи наличие таблицыsessionsпри драйвереdatabase. После правки.envвыполнитеphp artisan optimize.
Deploykin
Как это делается в Deploykin
В Deploykin репозиторий GitHub подключается к сайту из панели, и после каждого пуша панель сама запускает деплой с миграциями и кэшами. git pull по SSH не нужен.
7 дней бесплатно на тарифе Про, без привязки карты.
Вопросы и ответы
Чем git pull отличается от git fetch?
git fetch только забирает коммиты из удалённого репозитория и обновляет ветки отслеживания. git pull делает git fetch, а затем сливает изменения в текущую ветку через merge или rebase.
Что делает git pull origin master?
Команда забирает ветку master из удалённого репозитория origin и сливает её в текущую ветку. Если текущая ветка не master, появится merge-коммит или конфликт.
Почему после git pull на сайте старый код?
С opcache.validate_timestamps=0 PHP не проверяет время изменения файлов. Выполните sudo systemctl reload php8.3-fpm, чтобы новый код попал в opcache.
Нужно ли запускать git pull через sudo?
Нет. sudo git pull оставит файлы репозитория у root, и следующий git pull от пользователя упадёт с Permission denied на .git/FETCH_HEAD.
Почему после правки.env ничего не меняется?
Конфиг закэширован командой php artisan optimize, и env() вне файлов config/ возвращает null. Выполните php artisan optimize заново или php artisan config:clear.
Ещё по теме
- Руководство · Деплой Как развернуть сайт на 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 на сервер: команды, конфиг и ошибки: все материалы темы