<?php
 
 namespace Illuminate\Contracts\Routing;
 
 interface UrlGenerator
 {
     /**
      * Get the current URL for the request.
      *
      * @return string
      */
     public function current();
 
     /**
      * Get the URL for the previous request.
      *
      * @param  mixed  $fallback
      * @return string
      */
     public function previous($fallback = false);
 
     /**
      * Generate an absolute URL to the given path.
      *
      * @param  string  $path
      * @param  mixed  $extra
      * @param  bool|null  $secure
      * @return string
      */
     public function to($path, $extra = [], $secure = null);
 
     /**
      * Generate a secure, absolute URL to the given path.
      *
      * @param  string  $path
      * @param  array   $parameters
      * @return string
      */
     public function secure($path, $parameters = []);
 
     /**
      * Generate the URL to an application asset.
      *
      * @param  string  $path
      * @param  bool|null  $secure
      * @return string
      */
     public function asset($path, $secure = null);
 
     /**
      * Get the URL to a named route.
      *
      * @param  string  $name
      * @param  mixed   $parameters
      * @param  bool  $absolute
      * @return string
      *
      * @throws \InvalidArgumentException
      */
     public function route($name, $parameters = [], $absolute = true);
 
     /**
      * Get the URL to a controller action.
      *
      * @param  string|array  $action
      * @param  mixed $parameters
      * @param  bool $absolute
      * @return string
      */
     public function action($action, $parameters = [], $absolute = true);
 
     /**
      * Set the root controller namespace.
      *
      * @param  string  $rootNamespace
      * @return $this
      */
     public function setRootControllerNamespace($rootNamespace);
 }