Chris@0: <?php
Chris@0: 
Chris@0: /*
Chris@0:  * This file is part of the Symfony package.
Chris@0:  *
Chris@0:  * (c) Fabien Potencier <fabien@symfony.com>
Chris@0:  *
Chris@0:  * For the full copyright and license information, please view the LICENSE
Chris@0:  * file that was distributed with this source code.
Chris@0:  */
Chris@0: 
Chris@0: namespace Symfony\Component\Routing\Matcher;
Chris@0: 
Chris@17: use Symfony\Component\Routing\Exception\MethodNotAllowedException;
Chris@14: use Symfony\Component\Routing\Exception\NoConfigurationException;
Chris@17: use Symfony\Component\Routing\Exception\ResourceNotFoundException;
Chris@0: use Symfony\Component\Routing\RequestContextAwareInterface;
Chris@0: 
Chris@0: /**
Chris@0:  * UrlMatcherInterface is the interface that all URL matcher classes must implement.
Chris@0:  *
Chris@0:  * @author Fabien Potencier <fabien@symfony.com>
Chris@0:  */
Chris@0: interface UrlMatcherInterface extends RequestContextAwareInterface
Chris@0: {
Chris@0:     /**
Chris@0:      * Tries to match a URL path with a set of routes.
Chris@0:      *
Chris@0:      * If the matcher can not find information, it must throw one of the exceptions documented
Chris@0:      * below.
Chris@0:      *
Chris@0:      * @param string $pathinfo The path info to be parsed (raw format, i.e. not urldecoded)
Chris@0:      *
Chris@0:      * @return array An array of parameters
Chris@0:      *
Chris@14:      * @throws NoConfigurationException  If no routing configuration could be found
Chris@0:      * @throws ResourceNotFoundException If the resource could not be found
Chris@0:      * @throws MethodNotAllowedException If the resource was found but the request method is not allowed
Chris@0:      */
Chris@0:     public function match($pathinfo);
Chris@0: }