server/lib/private/server.php

1019 lines
27 KiB
PHP
Raw Normal View History

2013-08-20 22:58:15 +00:00
<?php
2015-03-26 10:44:34 +00:00
/**
2015-06-25 09:43:55 +00:00
* @author Arthur Schiwon <blizzz@owncloud.com>
2015-03-26 10:44:34 +00:00
* @author Bart Visscher <bartv@thisnet.nl>
* @author Bernhard Posselt <dev@bernhard-posselt.com>
* @author Bernhard Reiter <ockham@raz.or.at>
* @author Björn Schießle <schiessle@owncloud.com>
* @author Christopher Schäpers <kondou@ts.unde.re>
* @author Joas Schilling <nickvergessen@owncloud.com>
* @author Jörn Friedrich Dreyer <jfd@butonic.de>
* @author Lukas Reschke <lukas@owncloud.com>
* @author Morris Jobke <hey@morrisjobke.de>
* @author Robin Appelman <icewind@owncloud.com>
* @author Robin McCorkell <rmccorkell@karoshi.org.uk>
* @author Roeland Jago Douma <roeland@famdouma.nl>
2015-03-26 10:44:34 +00:00
* @author Sander <brantje@gmail.com>
* @author Thomas Müller <thomas.mueller@tmit.eu>
* @author Thomas Tanghus <thomas@tanghus.net>
* @author Vincent Petry <pvince81@owncloud.com>
*
* @copyright Copyright (c) 2015, ownCloud, Inc.
* @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-08-20 22:58:15 +00:00
namespace OC;
2014-12-05 18:56:29 +00:00
use bantu\IniGetWrapper\IniGetWrapper;
2013-09-04 21:45:11 +00:00
use OC\AppFramework\Http\Request;
2014-04-19 17:30:12 +00:00
use OC\AppFramework\Db\Db;
use OC\AppFramework\Utility\SimpleContainer;
use OC\AppFramework\Utility\TimeFactory;
use OC\Command\AsyncBus;
2014-10-03 18:39:09 +00:00
use OC\Diagnostics\EventLogger;
2015-06-11 09:29:27 +00:00
use OC\Diagnostics\NullEventLogger;
use OC\Diagnostics\NullQueryLogger;
2014-10-03 18:39:09 +00:00
use OC\Diagnostics\QueryLogger;
2015-06-11 09:29:27 +00:00
use OC\Files\Node\Root;
use OC\Files\View;
use OC\Http\Client\ClientService;
use OC\Lock\MemcacheLockingProvider;
2015-05-21 14:11:10 +00:00
use OC\Lock\NoopLockingProvider;
use OC\Mail\Mailer;
2014-08-18 14:30:23 +00:00
use OC\Security\CertificateManager;
use OC\Security\Crypto;
use OC\Security\Hasher;
use OC\Security\SecureRandom;
2015-02-16 21:12:47 +00:00
use OC\Security\TrustedDomainHelper;
use OC\Session\CryptoWrapper;
use OC\Tagging\TagMapper;
2015-06-11 09:29:27 +00:00
use OCP\IServerContainer;
use Symfony\Component\EventDispatcher\EventDispatcher;
use Symfony\Component\EventDispatcher\EventDispatcherInterface;
2013-08-20 22:58:15 +00:00
/**
* Class Server
2014-07-16 12:25:31 +00:00
*
2013-08-20 22:58:15 +00:00
* @package OC
*
* TODO: hookup all manager classes
*/
class Server extends SimpleContainer implements IServerContainer {
2014-11-27 13:50:14 +00:00
/** @var string */
private $webRoot;
/**
* @param string $webRoot
*/
public function __construct($webRoot) {
parent::__construct();
2014-11-27 13:50:14 +00:00
$this->webRoot = $webRoot;
2014-07-16 12:25:31 +00:00
$this->registerService('ContactsManager', function ($c) {
return new ContactsManager();
});
2015-03-12 11:08:31 +00:00
$this->registerService('PreviewManager', function (Server $c) {
return new PreviewManager($c->getConfig());
2013-09-04 21:45:11 +00:00
});
$this->registerService('EncryptionManager', function (Server $c) {
return new Encryption\Manager($c->getConfig(), $c->getLogger(), $c->getL10N('core'));
});
$this->registerService('EncryptionFileHelper', function (Server $c) {
$util = new \OC\Encryption\Util(
new \OC\Files\View(),
$c->getUserManager(),
$c->getGroupManager(),
$c->getConfig()
);
return new Encryption\File($util);
});
$this->registerService('EncryptionKeyStorage', function (Server $c) {
$view = new \OC\Files\View();
$util = new \OC\Encryption\Util(
$view,
$c->getUserManager(),
$c->getGroupManager(),
$c->getConfig()
);
return new Encryption\Keys\Storage($view, $util);
});
$this->registerService('TagMapper', function(Server $c) {
return new TagMapper($c->getDatabaseConnection());
});
$this->registerService('TagManager', function (Server $c) {
$tagMapper = $c->query('TagMapper');
2014-12-10 14:59:41 +00:00
return new TagManager($tagMapper, $c->getUserSession());
});
$this->registerService('RootFolder', function (Server $c) {
// TODO: get user and user manager from container as well
$user = \OC_User::getUser();
/** @var $c SimpleContainer */
$userManager = $c->query('UserManager');
$user = $userManager->get($user);
$manager = \OC\Files\Filesystem::getMountManager();
$view = new View();
return new Root($manager, $view, $user);
});
$this->registerService('UserManager', function (Server $c) {
$config = $c->getConfig();
return new \OC\User\Manager($config);
2013-09-20 10:45:56 +00:00
});
$this->registerService('GroupManager', function (Server $c) {
$groupManager = new \OC\Group\Manager($this->getUserManager());
$groupManager->listen('\OC\Group', 'preCreate', function ($gid) {
\OC_Hook::emit('OC_Group', 'pre_createGroup', array('run' => true, 'gid' => $gid));
});
$groupManager->listen('\OC\Group', 'postCreate', function (\OC\Group\Group $gid) {
\OC_Hook::emit('OC_User', 'post_createGroup', array('gid' => $gid->getGID()));
});
$groupManager->listen('\OC\Group', 'preDelete', function (\OC\Group\Group $group) {
\OC_Hook::emit('OC_Group', 'pre_deleteGroup', array('run' => true, 'gid' => $group->getGID()));
});
$groupManager->listen('\OC\Group', 'postDelete', function (\OC\Group\Group $group) {
\OC_Hook::emit('OC_User', 'post_deleteGroup', array('gid' => $group->getGID()));
});
$groupManager->listen('\OC\Group', 'preAddUser', function (\OC\Group\Group $group, \OC\User\User $user) {
\OC_Hook::emit('OC_Group', 'pre_addToGroup', array('run' => true, 'uid' => $user->getUID(), 'gid' => $group->getGID()));
});
$groupManager->listen('\OC\Group', 'postAddUser', function (\OC\Group\Group $group, \OC\User\User $user) {
\OC_Hook::emit('OC_Group', 'post_addToGroup', array('uid' => $user->getUID(), 'gid' => $group->getGID()));
//Minimal fix to keep it backward compatible TODO: clean up all the GroupManager hooks
\OC_Hook::emit('OC_User', 'post_addToGroup', array('uid' => $user->getUID(), 'gid' => $group->getGID()));
});
return $groupManager;
2014-07-16 12:25:31 +00:00
});
$this->registerService('UserSession', function (Server $c) {
$manager = $c->getUserManager();
$session = new \OC\Session\Memory('');
$cryptoWrapper = $c->getSessionCryptoWrapper();
$session = $cryptoWrapper->wrapSession($session);
$userSession = new \OC\User\Session($manager, $session);
2013-09-20 10:45:56 +00:00
$userSession->listen('\OC\User', 'preCreateUser', function ($uid, $password) {
\OC_Hook::emit('OC_User', 'pre_createUser', array('run' => true, 'uid' => $uid, 'password' => $password));
});
$userSession->listen('\OC\User', 'postCreateUser', function ($user, $password) {
/** @var $user \OC\User\User */
\OC_Hook::emit('OC_User', 'post_createUser', array('uid' => $user->getUID(), 'password' => $password));
});
$userSession->listen('\OC\User', 'preDelete', function ($user) {
/** @var $user \OC\User\User */
\OC_Hook::emit('OC_User', 'pre_deleteUser', array('run' => true, 'uid' => $user->getUID()));
});
$userSession->listen('\OC\User', 'postDelete', function ($user) {
/** @var $user \OC\User\User */
\OC_Hook::emit('OC_User', 'post_deleteUser', array('uid' => $user->getUID()));
});
$userSession->listen('\OC\User', 'preSetPassword', function ($user, $password, $recoveryPassword) {
/** @var $user \OC\User\User */
\OC_Hook::emit('OC_User', 'pre_setPassword', array('run' => true, 'uid' => $user->getUID(), 'password' => $password, 'recoveryPassword' => $recoveryPassword));
});
$userSession->listen('\OC\User', 'postSetPassword', function ($user, $password, $recoveryPassword) {
/** @var $user \OC\User\User */
\OC_Hook::emit('OC_User', 'post_setPassword', array('run' => true, 'uid' => $user->getUID(), 'password' => $password, 'recoveryPassword' => $recoveryPassword));
});
$userSession->listen('\OC\User', 'preLogin', function ($uid, $password) {
\OC_Hook::emit('OC_User', 'pre_login', array('run' => true, 'uid' => $uid, 'password' => $password));
});
$userSession->listen('\OC\User', 'postLogin', function ($user, $password) {
/** @var $user \OC\User\User */
\OC_Hook::emit('OC_User', 'post_login', array('run' => true, 'uid' => $user->getUID(), 'password' => $password));
});
$userSession->listen('\OC\User', 'logout', function () {
\OC_Hook::emit('OC_User', 'logout', array());
});
return $userSession;
});
2014-07-16 12:25:31 +00:00
$this->registerService('NavigationManager', function ($c) {
return new \OC\NavigationManager();
});
$this->registerService('AllConfig', function (Server $c) {
return new \OC\AllConfig(
$c->getSystemConfig()
);
});
$this->registerService('SystemConfig', function ($c) {
return new \OC\SystemConfig();
});
$this->registerService('AppConfig', function ($c) {
return new \OC\AppConfig(\OC_DB::getConnection());
});
2014-07-16 12:25:31 +00:00
$this->registerService('L10NFactory', function ($c) {
2013-09-25 16:34:01 +00:00
return new \OC\L10N\Factory();
});
$this->registerService('URLGenerator', function (Server $c) {
$config = $c->getConfig();
$cacheFactory = $c->getMemCacheFactory();
return new \OC\URLGenerator(
$config,
$cacheFactory
);
});
2014-07-16 12:25:31 +00:00
$this->registerService('AppHelper', function ($c) {
return new \OC\AppHelper();
});
$this->registerService('UserCache', function ($c) {
return new Cache\File();
});
$this->registerService('MemCacheFactory', function (Server $c) {
$config = $c->getConfig();
2015-05-04 13:08:32 +00:00
if($config->getSystemValue('installed', false) && !(defined('PHPUNIT_RUN') && PHPUNIT_RUN)) {
$v = \OC_App::getAppVersions();
$v['core'] = implode('.', \OC_Util::getVersion());
$version = implode(',', $v);
$instanceId = \OC_Util::getInstanceId();
$path = \OC::$SERVERROOT;
$prefix = md5($instanceId.'-'.$version.'-'.$path);
return new \OC\Memcache\Factory($prefix, $c->getLogger(),
$config->getSystemValue('memcache.local', null),
$config->getSystemValue('memcache.distributed', null),
$config->getSystemValue('memcache.locking', null)
);
}
return new \OC\Memcache\Factory('', $c->getLogger(),
'\\OC\\Memcache\\ArrayCache',
'\\OC\\Memcache\\ArrayCache',
'\\OC\\Memcache\\ArrayCache'
);
2014-01-06 11:55:56 +00:00
});
$this->registerService('ActivityManager', function (Server $c) {
return new ActivityManager(
$c->getRequest(),
$c->getUserSession(),
$c->getConfig()
);
});
2014-07-16 12:25:31 +00:00
$this->registerService('AvatarManager', function ($c) {
2013-11-22 11:34:37 +00:00
return new AvatarManager();
2013-09-20 09:46:11 +00:00
});
$this->registerService('Logger', function (Server $c) {
$logClass = $c->query('AllConfig')->getSystemValue('log_type', 'owncloud');
$logger = 'OC_Log_' . ucfirst($logClass);
call_user_func(array($logger, 'init'));
return new Log($logger);
});
$this->registerService('JobList', function (Server $c) {
$config = $c->getConfig();
return new \OC\BackgroundJob\JobList($c->getDatabaseConnection(), $config);
});
$this->registerService('Router', function (Server $c) {
$cacheFactory = $c->getMemCacheFactory();
if ($cacheFactory->isAvailable()) {
$router = new \OC\Route\CachingRouter($cacheFactory->create('route'));
} else {
$router = new \OC\Route\Router();
}
return $router;
});
2014-07-16 12:25:31 +00:00
$this->registerService('Search', function ($c) {
return new Search();
});
$this->registerService('SecureRandom', function ($c) {
return new SecureRandom();
});
$this->registerService('Crypto', function (Server $c) {
return new Crypto($c->getConfig(), $c->getSecureRandom());
});
$this->registerService('Hasher', function (Server $c) {
return new Hasher($c->getConfig());
});
$this->registerService('DatabaseConnection', function (Server $c) {
$factory = new \OC\DB\ConnectionFactory();
$systemConfig = $c->getSystemConfig();
$type = $systemConfig->getValue('dbtype', 'sqlite');
if (!$factory->isValidType($type)) {
throw new \OC\DatabaseException('Invalid database type');
}
$connectionParams = $factory->createConnectionParams($systemConfig);
$connection = $factory->getConnection($type, $connectionParams);
$connection->getConfiguration()->setSQLLogger($c->getQueryLogger());
return $connection;
});
$this->registerService('Db', function (Server $c) {
return new Db($c->getDatabaseConnection());
2014-04-19 17:30:12 +00:00
});
$this->registerService('HTTPHelper', function (Server $c) {
$config = $c->getConfig();
2015-03-16 10:28:23 +00:00
return new HTTPHelper(
$config,
$c->getHTTPClientService()
);
});
$this->registerService('HttpClientService', function (Server $c) {
$user = \OC_User::getUser();
$uid = $user ? $user : null;
return new ClientService(
$c->getConfig(),
new \OC\Security\CertificateManager($uid, new \OC\Files\View())
);
});
$this->registerService('EventLogger', function (Server $c) {
if (defined('DEBUG') and DEBUG) {
return new EventLogger();
} else {
2014-10-14 13:49:00 +00:00
return new NullEventLogger();
}
});
$this->registerService('QueryLogger', function ($c) {
if (defined('DEBUG') and DEBUG) {
return new QueryLogger();
} else {
2014-10-14 13:49:00 +00:00
return new NullQueryLogger();
}
});
2014-11-27 13:50:14 +00:00
$this->registerService('TempManager', function (Server $c) {
return new TempManager(get_temp_dir(), $c->getLogger());
});
$this->registerService('AppManager', function(Server $c) {
return new \OC\App\AppManager(
$c->getUserSession(),
$c->getAppConfig(),
$c->getGroupManager(),
$c->getMemCacheFactory()
);
});
2014-12-16 14:34:55 +00:00
$this->registerService('DateTimeZone', function(Server $c) {
return new DateTimeZone(
$c->getConfig(),
$c->getSession()
);
});
$this->registerService('DateTimeFormatter', function(Server $c) {
$language = $c->getConfig()->getUserValue($c->getSession()->get('user_id'), 'core', 'lang', null);
2014-12-16 14:34:55 +00:00
return new DateTimeFormatter(
$c->getDateTimeZone()->getTimeZone(),
$c->getL10N('lib', $language)
);
});
$this->registerService('MountConfigManager', function () {
$loader = \OC\Files\Filesystem::getLoader();
return new \OC\Files\Config\MountProviderCollection($loader);
});
2014-12-05 18:56:29 +00:00
$this->registerService('IniWrapper', function ($c) {
return new IniGetWrapper();
2014-12-05 18:56:29 +00:00
});
$this->registerService('AsyncCommandBus', function (Server $c) {
$jobList = $c->getJobList();
return new AsyncBus($jobList);
});
2015-02-16 21:12:47 +00:00
$this->registerService('TrustedDomainHelper', function ($c) {
return new TrustedDomainHelper($this->getConfig());
});
$this->registerService('Request', function ($c) {
if (isset($this['urlParams'])) {
$urlParams = $this['urlParams'];
} else {
$urlParams = [];
}
if ($this->getSession()->exists('requesttoken')) {
$requestToken = $this->getSession()->get('requesttoken');
} else {
$requestToken = false;
}
if (defined('PHPUNIT_RUN') && PHPUNIT_RUN
&& in_array('fakeinput', stream_get_wrappers())
) {
$stream = 'fakeinput://data';
} else {
$stream = 'php://input';
}
return new Request(
[
'get' => $_GET,
'post' => $_POST,
'files' => $_FILES,
'server' => $_SERVER,
'env' => $_ENV,
'cookies' => $_COOKIE,
'method' => (isset($_SERVER) && isset($_SERVER['REQUEST_METHOD']))
? $_SERVER['REQUEST_METHOD']
: null,
'urlParams' => $urlParams,
'requesttoken' => $requestToken,
],
$this->getSecureRandom(),
$this->getConfig(),
$stream
);
});
$this->registerService('Mailer', function(Server $c) {
2015-03-16 12:01:17 +00:00
return new Mailer(
$c->getConfig(),
$c->getLogger(),
new \OC_Defaults()
);
});
$this->registerService('OcsClient', function(Server $c) {
return new OCSClient(
$this->getHTTPClientService(),
$this->getConfig(),
$this->getLogger()
);
});
$this->registerService('LockingProvider', function (Server $c) {
2015-05-22 11:52:42 +00:00
if ($c->getConfig()->getSystemValue('filelocking.enabled', false) or (defined('PHPUNIT_RUN') && PHPUNIT_RUN)) {
2015-05-21 14:11:10 +00:00
/** @var \OC\Memcache\Factory $memcacheFactory */
$memcacheFactory = $c->getMemCacheFactory();
$memcache = $memcacheFactory->createLocking('lock');
2015-06-10 22:44:13 +00:00
if (!($memcache instanceof \OC\Memcache\NullCache)) {
2015-05-21 14:11:10 +00:00
return new MemcacheLockingProvider($memcache);
}
throw new HintException(
'File locking is enabled but the locking cache class was not found',
'Please check the "memcache.locking" setting and make sure the matching PHP module is installed and enabled'
);
2015-05-21 14:11:10 +00:00
}
return new NoopLockingProvider();
});
$this->registerService('MountManager', function () {
return new \OC\Files\Mount\Manager();
});
$this->registerService('MimeTypeDetector', function(Server $c) {
return new \OC\Files\Type\Detection(
$c->getURLGenerator(),
\OC::$configDir);
});
2015-07-21 19:44:59 +00:00
$this->registerService('CapabilitiesManager', function (Server $c) {
$manager = new \OC\CapabilitiesManager();
$manager->registerCapability(function() use ($c) {
return new \OC\OCS\CoreCapabilities($c->getConfig());
2015-07-21 19:44:59 +00:00
});
return $manager;
});
$this->registerService('EventDispatcher', function() {
return new EventDispatcher();
});
$this->registerService('CryptoWrapper', function (Server $c) {
// FIXME: Instantiiated here due to cyclic dependency
$request = new Request(
[
'get' => $_GET,
'post' => $_POST,
'files' => $_FILES,
'server' => $_SERVER,
'env' => $_ENV,
'cookies' => $_COOKIE,
'method' => (isset($_SERVER) && isset($_SERVER['REQUEST_METHOD']))
? $_SERVER['REQUEST_METHOD']
: null,
],
new SecureRandom(),
$c->getConfig()
);
return new CryptoWrapper(
$c->getConfig(),
$c->getCrypto(),
$c->getSecureRandom(),
$request
);
});
}
/**
* @return \OCP\Contacts\IManager
*/
public function getContactsManager() {
return $this->query('ContactsManager');
}
/**
* @return \OC\Encryption\Manager
*/
public function getEncryptionManager() {
return $this->query('EncryptionManager');
}
/**
* @return \OC\Encryption\File
*/
public function getEncryptionFilesHelper() {
return $this->query('EncryptionFileHelper');
}
/**
* @return \OCP\Encryption\Keys\IStorage
*/
public function getEncryptionKeyStorage() {
return $this->query('EncryptionKeyStorage');
}
/**
* The current request object holding all information about the request
* currently being processed is returned from this method.
* In case the current execution was not initiated by a web request null is returned
*
2015-04-01 10:13:49 +00:00
* @return \OCP\IRequest
*/
public function getRequest() {
return $this->query('Request');
}
2013-09-04 21:45:11 +00:00
/**
* Returns the preview manager which can create preview images for a given file
*
* @return \OCP\IPreview
*/
public function getPreviewManager() {
2013-09-04 21:45:11 +00:00
return $this->query('PreviewManager');
}
/**
* Returns the tag manager which can get and set tags for different object types
*
* @see \OCP\ITagManager::load()
* @return \OCP\ITagManager
*/
public function getTagManager() {
return $this->query('TagManager');
}
2013-09-20 09:46:11 +00:00
/**
* Returns the avatar manager, used for avatar functionality
*
2013-11-22 11:34:37 +00:00
* @return \OCP\IAvatarManager
2013-09-20 09:46:11 +00:00
*/
public function getAvatarManager() {
2013-09-20 09:46:11 +00:00
return $this->query('AvatarManager');
}
/**
* Returns the root folder of ownCloud's data directory
*
* @return \OCP\Files\IRootFolder
*/
public function getRootFolder() {
return $this->query('RootFolder');
}
2013-09-18 12:25:12 +00:00
/**
* Returns a view to ownCloud's files folder
*
* @param string $userId user ID
2013-09-18 12:25:12 +00:00
* @return \OCP\Files\Folder
*/
public function getUserFolder($userId = null) {
if ($userId === null) {
$user = $this->getUserSession()->getUser();
if (!$user) {
return null;
}
$userId = $user->getUID();
}
2013-09-18 12:25:12 +00:00
$root = $this->getRootFolder();
return $root->getUserFolder($userId);
2013-09-18 12:25:12 +00:00
}
/**
* Returns an app-specific view in ownClouds data directory
*
* @return \OCP\Files\Folder
*/
public function getAppFolder() {
2014-07-22 17:45:01 +00:00
$dir = '/' . \OC_App::getCurrentApp();
2013-09-18 12:25:12 +00:00
$root = $this->getRootFolder();
$folder = null;
2014-07-16 12:25:31 +00:00
if (!$root->nodeExists($dir)) {
2013-09-18 12:25:12 +00:00
$folder = $root->newFolder($dir);
} else {
$folder = $root->get($dir);
}
return $folder;
}
2013-09-20 10:45:56 +00:00
/**
* @return \OC\User\Manager
*/
public function getUserManager() {
2013-09-20 10:45:56 +00:00
return $this->query('UserManager');
}
2014-07-16 12:25:31 +00:00
/**
* @return \OC\Group\Manager
*/
public function getGroupManager() {
2014-07-16 12:25:31 +00:00
return $this->query('GroupManager');
}
2013-09-20 10:45:56 +00:00
/**
* @return \OC\User\Session
*/
public function getUserSession() {
2013-09-20 10:45:56 +00:00
return $this->query('UserSession');
}
/**
* @return \OCP\ISession
*/
public function getSession() {
return $this->query('UserSession')->getSession();
}
/**
* @param \OCP\ISession $session
*/
public function setSession(\OCP\ISession $session) {
return $this->query('UserSession')->setSession($session);
}
/**
* @return \OC\NavigationManager
*/
public function getNavigationManager() {
return $this->query('NavigationManager');
}
/**
* @return \OCP\IConfig
*/
public function getConfig() {
return $this->query('AllConfig');
}
/**
* For internal use only
*
* @return \OC\SystemConfig
*/
public function getSystemConfig() {
return $this->query('SystemConfig');
}
/**
* Returns the app config manager
*
* @return \OCP\IAppConfig
*/
public function getAppConfig() {
return $this->query('AppConfig');
}
2013-09-25 16:34:01 +00:00
/**
* get an L10N instance
2014-07-16 12:25:31 +00:00
*
2014-02-28 20:03:43 +00:00
* @param string $app appid
2014-08-31 08:05:59 +00:00
* @param string $lang
2013-09-25 16:34:01 +00:00
* @return \OC_L10N
*/
public function getL10N($app, $lang = null) {
2014-08-31 08:05:59 +00:00
return $this->query('L10NFactory')->get($app, $lang);
2013-09-25 16:34:01 +00:00
}
/**
* @return \OCP\IURLGenerator
*/
public function getURLGenerator() {
return $this->query('URLGenerator');
}
/**
* @return \OCP\IHelper
*/
public function getHelper() {
return $this->query('AppHelper');
}
/**
* Returns an ICache instance. Since 8.1.0 it returns a fake cache. Use
* getMemCacheFactory() instead.
*
* @return \OCP\ICache
* @deprecated 8.1.0 use getMemCacheFactory to obtain a proper cache
*/
public function getCache() {
return $this->query('UserCache');
}
2014-01-06 11:55:56 +00:00
/**
2014-01-08 14:51:40 +00:00
* Returns an \OCP\CacheFactory instance
2014-01-06 11:55:56 +00:00
*
* @return \OCP\ICacheFactory
2014-01-06 11:55:56 +00:00
*/
public function getMemCacheFactory() {
return $this->query('MemCacheFactory');
2014-01-06 11:55:56 +00:00
}
/**
* Returns the current session
2013-09-20 12:33:45 +00:00
*
* @return \OCP\IDBConnection
*/
public function getDatabaseConnection() {
return $this->query('DatabaseConnection');
2013-09-20 12:33:45 +00:00
}
/**
* Returns the activity manager
*
* @return \OCP\Activity\IManager
*/
public function getActivityManager() {
return $this->query('ActivityManager');
2013-09-20 12:33:45 +00:00
}
/**
* Returns an job list for controlling background jobs
*
* @return \OCP\BackgroundJob\IJobList
*/
public function getJobList() {
return $this->query('JobList');
}
/**
* Returns a logger instance
*
* @return \OCP\ILogger
*/
public function getLogger() {
return $this->query('Logger');
}
/**
* Returns a router for generating and matching urls
*
* @return \OCP\Route\IRouter
*/
public function getRouter() {
return $this->query('Router');
}
2014-04-19 17:30:12 +00:00
/**
* Returns a search instance
2014-07-16 12:25:31 +00:00
*
* @return \OCP\ISearch
*/
public function getSearch() {
return $this->query('Search');
}
2014-04-19 17:30:12 +00:00
/**
* Returns a SecureRandom instance
*
* @return \OCP\Security\ISecureRandom
*/
public function getSecureRandom() {
return $this->query('SecureRandom');
}
/**
* Returns a Crypto instance
*
* @return \OCP\Security\ICrypto
*/
public function getCrypto() {
return $this->query('Crypto');
}
/**
* Returns a Hasher instance
*
* @return \OCP\Security\IHasher
*/
public function getHasher() {
return $this->query('Hasher');
}
2014-04-19 17:30:12 +00:00
/**
* Returns an instance of the db facade
2015-02-24 16:15:21 +00:00
* @deprecated use getDatabaseConnection, will be removed in ownCloud 10
2014-04-19 17:30:12 +00:00
* @return \OCP\IDb
*/
public function getDb() {
2014-04-19 17:30:12 +00:00
return $this->query('Db');
}
/**
* Returns an instance of the HTTP helper class
2015-03-16 10:28:23 +00:00
* @deprecated Use getHTTPClientService()
* @return \OC\HTTPHelper
*/
public function getHTTPHelper() {
return $this->query('HTTPHelper');
}
/**
* Get the certificate manager for the user
*
* @param string $userId (optional) if not specified the current loggedin user is used
2015-06-17 13:47:45 +00:00
* @return \OCP\ICertificateManager | null if $uid is null and no user is logged in
*/
public function getCertificateManager($userId = null) {
if (is_null($userId)) {
$userSession = $this->getUserSession();
$user = $userSession->getUser();
if (is_null($user)) {
return null;
}
$userId = $user->getUID();
}
return new CertificateManager($userId, new \OC\Files\View());
}
2014-08-29 15:19:38 +00:00
2015-03-16 10:28:23 +00:00
/**
* Returns an instance of the HTTP client service
*
* @return \OCP\Http\Client\IClientService
*/
public function getHTTPClientService() {
2015-03-16 10:28:23 +00:00
return $this->query('HttpClientService');
}
2014-08-29 15:19:38 +00:00
/**
2014-09-03 23:10:02 +00:00
* Create a new event source
2014-08-29 15:19:38 +00:00
*
* @return \OCP\IEventSource
*/
public function createEventSource() {
2014-08-29 15:19:38 +00:00
return new \OC_EventSource();
}
/**
* Get the active event logger
*
* The returned logger only logs data when debug mode is enabled
*
2014-10-03 18:39:09 +00:00
* @return \OCP\Diagnostics\IEventLogger
*/
public function getEventLogger() {
return $this->query('EventLogger');
}
/**
* Get the active query logger
*
* The returned logger only logs data when debug mode is enabled
*
2014-10-03 18:39:09 +00:00
* @return \OCP\Diagnostics\IQueryLogger
*/
public function getQueryLogger() {
2014-10-03 18:39:09 +00:00
return $this->query('QueryLogger');
}
/**
* Get the manager for temporary files and folders
*
* @return \OCP\ITempManager
*/
public function getTempManager() {
return $this->query('TempManager');
}
/**
* Get the app manager
*
* @return \OCP\App\IAppManager
*/
public function getAppManager() {
return $this->query('AppManager');
}
2014-11-27 13:36:11 +00:00
/**
* Creates a new mailer
*
* @return \OCP\Mail\IMailer
*/
public function getMailer() {
return $this->query('Mailer');
}
2014-11-27 13:36:11 +00:00
/**
* Get the webroot
*
* @return string
*/
public function getWebRoot() {
2014-11-27 13:50:14 +00:00
return $this->webRoot;
2014-11-27 13:36:11 +00:00
}
/**
* @return \OC\OCSClient
*/
public function getOcsClient() {
return $this->query('OcsClient');
}
/**
2014-12-16 14:34:55 +00:00
* @return \OCP\IDateTimeZone
*/
2014-12-16 14:34:55 +00:00
public function getDateTimeZone() {
return $this->query('DateTimeZone');
}
/**
* @return \OCP\IDateTimeFormatter
*/
public function getDateTimeFormatter() {
return $this->query('DateTimeFormatter');
}
/**
* @return \OCP\Files\Config\IMountProviderCollection
*/
public function getMountProviderCollection(){
return $this->query('MountConfigManager');
}
2014-12-05 18:56:29 +00:00
/**
* Get the IniWrapper
*
* @return IniGetWrapper
2014-12-05 18:56:29 +00:00
*/
public function getIniWrapper() {
return $this->query('IniWrapper');
2014-12-05 18:56:29 +00:00
}
2015-02-16 21:12:47 +00:00
/**
* @return \OCP\Command\IBus
*/
public function getCommandBus(){
return $this->query('AsyncCommandBus');
}
2015-02-16 21:12:47 +00:00
/**
* Get the trusted domain helper
*
* @return TrustedDomainHelper
*/
public function getTrustedDomainHelper() {
return $this->query('TrustedDomainHelper');
}
/**
* Get the locking provider
*
* @return \OCP\Lock\ILockingProvider
* @since 8.1.0
*/
public function getLockingProvider() {
return $this->query('LockingProvider');
}
/**
* @return \OCP\Files\Mount\IMountManager
**/
function getMountManager() {
return $this->query('MountManager');
}
/*
* Get the MimeTypeDetector
*
* @return \OCP\Files\IMimeTypeDetector
*/
public function getMimeTypeDetector() {
return $this->query('MimeTypeDetector');
}
/**
* Get the manager of all the capabilities
*
* @return \OC\CapabilitiesManager
*/
public function getCapabilitiesManager() {
return $this->query('CapabilitiesManager');
}
/**
* Get the EventDispatcher
*
* @return EventDispatcherInterface
* @since 8.2.0
*/
public function getEventDispatcher() {
return $this->query('EventDispatcher');
}
/**
* @return \OC\Session\CryptoWrapper
*/
public function getSessionCryptoWrapper() {
return $this->query('CryptoWrapper');
}
2013-08-20 22:58:15 +00:00
}