2013-09-26 16:41:19 +00:00
|
|
|
<?php
|
2018-01-14 13:10:21 +00:00
|
|
|
declare(strict_types=1);
|
2013-09-26 16:41:19 +00:00
|
|
|
/**
|
2016-07-21 15:07:57 +00:00
|
|
|
* @copyright Copyright (c) 2016, ownCloud, Inc.
|
|
|
|
*
|
2015-03-26 10:44:34 +00:00
|
|
|
* @author Bart Visscher <bartv@thisnet.nl>
|
2017-11-06 14:56:42 +00:00
|
|
|
* @author Felix Epp <work@felixepp.de>
|
2016-07-21 15:07:57 +00:00
|
|
|
* @author Joas Schilling <coding@schilljs.com>
|
2017-11-06 14:56:42 +00:00
|
|
|
* @author Julius Haertl <jus@bitgrid.net>
|
|
|
|
* @author Julius Härtl <jus@bitgrid.net>
|
2015-03-26 10:44:34 +00:00
|
|
|
* @author Jörn Friedrich Dreyer <jfd@butonic.de>
|
2016-05-26 17:56:05 +00:00
|
|
|
* @author Lukas Reschke <lukas@statuscode.ch>
|
|
|
|
* @author mmccarn <mmccarn-github@mmsionline.us>
|
2015-03-26 10:44:34 +00:00
|
|
|
* @author Morris Jobke <hey@morrisjobke.de>
|
2016-07-21 16:13:36 +00:00
|
|
|
* @author Robin Appelman <robin@icewind.nl>
|
2016-01-12 14:02:16 +00:00
|
|
|
* @author Robin McCorkell <robin@mccorkell.me.uk>
|
2015-03-26 10:44:34 +00:00
|
|
|
* @author Thomas Müller <thomas.mueller@tmit.eu>
|
|
|
|
* @author Thomas Tanghus <thomas@tanghus.net>
|
|
|
|
*
|
|
|
|
* @license AGPL-3.0
|
|
|
|
*
|
|
|
|
* This code is free software: you can redistribute it and/or modify
|
|
|
|
* it under the terms of the GNU Affero General Public License, version 3,
|
|
|
|
* as published by the Free Software Foundation.
|
|
|
|
*
|
|
|
|
* This program is distributed in the hope that it will be useful,
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
* GNU Affero General Public License for more details.
|
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU Affero General Public License, version 3,
|
|
|
|
* along with this program. If not, see <http://www.gnu.org/licenses/>
|
2013-09-26 16:41:19 +00:00
|
|
|
*
|
|
|
|
*/
|
2015-02-26 10:37:37 +00:00
|
|
|
|
2013-09-26 16:41:19 +00:00
|
|
|
namespace OC;
|
2016-07-22 14:49:33 +00:00
|
|
|
|
2018-02-27 09:15:31 +00:00
|
|
|
use OCA\Theming\ThemingDefaults;
|
2015-03-17 11:35:47 +00:00
|
|
|
use OCP\ICacheFactory;
|
|
|
|
use OCP\IConfig;
|
2017-06-15 19:51:51 +00:00
|
|
|
use OCP\IRequest;
|
2013-10-06 22:32:39 +00:00
|
|
|
use OCP\IURLGenerator;
|
|
|
|
use RuntimeException;
|
2013-09-26 16:41:19 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Class to generate URLs
|
|
|
|
*/
|
2013-10-06 22:32:39 +00:00
|
|
|
class URLGenerator implements IURLGenerator {
|
2015-03-17 11:35:47 +00:00
|
|
|
/** @var IConfig */
|
2013-12-31 13:36:02 +00:00
|
|
|
private $config;
|
2015-03-17 11:35:47 +00:00
|
|
|
/** @var ICacheFactory */
|
|
|
|
private $cacheFactory;
|
2017-06-15 19:51:51 +00:00
|
|
|
/** @var IRequest */
|
|
|
|
private $request;
|
2013-12-31 13:36:02 +00:00
|
|
|
|
|
|
|
/**
|
2015-03-17 11:35:47 +00:00
|
|
|
* @param IConfig $config
|
|
|
|
* @param ICacheFactory $cacheFactory
|
2017-06-15 19:51:51 +00:00
|
|
|
* @param IRequest $request
|
2013-12-31 13:36:02 +00:00
|
|
|
*/
|
2015-03-17 11:35:47 +00:00
|
|
|
public function __construct(IConfig $config,
|
2017-06-15 19:51:51 +00:00
|
|
|
ICacheFactory $cacheFactory,
|
|
|
|
IRequest $request) {
|
2013-12-31 13:36:02 +00:00
|
|
|
$this->config = $config;
|
2015-03-17 11:35:47 +00:00
|
|
|
$this->cacheFactory = $cacheFactory;
|
2017-06-15 19:51:51 +00:00
|
|
|
$this->request = $request;
|
2013-12-31 13:36:02 +00:00
|
|
|
}
|
|
|
|
|
2013-09-26 16:41:19 +00:00
|
|
|
/**
|
2014-05-19 15:50:53 +00:00
|
|
|
* Creates an url using a defined route
|
2014-05-11 20:51:30 +00:00
|
|
|
* @param string $route
|
2015-02-12 15:35:47 +00:00
|
|
|
* @param array $parameters args with param=>value, will be appended to the returned url
|
2014-04-15 20:55:20 +00:00
|
|
|
* @return string the url
|
2013-09-26 16:41:19 +00:00
|
|
|
*
|
2014-09-08 12:43:14 +00:00
|
|
|
* Returns a url to the given route.
|
2013-09-26 16:41:19 +00:00
|
|
|
*/
|
2018-01-14 13:10:21 +00:00
|
|
|
public function linkToRoute(string $route, array $parameters = array()): string {
|
2015-11-25 15:58:54 +00:00
|
|
|
// TODO: mock router
|
2018-01-14 13:10:21 +00:00
|
|
|
return \OC::$server->getRouter()->generate($route, $parameters);
|
2013-09-26 16:41:19 +00:00
|
|
|
}
|
|
|
|
|
2014-09-08 12:43:14 +00:00
|
|
|
/**
|
|
|
|
* Creates an absolute url using a defined route
|
2015-02-12 15:35:47 +00:00
|
|
|
* @param string $routeName
|
|
|
|
* @param array $arguments args with param=>value, will be appended to the returned url
|
2014-09-08 12:43:14 +00:00
|
|
|
* @return string the url
|
|
|
|
*
|
|
|
|
* Returns an absolute url to the given route.
|
|
|
|
*/
|
2018-01-14 13:10:21 +00:00
|
|
|
public function linkToRouteAbsolute(string $routeName, array $arguments = array()): string {
|
2014-09-08 12:43:14 +00:00
|
|
|
return $this->getAbsoluteURL($this->linkToRoute($routeName, $arguments));
|
|
|
|
}
|
|
|
|
|
2018-10-04 19:06:00 +00:00
|
|
|
public function linkToOCSRouteAbsolute(string $routeName, array $arguments = []): string {
|
|
|
|
$route = \OC::$server->getRouter()->generate('ocs.'.$routeName, $arguments, false);
|
|
|
|
|
|
|
|
if (strpos($route, '/index.php') === 0) {
|
|
|
|
$route = substr($route, 10);
|
|
|
|
}
|
|
|
|
|
|
|
|
$route = substr($route, 7);
|
|
|
|
$route = '/ocs/v2.php' . $route;
|
|
|
|
|
|
|
|
return $this->getAbsoluteURL($route);
|
|
|
|
}
|
|
|
|
|
2013-09-26 16:41:19 +00:00
|
|
|
/**
|
2014-05-19 15:50:53 +00:00
|
|
|
* Creates an url
|
2013-09-26 16:41:19 +00:00
|
|
|
* @param string $app app
|
|
|
|
* @param string $file file
|
|
|
|
* @param array $args array with param=>value, will be appended to the returned url
|
|
|
|
* The value of $args will be urlencoded
|
|
|
|
* @return string the url
|
|
|
|
*
|
|
|
|
* Returns a url to the given app and file.
|
|
|
|
*/
|
2018-01-14 13:10:21 +00:00
|
|
|
public function linkTo(string $app, string $file, array $args = array()): string {
|
2016-10-01 10:17:55 +00:00
|
|
|
$frontControllerActive = ($this->config->getSystemValue('htaccess.IgnoreFrontController', false) === true || getenv('front_controller_active') === 'true');
|
2013-12-31 13:36:02 +00:00
|
|
|
|
2018-01-14 13:10:21 +00:00
|
|
|
if( $app !== '' ) {
|
2013-09-26 16:41:19 +00:00
|
|
|
$app_path = \OC_App::getAppPath($app);
|
|
|
|
// Check if the app is in the app folder
|
|
|
|
if ($app_path && file_exists($app_path . '/' . $file)) {
|
2018-01-14 13:10:21 +00:00
|
|
|
if (substr($file, -3) === 'php') {
|
2013-12-31 13:36:02 +00:00
|
|
|
|
2013-09-26 16:41:19 +00:00
|
|
|
$urlLinkTo = \OC::$WEBROOT . '/index.php/apps/' . $app;
|
2013-12-31 13:36:02 +00:00
|
|
|
if ($frontControllerActive) {
|
|
|
|
$urlLinkTo = \OC::$WEBROOT . '/apps/' . $app;
|
|
|
|
}
|
2018-01-14 13:10:21 +00:00
|
|
|
$urlLinkTo .= ($file !== 'index.php') ? '/' . $file : '';
|
2013-09-26 16:41:19 +00:00
|
|
|
} else {
|
|
|
|
$urlLinkTo = \OC_App::getAppWebPath($app) . '/' . $file;
|
|
|
|
}
|
|
|
|
} else {
|
|
|
|
$urlLinkTo = \OC::$WEBROOT . '/' . $app . '/' . $file;
|
|
|
|
}
|
|
|
|
} else {
|
|
|
|
if (file_exists(\OC::$SERVERROOT . '/core/' . $file)) {
|
|
|
|
$urlLinkTo = \OC::$WEBROOT . '/core/' . $file;
|
|
|
|
} else {
|
2013-12-31 13:36:02 +00:00
|
|
|
if ($frontControllerActive && $file === 'index.php') {
|
2015-12-02 10:27:07 +00:00
|
|
|
$urlLinkTo = \OC::$WEBROOT . '/';
|
2013-12-31 13:36:02 +00:00
|
|
|
} else {
|
|
|
|
$urlLinkTo = \OC::$WEBROOT . '/' . $file;
|
|
|
|
}
|
2013-09-26 16:41:19 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
if ($args && $query = http_build_query($args, '', '&')) {
|
|
|
|
$urlLinkTo .= '?' . $query;
|
|
|
|
}
|
|
|
|
|
|
|
|
return $urlLinkTo;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2014-05-19 15:50:53 +00:00
|
|
|
* Creates path to an image
|
2013-09-26 16:41:19 +00:00
|
|
|
* @param string $app app
|
|
|
|
* @param string $image image name
|
2014-04-21 13:44:54 +00:00
|
|
|
* @throws \RuntimeException If the image does not exist
|
2013-09-26 16:41:19 +00:00
|
|
|
* @return string the url
|
|
|
|
*
|
|
|
|
* Returns the path to the image.
|
|
|
|
*/
|
2018-01-14 13:10:21 +00:00
|
|
|
public function imagePath(string $app, string $image): string {
|
2017-12-15 10:31:13 +00:00
|
|
|
$cache = $this->cacheFactory->createDistributed('imagePath-'.md5($this->getBaseUrl()).'-');
|
2015-03-17 11:35:47 +00:00
|
|
|
$cacheKey = $app.'-'.$image;
|
2015-03-17 12:15:52 +00:00
|
|
|
if($key = $cache->get($cacheKey)) {
|
|
|
|
return $key;
|
2015-03-17 11:35:47 +00:00
|
|
|
}
|
|
|
|
|
2015-03-17 11:47:46 +00:00
|
|
|
// Read the selected theme from the config file
|
|
|
|
$theme = \OC_Util::getTheme();
|
|
|
|
|
2013-10-23 14:44:56 +00:00
|
|
|
//if a theme has a png but not an svg always use the png
|
|
|
|
$basename = substr(basename($image),0,-4);
|
|
|
|
|
2015-04-03 22:42:18 +00:00
|
|
|
$appPath = \OC_App::getAppPath($app);
|
|
|
|
|
2013-09-26 16:41:19 +00:00
|
|
|
// Check if the app is in the app folder
|
2015-03-17 11:35:47 +00:00
|
|
|
$path = '';
|
2016-12-09 11:52:17 +00:00
|
|
|
$themingEnabled = $this->config->getSystemValue('installed', false) && \OCP\App::isEnabled('theming') && \OC_App::isAppLoaded('theming');
|
2017-09-11 13:03:47 +00:00
|
|
|
$themingImagePath = false;
|
|
|
|
if($themingEnabled) {
|
2018-02-27 09:15:31 +00:00
|
|
|
$themingDefaults = \OC::$server->getThemingDefaults();
|
|
|
|
if ($themingDefaults instanceof ThemingDefaults) {
|
|
|
|
$themingImagePath = $themingDefaults->replaceImagePath($app, $image);
|
|
|
|
}
|
2017-09-11 13:03:47 +00:00
|
|
|
}
|
|
|
|
|
2017-05-23 13:20:54 +00:00
|
|
|
if (file_exists(\OC::$SERVERROOT . "/themes/$theme/apps/$app/img/$image")) {
|
2015-03-17 11:35:47 +00:00
|
|
|
$path = \OC::$WEBROOT . "/themes/$theme/apps/$app/img/$image";
|
2013-10-23 14:44:56 +00:00
|
|
|
} elseif (!file_exists(\OC::$SERVERROOT . "/themes/$theme/apps/$app/img/$basename.svg")
|
2013-10-28 13:18:20 +00:00
|
|
|
&& file_exists(\OC::$SERVERROOT . "/themes/$theme/apps/$app/img/$basename.png")) {
|
2015-03-17 11:35:47 +00:00
|
|
|
$path = \OC::$WEBROOT . "/themes/$theme/apps/$app/img/$basename.png";
|
2013-09-26 16:41:19 +00:00
|
|
|
} elseif (!empty($app) and file_exists(\OC::$SERVERROOT . "/themes/$theme/$app/img/$image")) {
|
2015-03-17 11:35:47 +00:00
|
|
|
$path = \OC::$WEBROOT . "/themes/$theme/$app/img/$image";
|
2013-10-23 14:44:56 +00:00
|
|
|
} elseif (!empty($app) and (!file_exists(\OC::$SERVERROOT . "/themes/$theme/$app/img/$basename.svg")
|
2013-10-28 13:18:20 +00:00
|
|
|
&& file_exists(\OC::$SERVERROOT . "/themes/$theme/$app/img/$basename.png"))) {
|
2015-03-17 11:35:47 +00:00
|
|
|
$path = \OC::$WEBROOT . "/themes/$theme/$app/img/$basename.png";
|
2013-09-26 16:41:19 +00:00
|
|
|
} elseif (file_exists(\OC::$SERVERROOT . "/themes/$theme/core/img/$image")) {
|
2015-03-17 11:35:47 +00:00
|
|
|
$path = \OC::$WEBROOT . "/themes/$theme/core/img/$image";
|
2013-10-23 14:44:56 +00:00
|
|
|
} elseif (!file_exists(\OC::$SERVERROOT . "/themes/$theme/core/img/$basename.svg")
|
2013-10-28 13:18:20 +00:00
|
|
|
&& file_exists(\OC::$SERVERROOT . "/themes/$theme/core/img/$basename.png")) {
|
2015-03-17 11:35:47 +00:00
|
|
|
$path = \OC::$WEBROOT . "/themes/$theme/core/img/$basename.png";
|
2017-09-11 13:03:47 +00:00
|
|
|
} elseif($themingEnabled && $themingImagePath) {
|
|
|
|
$path = $themingImagePath;
|
2016-04-04 10:57:52 +00:00
|
|
|
} elseif ($appPath && file_exists($appPath . "/img/$image")) {
|
|
|
|
$path = \OC_App::getAppWebPath($app) . "/img/$image";
|
|
|
|
} elseif ($appPath && !file_exists($appPath . "/img/$basename.svg")
|
|
|
|
&& file_exists($appPath . "/img/$basename.png")) {
|
|
|
|
$path = \OC_App::getAppWebPath($app) . "/img/$basename.png";
|
|
|
|
} elseif (!empty($app) and file_exists(\OC::$SERVERROOT . "/$app/img/$image")) {
|
|
|
|
$path = \OC::$WEBROOT . "/$app/img/$image";
|
|
|
|
} elseif (!empty($app) and (!file_exists(\OC::$SERVERROOT . "/$app/img/$basename.svg")
|
|
|
|
&& file_exists(\OC::$SERVERROOT . "/$app/img/$basename.png"))) {
|
|
|
|
$path = \OC::$WEBROOT . "/$app/img/$basename.png";
|
2013-09-26 16:41:19 +00:00
|
|
|
} elseif (file_exists(\OC::$SERVERROOT . "/core/img/$image")) {
|
2015-03-17 11:35:47 +00:00
|
|
|
$path = \OC::$WEBROOT . "/core/img/$image";
|
2016-04-04 10:57:52 +00:00
|
|
|
} elseif (!file_exists(\OC::$SERVERROOT . "/core/img/$basename.svg")
|
|
|
|
&& file_exists(\OC::$SERVERROOT . "/core/img/$basename.png")) {
|
|
|
|
$path = \OC::$WEBROOT . "/themes/$theme/core/img/$basename.png";
|
2015-03-17 11:35:47 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
if($path !== '') {
|
|
|
|
$cache->set($cacheKey, $path);
|
|
|
|
return $path;
|
2013-09-26 16:41:19 +00:00
|
|
|
}
|
2018-01-14 13:10:21 +00:00
|
|
|
|
|
|
|
throw new RuntimeException('image not found: image:' . $image . ' webroot:' . \OC::$WEBROOT . ' serverroot:' . \OC::$SERVERROOT);
|
2013-09-26 16:41:19 +00:00
|
|
|
}
|
|
|
|
|
2013-10-06 22:32:39 +00:00
|
|
|
|
2013-09-26 16:41:19 +00:00
|
|
|
/**
|
2013-10-06 22:32:39 +00:00
|
|
|
* Makes an URL absolute
|
2014-11-24 15:24:26 +00:00
|
|
|
* @param string $url the url in the ownCloud host
|
2013-10-06 22:32:39 +00:00
|
|
|
* @return string the absolute version of the url
|
2013-09-26 16:41:19 +00:00
|
|
|
*/
|
2018-01-14 13:10:21 +00:00
|
|
|
public function getAbsoluteURL(string $url): string {
|
2014-02-07 16:39:19 +00:00
|
|
|
$separator = $url[0] === '/' ? '' : '/';
|
2014-03-06 22:56:11 +00:00
|
|
|
|
2018-01-14 13:10:21 +00:00
|
|
|
if (\OC::$CLI && !\defined('PHPUNIT_RUN')) {
|
2014-10-13 09:18:24 +00:00
|
|
|
return rtrim($this->config->getSystemValue('overwrite.cli.url'), '/') . '/' . ltrim($url, '/');
|
|
|
|
}
|
2014-03-31 12:24:38 +00:00
|
|
|
// The ownCloud web root can already be prepended.
|
2018-01-14 13:10:21 +00:00
|
|
|
if(substr($url, 0, \strlen(\OC::$WEBROOT)) === \OC::$WEBROOT) {
|
|
|
|
$url = substr($url, \strlen(\OC::$WEBROOT));
|
2017-06-15 10:35:16 +00:00
|
|
|
}
|
2014-03-31 12:24:38 +00:00
|
|
|
|
2017-06-15 10:35:16 +00:00
|
|
|
return $this->getBaseUrl() . $separator . $url;
|
2013-09-26 16:41:19 +00:00
|
|
|
}
|
2014-11-24 15:24:26 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @param string $key
|
|
|
|
* @return string url to the online documentation
|
|
|
|
*/
|
2018-01-14 13:10:21 +00:00
|
|
|
public function linkToDocs(string $key): string {
|
2016-07-15 06:46:31 +00:00
|
|
|
$theme = \OC::$server->getThemingDefaults();
|
2014-11-24 15:24:26 +00:00
|
|
|
return $theme->buildDocLinkToKey($key);
|
|
|
|
}
|
2017-06-15 10:35:16 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @return string base url of the current request
|
|
|
|
*/
|
2018-01-14 13:10:21 +00:00
|
|
|
public function getBaseUrl(): string {
|
2017-06-15 19:51:51 +00:00
|
|
|
return $this->request->getServerProtocol() . '://' . $this->request->getServerHost() . \OC::$WEBROOT;
|
2017-06-15 10:35:16 +00:00
|
|
|
}
|
2013-09-26 16:41:19 +00:00
|
|
|
}
|