/**
* Returns the activity's URI with the given parameters/options applied. Takes the type of the Url
* of the activity into account.
*
* @param ActivityInterface $activity activity (with a URL and parameters)
* @param array $parameters parameters to merge/replace into the default URL parameters of the activity
* @param array $options options to take into account when generating the URL
*
* @return string resulting URI
*/
public function getUri(ActivityInterface $activity, array $parameters = [], array $options = [])
{
$url = $activity->getUrl();
$params = array_replace_recursive($url->getParameters(), $parameters);
$resulting_uri = '';
if ($url->getType() === Url::TYPE_ROUTE) {
$resulting_uri = $this->url_generator->generateUrl($url->getValue(), $params, $options);
} elseif ($url->getType() === Url::TYPE_URI_TEMPLATE) {
$uri_template = new UriTemplate($url->getValue());
$resulting_uri = $uri_template->expand($params);
} else {
$resulting_uri = $url->__toString();
// TODO apply params here as well as query params? syntax?
}
return $resulting_uri;
}
/**
* Generates a URL for the given route name and parameters. The options
* MAY be used to provide hints for the URL generation. This includes
* information about different parts of a URL, e.g. the scheme or port to
* use or whether absolute or relative URLs should be generated.
*
* The usual URL has the following simplified structure:
*
* scheme://userinfo@host:port/path?query#fragment
*
* @see http://en.wikipedia.org/wiki/URI_scheme
* @see http://tools.ietf.org/html/rfc3986
* @see http://tools.ietf.org/html/std66
*
* Suggested option keys and their default values are:
*
* - 'relative': false
* whether to generate absolute or relative URLs
* - 'separator': '&'
* query parameters separator, e.g. ';' – see ini_get('arg_separator.output')
* - 'scheme': null
* scheme name, e.g. 'ftp' – true/false to include/exclude;
* use an empty string ('') to generate protocol relative URLs ('//host.tld')
* - 'userinfo': null
* user information string, e.g. 'user:pwd' – true/false to include/exclude
* - 'host': null
* host string, e.g 'www.example.org' – true/false to include/exclude
* - 'port': null
* port string, e.g. '8080' – true/false to include/exclude
* - 'authority': null
* authority string, e.g. 'user:info@host:port' – true/false to include/exclude
* - 'path': null
* path string, e.g. 'some/hierarchical/path' – true/false to include/exclude
* - 'fragment': null
* fragment identifier string, e.g. 'foo' – true/false to include/exclude
* - 'use_trans_sid': false
* whether or not to include a session id (SID) – see ini_get('session.use_trans_sid')
*
* Other options may be used as well. Adapters for frameworks SHOULD
* use and convert those options to their respective implementations of
* handling the generation of URLs.
*
* While this interface is for primarily for generating URLs, it SHOULD be
* possible to create any URIs depending on the implementations and the
* provided options.
*
* Please note, that ATM the 'path' option is not supported. The 'prefix' option
* instead allows to set the path part that is fixed for your docroot.
*
* @param mixed $name route-name, lookup-key, or object to generate an URL for
* @param array $parameters pairs of placeholder names and values
* @param array $options array of options to influence URL generation
*
* @return string URL relative or absolute URL
*/
public function generateUrl($name, array $parameters = [], array $options = [])
{
$url = '';
if ($name instanceof ActivityInterface) {
$url = $name->getUrl();
} elseif ($name instanceof Url) {
$url = $name;
} else {
$url = Url::createRoute($name, $parameters);
}
if ($url->getType() === Url::TYPE_ROUTE) {
$route_params = $parameters;
$route_params = array_replace_recursive($url->getParameters(), $parameters);
$link = $this->routing->gen($url->getValue(), $route_params, $options);
} elseif ($url->getType() === Url::TYPE_URI_TEMPLATE) {
$uri_template = new UriTemplate($url->getValue());
$template_params = array_replace_recursive($url->getParameters(), $parameters);
$link = $uri_template->expand($template_params);
} else {
$link = $url->__toString();
// TODO apply params as query params?
}
return $link;
}