Работа с директорией vendor и её содержимым в PHP-проектах

Расширенные примеры работы с файлом vendor

1. Создание собственного пакета с автозагрузкой PSR-4 и тестированием

Структура директорий:

my-package/
├── src/
│   └── Greeter.php              (namespace MyPackage; class Greeter {})
├── tests/
│   └── GreeterTest.php          (namespace MyPackage\Tests;)
├── composer.json
└── vendor/

// src/Greeter.php
<?php
namespace MyPackage;

class Greeter
{
    public function greet(string $name): string
    {
        return "Hello, $name!";
    }
}

// composer.json самого пакета
{
    "name": "mycompany/mypackage",
    "autoload": {
        "psr-4": {
            "MyPackage\\": "src/"
        }
    },
    "require-dev": {
        "phpunit/phpunit": "^9.0"
    },
    "scripts": {
        "test": "phpunit"
    }
}

Подключение этого пакета в другом проекте через composer.json:

{
    "require": {
        "mycompany/mypackage": "dev-main"
    },
    "repositories": [
        {
            "type": "path",
            "url": "../my-package"
        }
    ]
}

После composer update классы из пакета станут доступны.

2. Использование секции autoload.files для загрузки функций

Если библиотека содержит процедурные функции, их можно подключить через files.

// composer.json
{
    "autoload": {
        "files": [
            "src/helpers.php"
        ]
    }
}

// src/helpers.php
<?php
function formatDate(DateTime $date): string {
    return $date->format('Y-m-d');
}

После composer dump-autoload функция доступна глобально:

<?php
require 'vendor/autoload.php';
echo formatDate(new DateTime()); // 2025-03-23

3. Автозагрузка через класс-мап (classmap)

Для проектов без пространств имён или смешанной структуры используется classmap.

// composer.json
{
    "autoload": {
        "classmap": [
            "legacy/",
            "lib/OldLibrary.php"
        ]
    }
}

Composer просканирует указанные директории и файлы, создаст карту классов. Изменения вносятся только после composer dump-autoload.

4. Работа с composer.lock и фиксация версий

Файл vendor не следует хранить в репозитории (gitignore). Вместо него в репозиторий добавляется composer.lock, который фиксирует точные версии установленных пакетов.

# .gitignore
vendor/
.env

На этапе развёртывания:

composer install --no-dev --prefer-dist --no-progress --no-interaction

Если требуется обновить только один пакет, используют composer update vendor/package, а затем коммитят обновлённый lock-файл.

5. Автозагрузка для dev-окружения с autoload-dev

В секции autoload-dev можно указать классы, используемые только при разработке.

// composer.json
{
    "autoload": {
        "psr-4": {
            "App\\": "src/"
        }
    },
    "autoload-dev": {
        "psr-4": {
            "App\\Tests\\": "tests/"
        }
    }
}

После composer dump-autoload в продакшне (с флагом --no-dev) эти классы не будут загружаться.

6. Использование composer-скриптов для автоматизации задач

// composer.json
{
    "scripts": {
        "post-install-cmd": [
            "@clear-cache"
        ],
        "clear-cache": [
            "php -r 'echo \"Cache cleared!\";'"
        ],
        "post-update-cmd": [
            "echo 'Update complete'"
        ]
    }
}

При выполнении composer install или composer update запускаются соответствующие скрипты.

7. Восстановление vendor при повреждении

Если папка vendor удалена или повреждена, восстановление выполняется командой:

composer install --no-cache

Для очистки кэша пакетов:

composer clear-cache

После этого зависимости загрузятся заново.

8. Пример реализации PSR-0 (устаревший стандарт)

// composer.json
{
    "autoload": {
        "psr-0": {
            "MyCompany\\": "src/"
        }
    }
}

При PSR-0 пространство имён соответствует пути с учётом нижнего подчёркивания. Современные проекты используют PSR-4.

9. Ошибка «Class not found» при правильной настройке

Причина может быть в неправильной конфигурации php.ini (путь к директории ext). Проверить версию PHP и extension_dir:

php -i | grep extension_dir

Если класс не загружается, полезно выполнить:

php vendor/bin/var-dump.php  # пример отладчика

10. Установка зависимостей из VCS (git, svn)

// composer.json
{
    "require": {
        "mycompany/private-package": "dev-master"
    },
    "repositories": [
        {
            "type": "vcs",
            "url": "https://github.com/mycompany/private-package.git"
        }
    ]
}

Для аутентификации используется ssh-ключ или token. Файл auth.json сохраняется вне репозитория.

11. Оптимизация автозагрузки для продакшна

composer install --optimize-autoloader --classmap-authoritative

Первый флаг создаёт оптимизированный автозагрузчик с картой классов, второй - отключает поиск по файловой системе, полагаясь только на карту. Это увеличивает скорость загрузки классов.