diff options
Diffstat (limited to 'lib/public/Server.php')
-rw-r--r-- | lib/public/Server.php | 39 |
1 files changed, 39 insertions, 0 deletions
diff --git a/lib/public/Server.php b/lib/public/Server.php new file mode 100644 index 00000000000..e30d67701f6 --- /dev/null +++ b/lib/public/Server.php @@ -0,0 +1,39 @@ +<?php + +declare(strict_types=1); +/** + * SPDX-FileCopyrightText: 2022 Nextcloud GmbH and Nextcloud contributors + * SPDX-License-Identifier: AGPL-3.0-or-later + */ +namespace OCP; + +use Psr\Container\ContainerExceptionInterface; +use Psr\Container\NotFoundExceptionInterface; + +/** + * Class allowing to inject services into your application. You should + * use whenever possible dependency injections instead. + * + * ```php + * use OCP\ITagManager; + * use OCP\Server; + * + * $tagManager = Server::get(ITagManager::class); + * ``` + * + * @since 25.0.0 + */ +final class Server { + /** + * @psalm-template T + * @psalm-param class-string<T>|string $serviceName + * @psalm-return ($serviceName is class-string<T> ? T : mixed) + * @throws ContainerExceptionInterface + * @throws NotFoundExceptionInterface + * @since 25.0.0 + */ + public static function get(string $serviceName) { + /** @psalm-suppress UndefinedClass */ + return \OC::$server->get($serviceName); + } +} |