composer/src/Composer/Repository/RepositoryManager.php

<?php

/*
 * This file is part of Composer.
 *
 * (c) Nils Adermann <naderman@naderman.de>
 *     Jordi Boggiano <j.boggiano@seld.be>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

namespace Composer\Repository;

use Composer\IO\IOInterface;
use Composer\Config;

/**
 * Repositories manager.
 *
 * @author Jordi Boggiano <j.boggiano@seld.be>
 * @author Konstantin Kudryashov <ever.zet@gmail.com>
 * @author François Pluchino <francois.pluchino@opendisplay.com>
 */
class RepositoryManager
{
    private $localRepository;
    private $localDevRepository;
    private $repositories = array();
    private $repositoryClasses = array();
    private $io;
    private $config;

    public function __construct(IOInterface $io, Config $config)
    {
        $this->io = $io;
        $this->config = $config;
    }

    /**
     * Searches for a package by it's name and version in managed repositories.
     *
     * @param   string  $name       package name
     * @param   string  $version    package version
     *
     * @return  PackageInterface|null
     */
    public function findPackage($name, $version)
    {
        foreach ($this->repositories as $repository) {
            if ($package = $repository->findPackage($name, $version)) {
                return $package;
            }
        }
    }

    /**
     * Searches for all packages matching a name and optionally a version in managed repositories.
     *
     * @param   string  $name       package name
     * @param   string  $version    package version
     *
     * @return  array
     */
    public function findPackages($name, $version)
    {
        $packages = array();

        foreach ($this->repositories as $repository) {
            $packages = array_merge($packages, $repository->findPackages($name, $version));
        }

        return $packages;
    }

    /**
     * Adds repository
     *
     * @param   RepositoryInterface $repository repository instance
     */
    public function addRepository(RepositoryInterface $repository)
    {
        $this->repositories[] = $repository;
    }

    /**
     * Returns a new repository for a specific installation type.
     *
     * @param   string $type repository type
     * @param   string $config repository configuration
     * @return  RepositoryInterface
     * @throws  InvalidArgumentException     if repository for provided type is not registeterd
     */
    public function createRepository($type, $config)
    {
        if (!isset($this->repositoryClasses[$type])) {
            throw new \InvalidArgumentException('Repository type is not registered: '.$type);
        }

        $class = $this->repositoryClasses[$type];
        return new $class($config, $this->io, $this->config);
    }

    /**
     * Stores repository class for a specific installation type.
     *
     * @param   string  $type   installation type
     * @param   string  $class  class name of the repo implementation
     */
    public function setRepositoryClass($type, $class)
    {
        $this->repositoryClasses[$type] = $class;
    }

    /**
     * Returns all repositories, except local one.
     *
     * @return  array
     */
    public function getRepositories()
    {
        return $this->repositories;
    }

    /**
     * Sets local repository for the project.
     *
     * @param   RepositoryInterface $repository repository instance
     */
    public function setLocalRepository(RepositoryInterface $repository)
    {
        $this->localRepository = $repository;
    }

    /**
     * Returns local repository for the project.
     *
     * @return  RepositoryInterface
     */
    public function getLocalRepository()
    {
        return $this->localRepository;
    }

    /**
     * Sets localDev repository for the project.
     *
     * @param   RepositoryInterface $repository repository instance
     */
    public function setLocalDevRepository(RepositoryInterface $repository)
    {
        $this->localDevRepository = $repository;
    }

    /**
     * Returns localDev repository for the project.
     *
     * @return  RepositoryInterface
     */
    public function getLocalDevRepository()
    {
        return $this->localDevRepository;
    }

    /**
     * Returns all local repositories for the project.
     *
     * @return  array[RepositoryInterface]
     */
    public function getLocalRepositories()
    {
        return array($this->localRepository, $this->localDevRepository);
    }
}