nextcloud/lib/public/Util.php

534 lines
16 KiB
PHP
Raw Normal View History

<?php
/**
2016-07-21 18:07:57 +03:00
* @copyright Copyright (c) 2016, ownCloud, Inc.
*
2016-05-26 20:56:05 +03:00
* @author Arthur Schiwon <blizzz@arthur-schiwon.de>
2015-03-26 13:44:34 +03:00
* @author Bart Visscher <bartv@thisnet.nl>
2016-05-26 20:56:05 +03:00
* @author Björn Schießle <bjoern@schiessle.org>
* @author Christoph Wurst <christoph@winzerhof-wurst.at>
2016-05-26 20:56:05 +03:00
* @author Frank Karlitschek <frank@karlitschek.de>
* @author Georg Ehrke <oc.list@georgehrke.com>
2015-10-05 21:54:56 +03:00
* @author Individual IT Services <info@individual-it.net>
2015-03-26 13:44:34 +03:00
* @author Jens-Christian Fischer <jens-christian.fischer@switch.ch>
2016-07-21 18:07:57 +03:00
* @author Joas Schilling <coding@schilljs.com>
* @author John Molakvoæ (skjnldsv) <skjnldsv@protonmail.com>
* @author Julius Härtl <jus@bitgrid.net>
2016-05-26 20:56:05 +03:00
* @author Lukas Reschke <lukas@statuscode.ch>
2015-03-26 13:44:34 +03:00
* @author Michael Gapczynski <GapczynskiM@gmail.com>
* @author Morris Jobke <hey@morrisjobke.de>
* @author Pellaeon Lin <nfsmwlin@gmail.com>
* @author Randolph Carter <RandolphCarter@fantasymail.de>
2016-07-21 19:13:36 +03:00
* @author Robin Appelman <robin@icewind.nl>
2016-01-12 17:02:16 +03:00
* @author Robin McCorkell <robin@mccorkell.me.uk>
2016-07-21 18:07:57 +03:00
* @author Roeland Jago Douma <roeland@famdouma.nl>
2015-03-26 13:44:34 +03:00
* @author Thomas Müller <thomas.mueller@tmit.eu>
* @author Victor Dubiniuk <dubiniuk@owncloud.com>
* @author Vincent Petry <vincent@nextcloud.com>
*
2015-03-26 13:44:34 +03:00
* @license AGPL-3.0
*
2015-03-26 13:44:34 +03:00
* 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.
*
2015-03-26 13:44:34 +03:00
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
2015-03-26 13:44:34 +03:00
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Affero General Public License for more details.
*
2015-03-26 13:44:34 +03:00
* 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/>
*
*/
/**
* Public interface of ownCloud for apps to use.
* Utility Class.
*
*/
// use OCP namespace for all classes that are considered public.
// This means that they should be used by apps instead of the internal ownCloud classes
namespace OCP;
2012-05-19 12:36:57 +04:00
/**
* This class provides different helper functions to make the life of a developer easier
*
* @since 4.0.0
2012-05-19 12:36:57 +04:00
*/
class Util {
/**
* @deprecated 14.0.0 use \OCP\ILogger::DEBUG
*/
public const DEBUG = 0;
/**
* @deprecated 14.0.0 use \OCP\ILogger::INFO
*/
public const INFO = 1;
/**
* @deprecated 14.0.0 use \OCP\ILogger::WARN
*/
public const WARN = 2;
/**
* @deprecated 14.0.0 use \OCP\ILogger::ERROR
*/
public const ERROR = 3;
/**
* @deprecated 14.0.0 use \OCP\ILogger::FATAL
*/
public const FATAL = 4;
2016-05-03 12:58:33 +03:00
/** \OCP\Share\IManager */
private static $shareManager;
2012-05-01 23:07:08 +04:00
/**
* get the current installed version of Nextcloud
2012-05-01 23:07:08 +04:00
* @return array
* @since 4.0.0
2012-05-01 23:07:08 +04:00
*/
2012-09-07 17:22:01 +04:00
public static function getVersion() {
return \OC_Util::getVersion();
2012-05-01 23:07:08 +04:00
}
/**
* @since 17.0.0
*/
public static function hasExtendedSupport(): bool {
try {
/** @var \OCP\Support\Subscription\IRegistry */
$subscriptionRegistry = \OC::$server->query(\OCP\Support\Subscription\IRegistry::class);
return $subscriptionRegistry->delegateHasExtendedSupport();
} catch (AppFramework\QueryException $e) {
}
return \OC::$server->getConfig()->getSystemValueBool('extendedSupport', false);
}
/**
* Set current update channel
* @param string $channel
* @since 8.1.0
*/
public static function setChannel($channel) {
\OC::$server->getConfig()->setSystemValue('updater.release.channel', $channel);
}
/**
* Get current update channel
* @return string
* @since 8.1.0
*/
public static function getChannel() {
return \OC_Util::getChannel();
}
2012-05-01 23:07:08 +04:00
2012-09-08 18:18:47 +04:00
/**
2013-10-31 22:00:53 +04:00
* write a message in the log
2012-05-01 11:39:12 +04:00
* @param string $app
* @param string $message
2012-12-25 21:17:32 +04:00
* @param int $level
* @since 4.0.0
* @deprecated 13.0.0 use log of \OCP\ILogger
2012-09-08 18:18:47 +04:00
*/
public static function writeLog($app, $message, $level) {
2015-07-03 16:02:51 +03:00
$context = ['app' => $app];
\OC::$server->getLogger()->log($level, $message, $context);
2012-09-08 18:18:47 +04:00
}
2012-05-01 11:39:12 +04:00
/**
* check if sharing is disabled for the current user
*
* @return boolean
* @since 7.0.0
2016-05-03 12:58:33 +03:00
* @deprecated 9.1.0 Use \OC::$server->getShareManager()->sharingDisabledForUser
*/
public static function isSharingDisabledForUser() {
2016-05-03 12:58:33 +03:00
if (self::$shareManager === null) {
self::$shareManager = \OC::$server->getShareManager();
}
2016-05-03 15:05:51 +03:00
$user = \OC::$server->getUserSession()->getUser();
if ($user !== null) {
$user = $user->getUID();
}
return self::$shareManager->sharingDisabledForUser($user);
}
2013-07-19 13:40:11 +04:00
/**
2013-10-31 22:00:53 +04:00
* get l10n object
* @param string $application
* @param string|null $language
* @return \OCP\IL10N
* @since 6.0.0 - parameter $language was added in 8.0.0
2013-07-19 13:40:11 +04:00
*/
public static function getL10N($application, $language = null) {
2014-08-31 12:05:59 +04:00
return \OC::$server->getL10N($application, $language);
2012-09-08 18:18:47 +04:00
}
2012-05-01 11:39:12 +04:00
/**
2013-10-31 22:00:53 +04:00
* add a css file
* @param string $application
* @param string $file
* @since 4.0.0
2012-05-01 11:39:12 +04:00
*/
public static function addStyle($application, $file = null) {
\OC_Util::addStyle($application, $file);
2012-09-08 18:18:47 +04:00
}
2012-05-01 23:07:08 +04:00
/**
2013-10-31 22:00:53 +04:00
* add a javascript file
2012-12-25 21:17:32 +04:00
* @param string $application
2013-10-31 22:00:53 +04:00
* @param string $file
* @since 4.0.0
2012-05-01 23:07:08 +04:00
*/
public static function addScript($application, $file = null) {
\OC_Util::addScript($application, $file);
2012-09-08 18:18:47 +04:00
}
/**
* Add a translation JS file
* @param string $application application id
* @param string $languageCode language code, defaults to the current locale
* @since 8.0.0
*/
public static function addTranslations($application, $languageCode = null) {
\OC_Util::addTranslations($application, $languageCode);
}
2012-05-01 23:07:08 +04:00
/**
2013-10-31 22:00:53 +04:00
* Add a custom element to the header
* If $text is null then the element will be written as empty element.
* So use "" to get a closing tag.
2012-12-25 21:17:32 +04:00
* @param string $tag tag name of the element
2012-05-01 23:07:08 +04:00
* @param array $attributes array of attributes for the element
* @param string $text the text content for the element
* @since 4.0.0
2012-05-01 23:07:08 +04:00
*/
public static function addHeader($tag, $attributes, $text = null) {
\OC_Util::addHeader($tag, $attributes, $text);
2012-05-01 23:07:08 +04:00
}
2012-05-02 01:19:39 +04:00
/**
2013-10-31 22:00:53 +04:00
* Creates an absolute url to the given app and file.
2012-12-25 21:17:32 +04:00
* @param string $app app
* @param string $file file
* @param array $args array with param=>value, will be appended to the returned url
2012-09-29 00:27:52 +04:00
* The value of $args will be urlencoded
2013-10-31 22:00:53 +04:00
* @return string the url
* @since 4.0.0 - parameter $args was added in 4.5.0
2012-05-02 01:19:39 +04:00
*/
public static function linkToAbsolute($app, $file, $args = []) {
$urlGenerator = \OC::$server->getURLGenerator();
return $urlGenerator->getAbsoluteURL(
$urlGenerator->linkTo($app, $file, $args)
);
2012-05-02 01:19:39 +04:00
}
2012-05-02 00:59:38 +04:00
/**
2013-10-31 22:00:53 +04:00
* Creates an absolute url for remote use.
2012-12-25 21:17:32 +04:00
* @param string $service id
2013-10-31 22:00:53 +04:00
* @return string the url
* @since 4.0.0
*/
public static function linkToRemote($service) {
$urlGenerator = \OC::$server->getURLGenerator();
$remoteBase = $urlGenerator->linkTo('', 'remote.php') . '/' . $service;
return $urlGenerator->getAbsoluteURL(
$remoteBase . (($service[strlen($service) - 1] != '/') ? '/' : '')
);
}
2012-08-27 23:46:05 +04:00
/**
2013-10-31 22:00:53 +04:00
* Creates an absolute url for public use
2012-12-25 21:17:32 +04:00
* @param string $service id
2013-10-31 22:00:53 +04:00
* @return string the url
* @since 4.5.0
* @deprecated 15.0.0 - use OCP\IURLGenerator
2012-08-27 23:46:05 +04:00
*/
public static function linkToPublic($service) {
$urlGenerator = \OC::$server->getURLGenerator();
if ($service === 'files') {
return $urlGenerator->getAbsoluteURL('/s');
}
return $urlGenerator->getAbsoluteURL($urlGenerator->linkTo('', 'public.php').'?service='.$service);
2012-08-27 23:46:05 +04:00
}
2012-12-19 04:09:14 +04:00
/**
* Returns the server host name without an eventual port number
2013-10-31 22:00:53 +04:00
* @return string the server hostname
* @since 5.0.0
2012-12-19 04:09:14 +04:00
*/
public static function getServerHostName() {
$host_name = \OC::$server->getRequest()->getServerHost();
2012-12-19 04:09:14 +04:00
// strip away port number (if existing)
$colon_pos = strpos($host_name, ':');
if ($colon_pos != false) {
2012-12-19 04:09:14 +04:00
$host_name = substr($host_name, 0, $colon_pos);
}
return $host_name;
}
/**
2013-10-31 22:00:53 +04:00
* Returns the default email address
2012-12-25 21:17:32 +04:00
* @param string $user_part the user part of the address
2013-10-31 22:00:53 +04:00
* @return string the default email address
2012-12-19 04:09:14 +04:00
*
* Assembles a default email address (using the server hostname
* and the given user part, and returns it
* Example: when given lostpassword-noreply as $user_part param,
* and is currently accessed via http(s)://example.com/,
* it would return 'lostpassword-noreply@example.com'
2014-01-24 17:22:42 +04:00
*
* If the configuration value 'mail_from_address' is set in
* config.php, this value will override the $user_part that
* is passed to this function
* @since 5.0.0
2012-12-19 04:09:14 +04:00
*/
public static function getDefaultEmailAddress($user_part) {
$config = \OC::$server->getConfig();
$user_part = $config->getSystemValue('mail_from_address', $user_part);
2012-12-19 04:09:14 +04:00
$host_name = self::getServerHostName();
$host_name = $config->getSystemValue('mail_domain', $host_name);
$defaultEmailAddress = $user_part.'@'.$host_name;
2015-02-19 20:55:27 +03:00
$mailer = \OC::$server->getMailer();
if ($mailer->validateMailAddress($defaultEmailAddress)) {
return $defaultEmailAddress;
2012-12-19 04:09:14 +04:00
}
// in case we cannot build a valid email address from the hostname let's fallback to 'localhost.localdomain'
return $user_part.'@localhost.localdomain';
2012-12-19 04:09:14 +04:00
}
2012-05-02 02:20:45 +04:00
/**
2013-10-31 22:00:53 +04:00
* Make a human file size (2048 to 2 kB)
2012-12-25 21:17:32 +04:00
* @param int $bytes file size in bytes
2013-10-31 22:00:53 +04:00
* @return string a human readable file size
* @since 4.0.0
2012-05-02 02:20:45 +04:00
*/
public static function humanFileSize($bytes) {
return \OC_Helper::humanFileSize($bytes);
2012-05-02 02:20:45 +04:00
}
/**
2013-10-31 22:00:53 +04:00
* Make a computer file size (2 kB to 2048)
2012-12-25 21:17:32 +04:00
* @param string $str file size in a fancy format
* @return float a file size in bytes
2012-05-02 02:20:45 +04:00
*
* Inspired by: https://www.php.net/manual/en/function.filesize.php#92418
* @since 4.0.0
2012-05-02 02:20:45 +04:00
*/
public static function computerFileSize($str) {
return \OC_Helper::computerFileSize($str);
2012-05-02 02:20:45 +04:00
}
/**
2013-10-31 22:00:53 +04:00
* connects a function to a hook
2015-04-02 18:53:40 +03:00
*
* @param string $signalClass class name of emitter
* @param string $signalName name of signal
* @param string|object $slotClass class name of slot
* @param string $slotName name of slot
2013-10-31 22:00:53 +04:00
* @return bool
*
* This function makes it very easy to connect to use hooks.
*
* TODO: write example
* @since 4.0.0
* @deprecated 21.0.0 use \OCP\EventDispatcher\IEventDispatcher::addListener
*/
public static function connectHook($signalClass, $signalName, $slotClass, $slotName) {
return \OC_Hook::connect($signalClass, $signalName, $slotClass, $slotName);
}
2012-05-02 02:20:45 +04:00
/**
2013-10-31 22:00:53 +04:00
* Emits a signal. To get data from the slot use references!
2012-12-25 21:17:32 +04:00
* @param string $signalclass class name of emitter
* @param string $signalname name of signal
2014-04-21 17:44:54 +04:00
* @param array $params default: array() array with additional data
2013-10-31 22:00:53 +04:00
* @return bool true if slots exists or false if not
*
* TODO: write example
* @since 4.0.0
* @deprecated 21.0.0 use \OCP\EventDispatcher\IEventDispatcher::dispatchTypedEvent
*/
public static function emitHook($signalclass, $signalname, $params = []) {
return \OC_Hook::emit($signalclass, $signalname, $params);
}
2012-05-02 00:59:38 +04:00
/**
* Cached encrypted CSRF token. Some static unit-tests of ownCloud compare
* multiple OC_Template elements which invoke `callRegister`. If the value
* would not be cached these unit-tests would fail.
* @var string
*/
private static $token = '';
/**
2012-08-29 22:34:44 +04:00
* Register an get/post call. This is important to prevent CSRF attacks
* @since 4.5.0
*/
2012-09-07 17:22:01 +04:00
public static function callRegister() {
if (self::$token === '') {
self::$token = \OC::$server->getCsrfTokenManager()->getToken()->getEncryptedValue();
}
return self::$token;
}
/**
2013-10-31 22:00:53 +04:00
* Used to sanitize HTML
*
2013-02-11 20:44:02 +04:00
* This function is used to sanitize HTML and should be applied on any
* string or array of strings before displaying it on a web page.
*
* @param string|array $value
* @return string|array an array of sanitized strings or a single sanitized string, depends on the input parameter.
* @since 4.5.0
*/
public static function sanitizeHTML($value) {
return \OC_Util::sanitizeHTML($value);
}
2013-10-31 22:00:53 +04:00
2013-07-04 20:21:49 +04:00
/**
2013-10-31 22:00:53 +04:00
* Public function to encode url parameters
2013-07-04 20:21:49 +04:00
*
* This function is used to encode path to file before output.
* Encoding is done according to RFC 3986 with one exception:
2013-10-31 22:00:53 +04:00
* Character '/' is preserved as is.
2013-07-04 20:21:49 +04:00
*
* @param string $component part of URI to encode
2013-10-31 22:00:53 +04:00
* @return string
* @since 6.0.0
2013-07-04 20:21:49 +04:00
*/
public static function encodePath($component) {
return \OC_Util::encodePath($component);
2013-07-04 20:21:49 +04:00
}
/**
2013-10-31 22:00:53 +04:00
* Returns an array with all keys from input lowercased or uppercased. Numbered indices are left as is.
*
* @param array $input The array to work on
* @param int $case Either MB_CASE_UPPER or MB_CASE_LOWER (default)
* @param string $encoding The encoding parameter is the character encoding. Defaults to UTF-8
* @return array
* @since 4.5.0
2013-10-31 22:00:53 +04:00
*/
2012-09-07 17:22:01 +04:00
public static function mb_array_change_key_case($input, $case = MB_CASE_LOWER, $encoding = 'UTF-8') {
return \OC_Helper::mb_array_change_key_case($input, $case, $encoding);
}
/**
2013-10-31 22:00:53 +04:00
* performs a search in a nested array
*
* @param array $haystack the array to be searched
* @param string $needle the search string
* @param mixed $index optional, only search this key name
2013-10-31 22:00:53 +04:00
* @return mixed the key of the matching field, otherwise false
* @since 4.5.0
* @deprecated 15.0.0
2013-10-31 22:00:53 +04:00
*/
public static function recursiveArraySearch($haystack, $needle, $index = null) {
return \OC_Helper::recursiveArraySearch($haystack, $needle, $index);
}
2013-01-18 23:09:03 +04:00
/**
2013-10-31 22:00:53 +04:00
* calculates the maximum upload size respecting system settings, free space and user quota
2013-01-18 23:09:03 +04:00
*
* @param string $dir the current folder where the user currently operates
* @param int $free the number of bytes free on the storage holding $dir, if not set this will be received from the storage directly
* @return int number of bytes representing
* @since 5.0.0
2013-01-18 23:09:03 +04:00
*/
public static function maxUploadFilesize($dir, $free = null) {
return \OC_Helper::maxUploadFilesize($dir, $free);
2013-01-18 23:09:03 +04:00
}
/**
* Calculate free space left within user quota
2014-04-21 17:44:54 +04:00
* @param string $dir the current folder where the user currently operates
* @return int number of bytes representing
* @since 7.0.0
*/
public static function freeSpace($dir) {
return \OC_Helper::freeSpace($dir);
}
/**
* Calculate PHP upload limit
*
* @return int number of bytes representing
* @since 7.0.0
*/
public static function uploadLimit() {
return \OC_Helper::uploadLimit();
}
/**
* Returns whether the given file name is valid
* @param string $file file name to check
* @return bool true if the file name is valid, false otherwise
2015-04-19 02:04:59 +03:00
* @deprecated 8.1.0 use \OC\Files\View::verifyPath()
* @since 7.0.0
* @suppress PhanDeprecatedFunction
*/
public static function isValidFileName($file) {
return \OC_Util::isValidFileName($file);
}
/**
* Compare two strings to provide a natural sort
* @param string $a first string to compare
* @param string $b second string to compare
* @return int -1 if $b comes before $a, 1 if $a comes before $b
* or 0 if the strings are identical
* @since 7.0.0
*/
public static function naturalSortCompare($a, $b) {
return \OC\NaturalSort::getInstance()->compare($a, $b);
}
/**
* check if a password is required for each public link
* @return boolean
* @since 7.0.0
*/
public static function isPublicLinkPasswordRequired() {
return \OC_Util::isPublicLinkPasswordRequired();
}
/**
* check if share API enforces a default expire date
* @return boolean
* @since 8.0.0
*/
public static function isDefaultExpireDateEnforced() {
return \OC_Util::isDefaultExpireDateEnforced();
}
protected static $needUpgradeCache = null;
/**
* Checks whether the current version needs upgrade.
*
* @return bool true if upgrade is needed, false otherwise
* @since 7.0.0
*/
public static function needUpgrade() {
if (!isset(self::$needUpgradeCache)) {
self::$needUpgradeCache = \OC_Util::needUpgrade(\OC::$server->getSystemConfig());
}
return self::$needUpgradeCache;
}
/**
* is this Internet explorer ?
*
* @return boolean
* @since 14.0.0
*/
public static function isIe() {
return \OC_Util::isIe();
}
2012-05-01 23:07:08 +04:00
}