Как установить Composer на Ubuntu
Composer — менеджер пакетов для PHP: он скачивает библиотеки, которые нужны сайту или фреймворку, и следит за их версиями. В Ubuntu он ставится командой sudo apt install composer вместе с PHP для командной строки. Запускайте composer из папки проекта под своим пользователем, без sudo.
Содержание 8
Что сделать прямо сейчас
Команды на этой странице вводятся на сервере: подключитесь к нему по SSH (как подключиться) и набирайте их в том же окне.
- Обновите список пакетов:
sudo apt update. - Установите Composer:
sudo apt install composer. Если система спросит пароль, введите пароль своего пользователя на сервере. Символы при вводе не видны — так и должно быть: наберите пароль и нажмите Enter. На вопросDo you want to continue? [Y/n]нажмите Y и Enter. - Проверьте:
composer -V. В ответе — номер версии Composer. - Перейдите в папку проекта — ту, где лежит файл composer.json, — командой
cdи установите библиотеки:composer install. Без sudo — почему.
Какая версия поставится
| Ubuntu | Версия Composer | Пакет |
|---|---|---|
| 24.04 | Composer 2.7.1 | composer 2.7.1 |
| 26.04 | Composer 2.9.5 | composer 2.9.5 |
Номера версий взяты со страниц пакетов Ubuntu на 14 октября 2026 года. Пакет лежит в разделе universe. Если apt его не находит — разбор ошибки.
Вместе с Composer ставятся PHP для командной строки (пакет php-cli), git, архиваторы unzip и xz-utils и модули PHP curl, intl, mbstring и zip. Если PHP на сервере уже стоит, apt доставит только то, чего не хватает.
Нужна версия новее, чем в Ubuntu, — её выкладывают на официальном сайте Composer: getcomposer.org. Там же описана установка.
Почему без sudo
Composer выполняет скрипты из файла composer.json и плагины библиотек. Они работают с правами того, кто запустил composer: под sudo — с правами root, то есть с полным доступом к серверу. Кроме того, файлы, которые composer создаст под sudo, будут принадлежать root, и потом ваш пользователь не сможет их изменить.
Поэтому запускайте composer от своего пользователя, в папке, которая ему принадлежит. Если composer ругается на права доступа к папке проекта — кому принадлежат файлы и как это поменять.
Основные команды
| Команда | Что делает |
|---|---|
composer install | ставит библиотеки проекта: по файлу composer.lock, если он есть, иначе по composer.json |
composer require имя/пакета | добавляет библиотеку в composer.json и ставит её |
composer update | обновляет библиотеки до последних версий, которые разрешает composer.json, и переписывает composer.lock |
composer remove имя/пакета | удаляет библиотеку из проекта |
composer show | список установленных библиотек |
composer outdated | какие библиотеки можно обновить |
composer check-platform-reqs | проверяет, хватает ли проекту версии PHP и модулей |
composer diagnose | ищет проблемы в системе и настройках Composer |
Библиотеки складываются в папку vendor внутри проекта. Чтобы выполнить команду в другой папке, не переходя в неё, добавьте -d и путь: composer install -d ~/myproject.
composer update может поставить более новые версии библиотек, чем были у проекта. На рабочем сайте для установки используйте composer install — он берёт точные версии из composer.lock.Если не хватает модуля PHP
Проекту могут быть нужны модули PHP, которых на сервере нет. Тогда composer install остановится и назовёт модуль с приставкой ext-, например ext-gd. Полный список недостающего покажет composer check-platform-reqs.
Модуль ставится пакетом php- с тем же именем:
| Что просит Composer | Какой пакет поставить |
|---|---|
ext-gd | sudo apt install php-gd |
ext-curl | sudo apt install php-curl |
ext-zip | sudo apt install php-zip |
ext-dom, ext-xml, ext-simplexml | sudo apt install php-xml |
Модуль ставится сразу для командной строки и для PHP-FPM. Чтобы сайт на nginx тоже его увидел, перезапустите PHP-FPM: sudo systemctl restart php8.3-fpm (в Ubuntu 26.04 — php8.5-fpm). Подробнее — Как установить PHP на Ubuntu.
Ошибки и как их исправить
| Что видите | Что делать |
|---|---|
composer: command not found | Composer не установлен: sudo apt install composer |
Unable to locate package composer | apt не нашёл пакет |
| composer install просит модуль ext-… | поставьте модуль PHP |
| Composer предупреждает о запуске от root | запустите команду без sudo, от своего пользователя — почему |
Permission denied при записи в папку проекта | папка принадлежит другому пользователю — как это исправить |
Источники
- Пакет composer в Ubuntu 24.04 — ставит Composer 2.7.1, зависит от php-cli.
- Пакет composer в Ubuntu 26.04 — ставит Composer 2.9.5.
- Пакет php-xml в Ubuntu 24.04 — модули DOM, SimpleXML, XML и XSL.
- Справка composer для Ubuntu 24.04 — список команд, ключи -d, --no-scripts и --no-plugins.
Сверено 14 октября 2026 года.
Что почитать дальше
- Как установить PHP на UbuntuPHP-FPM для сайта на nginx.
- Как разместить сайт на VPSсайт на nginx с доменом и HTTPS.
- Как установить MySQL на Ubuntuбаза для сайта на PHP.
- Установка программ на Ubuntuчто ещё поставить на сервер.