aboutsummaryrefslogtreecommitdiffstats
path: root/lib/public/Server.php
diff options
context:
space:
mode:
Diffstat (limited to 'lib/public/Server.php')
-rw-r--r--lib/public/Server.php39
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);
+ }
+}