Практически каждый современный PHP-проект использует Composer — менеджер зависимостей, который значительно упрощает разработку. Если вы планируете работать с Laravel, Symfony или любым другим современным PHP-фреймворком, знание Composer является обязательным.

В этой статье мы разберем, что такое Composer, как установить его на Ubuntu 24.04, познакомимся с основными командами и создадим первый проект на Laravel.

Что такое Composer

Composer — это менеджер зависимостей для PHP.

Он автоматически скачивает необходимые библиотеки, следит за их версиями и помогает поддерживать проект в актуальном состоянии.

Например, вместо того чтобы вручную скачивать десятки библиотек, достаточно выполнить одну команду:

composer install

Composer самостоятельно загрузит все зависимости, указанные в файле composer.json.

Почему Composer необходим

До появления Composer разработчикам приходилось:

• вручную скачивать библиотеки;

• следить за совместимостью версий;

• самостоятельно подключать файлы;

• обновлять пакеты вручную.

Сегодня Composer автоматизирует все эти процессы.

Его используют практически все современные PHP-проекты.

Где используется Composer

Composer применяется в:

• Laravel;

• Symfony;

• CodeIgniter;

• Yii;

• WordPress (через Bedrock и плагины);

• Bitrix;

• Magento;

• Drupal;

• OpenCart;

• любых современных PHP-проектах.

Проверяем наличие Composer

Перед установкой убедитесь, что Composer отсутствует:

composer --version

Если команда не найдена — переходим к установке.

Требования

Перед установкой Composer необходимо установить PHP.

Проверьте:

php -v

Также желательно наличие следующих расширений:

• mbstring;

• openssl;

• json;

• tokenizer;

• ctype;

• xml;

• fileinfo;

• curl.

Посмотреть установленные расширения:

php -m

Установка Composer

Обновите систему:

sudo apt update

Установите Composer:

sudo apt install composer -y

Проверьте установку:

composer --version

Например:

Composer version 2.8.x

Обновление Composer

Обновить Composer можно командой:

composer self-update

Если Composer установлен из репозитория Ubuntu, рекомендуется обновлять его через систему пакетов:

sudo apt update
sudo apt upgrade composer

Где находится Composer

Проверить путь:

which composer

Например:

/usr/bin/composer

Создание первого проекта Laravel

Создать новый проект можно одной командой:

composer create-project laravel/laravel my-project

После загрузки перейдите в каталог проекта:

cd my-project

Запуск встроенного сервера Laravel

Выполните:

php artisan serve

По умолчанию приложение будет доступно по адресу:

http://127.0.0.1:8000

Структура проекта Laravel

После установки вы увидите примерно такую структуру:

app/
bootstrap/
config/
database/
public/
resources/
routes/
storage/
tests/
vendor/
artisan
composer.json

Самые важные каталоги:

• app/ — код приложения;

• routes/ — маршруты;

• resources/ — шаблоны Blade;

• public/ — публичные файлы;

• storage/ — логи и кеш;

• vendor/ — библиотеки Composer.

Основные команды Composer

Установить зависимости

composer install

Используется после клонирования проекта.

Обновить зависимости

composer update

Обновляет библиотеки до разрешённых версий.

Добавить библиотеку

Например:

composer require spatie/laravel-permission

Composer автоматически скачает пакет и обновит composer.json.

Удалить библиотеку

composer remove spatie/laravel-permission

Обновить автозагрузку

composer dump-autoload

Очень полезная команда после создания новых классов.

Проверить информацию о пакетах

composer show

Поиск пакета

composer search redis

Проверка устаревших библиотек

composer outdated

Проверка безопасности

composer audit

Команда покажет библиотеки с известными уязвимостями.

Файл composer.json

Практически каждый PHP-проект содержит файл:

composer.json

Например:

{
    "require": {
        "php": "^8.4",
        "laravel/framework": "^12.0"
    }
}

Именно здесь хранится список зависимостей проекта.

Файл composer.lock

После установки появляется файл:

composer.lock

Он фиксирует точные версии всех библиотек.

Этот файл необходимо хранить в Git.

Каталог vendor

После выполнения:

composer install

будет создан каталог:

vendor/

Здесь находятся все скачанные библиотеки.

Не рекомендуется изменять файлы внутри этого каталога вручную.

Работа с автозагрузкой

Composer автоматически загружает классы.

Например, после создания нового класса:

namespace App\Services;

class PaymentService
{

}

достаточно выполнить:

composer dump-autoload

И класс станет доступен в приложении.

Полезные команды Laravel

После установки проекта чаще всего используются:

Очистить кеш:

php artisan optimize:clear

Просмотреть список команд:

php artisan

Создать контроллер:

php artisan make:controller UserController

Создать модель:

php artisan make:model Post

Создать миграцию:

php artisan make:migration create_posts_table

Выполнить миграции:

php artisan migrate

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

Composer command not found

Проверьте:

which composer

Если Composer отсутствует, переустановите его.

PHP version does not satisfy requirements

Обновите PHP до требуемой версии.

Проверьте:

php -v

Allowed memory size exhausted

Попробуйте:

php -d memory_limit=-1 /usr/bin/composer install

или увеличьте параметр memory_limit в php.ini.

Vendor directory missing

Выполните:

composer install

Class not found

Обновите автозагрузчик:

composer dump-autoload

Советы по работе с Composer

Для стабильной работы проектов рекомендуется:

• использовать актуальную версию Composer;

• хранить composer.lock в репозитории;

• не редактировать каталог vendor вручную;

• регулярно выполнять composer audit;

• использовать composer install на production-серверах вместо composer update;

• перед обновлением зависимостей создавать резервную копию проекта.

Заключение

Composer — один из важнейших инструментов в современной PHP-разработке. Он значительно упрощает управление библиотеками, автоматизирует установку зависимостей и обеспечивает совместимость различных компонентов проекта.

Если вы планируете работать с Laravel, Symfony или другими современными PHP-фреймворками, уверенное владение Composer станет одним из базовых навыков. Освоив основные команды и принципы работы, вы сможете быстрее создавать новые проекты, подключать сторонние пакеты и поддерживать свои приложения в актуальном состоянии.