📦
Хостинг

Composer на хостинге: установка, версия PHP и деплой

15.11.2026
← Все статьи

Composer — менеджер пакетов для PHP-проектов: он загружает библиотеки, которые использует проект, контролирует их версии и создаёт файл автозагрузки. Приложения на Laravel и Symfony и многие современные скрипты без Composer просто не запустятся. Многие разработчики используют его только на своём компьютере и загружают на хостинг готовую папку vendor. Но если есть доступ по SSH, работать с Composer прямо на хостинге гораздо удобнее и надёжнее. Разберём, как установить его на хостинг, запускать с правильной версией PHP и безопасно обновлять рабочий сайт.

Установка Composer в свою папку

На виртуальном хостинге нет прав на запись в системные каталоги, поэтому Composer устанавливается в домашнюю папку аккаунта. Права администратора для этого не нужны. Подключитесь к серверу по SSH, скачайте официальный установщик и запустите его. На официальном сайте также приводится команда проверки хеш-суммы установщика — её рекомендуется выполнить после загрузки, потому что хеш меняется с каждой новой версией установщика.

mkdir -p ~/bin
cd ~
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
# здесь выполните команду проверки хеша с официального сайта
php composer-setup.php --install-dir=$HOME/bin --filename=composer
php -r "unlink('composer-setup.php');"

~/bin/composer --version

Если последняя команда показывает версию Composer, установка прошла успешно. Теперь его можно вызывать по пути ~/bin/composer.

Запуск с правильной версией PHP

Самая частая ошибка на хостинге — запуск Composer не той версией PHP, на которой работает сайт. В панели ISPmanager версия PHP выбирается для каждого сайта отдельно, но обычная команда php в терминале использует стандартную версию сервера. Если сайт работает на PHP 8.3, а Composer запускается на другой версии, он может подобрать пакеты под другую версию, и сайт начнёт выдавать ошибки.

Поэтому Composer нужно вызывать через полный путь к той версии PHP, на которой работает сайт. На серверах с ISPmanager альтернативные версии обычно находятся по путям вроде /opt/php83/bin/php; точный путь можно проверить командой ls /opt или уточнить в техподдержке. Чтобы не писать длинный путь каждый раз, удобно создать короткий псевдоним:

# Проверка версии
/opt/php83/bin/php ~/bin/composer --version

# Короткий псевдоним
echo "alias composer='/opt/php83/bin/php ~/bin/composer'" >> ~/.bashrc
source ~/.bashrc

Для дополнительной защиты можно указать версию PHP сервера в composer.json. Тогда Composer будет подбирать пакеты под эту версию и на вашем компьютере, и на сервере:

{
    "config": {
        "platform": {
            "php": "8.3.0"
        }
    }
}

Пример: развёртывание приложения на Laravel

Логистическая компания в Ташкенте хочет запустить внутреннее приложение на Laravel для отслеживания заказов на поддомене app.example.uz. Разработчик загружает код на сервер через Git или архивом, но без папки vendor. На сервере он переходит в папку проекта и устанавливает пакеты через Composer. Для рабочего сайта пакеты разработки не нужны, поэтому используется параметр --no-dev, а --optimize-autoloader ускоряет автозагрузку.

cd ~/www/app.example.uz
composer install --no-dev --optimize-autoloader
composer check-platform-reqs

Последняя команда проверяет, соответствуют ли версия PHP и расширения на сервере требованиям пакетов. Если не хватает какого-либо расширения, например intl или gd, это будет видно здесь, и его нужно включить в панели для версии PHP сайта. В приложениях на Laravel есть ещё один важный шаг: корневая папка сайта должна указывать на папку public проекта. В ISPmanager это делается изменением корневого каталога в настройках сайта.

Разница между install и update

Одно из главных правил работы с Composer — различать команды composer install и composer update. install устанавливает точные версии, зафиксированные в файле composer.lock, поэтому на сервере оказывается именно тот набор, который прошёл тестирование. update ищет новые версии пакетов и перезаписывает lock-файл. Если запустить его прямо на рабочем сервере, могут установиться непроверенные версии, и сайт сломается.

Правильный порядок такой: пакеты обновляются через composer update на компьютере разработчика или на тестовой копии, результат проверяется, затем обновлённый composer.lock загружается на сервер, и там выполняется только composer install. Поэтому файл composer.lock обязательно нужно хранить в репозитории Git.

Ограничения памяти и времени

В больших проектах Composer может потреблять много памяти при расчёте зависимостей. На виртуальном хостинге ресурсы каждого аккаунта ограничены, поэтому иногда команда останавливается с ошибкой нехватки памяти. Команда install опирается на lock-файл и требует гораздо меньше памяти, чем update, — это ещё одна причина выполнять тяжёлые расчёты вне сервера. Собственный лимит памяти Composer можно снять так, но общий лимит тарифа всё равно действует:

COMPOSER_MEMORY_LIMIT=-1 composer install --no-dev --optimize-autoloader

Что делать без SSH

Если на тарифе нет доступа по SSH, можно запустить Composer на своём компьютере и загрузить готовую папку vendor по FTP или SFTP. В этом случае настройка platform в composer.json особенно важна, поскольку версия PHP на вашем компьютере может отличаться от серверной. Перед загрузкой лучше заархивировать папку vendor и распаковать архив на сервере через файловый менеджер: это намного быстрее, чем загружать тысячи мелких файлов по одному.

Замечания по безопасности

Если есть вопросы о доступе по SSH и нужных расширениях PHP на хостинге sayt.uz, обратитесь в техподдержку через кабинет.

Похожие статьи

🤖 Ошибка Telegram-бота «Conflict: terminated by other getUpdates»: причина и решение 🔁 Перенос сайта WordPress: замена URL и сериализованные данные 📊 Grafana и Prometheus: основы мониторинга сервера 📬 Перенос почтовых ящиков с imapsync: без потери писем
🌐 Язык
🇺🇿 O'zbek 🇺🇿 Ўзбек 🇷🇺 Русский ✓ 🇬🇧 English