Add alias function

README.md

@@ -93,4 +93,20 @@ redirect('site/index', [], ['page' => 2], Status::PERMANENT_REDIRECT); // => A r
 
 // Generating absolute url
 redirect('/path/to/redirect', [], ['page' => 2], Status::PERMANENT_REDIRECT, true); // => A response object with code 308 and header 'Location' with value 'http://localhost/path/to/redirect?page=2'
+```
+
+### `alias(string $path): string`
+
+- `$path` is an alias name
+
+```php
+alias('@runtime'); // => '/path/to/runtime'
+```
+
+### `aliases(string ...$paths): array`
+
+- `$paths` is alias names
+
+```php
+aliases('@runtime', '@webroot'); // => ['/path/to/runtime', '/path/to/webroot']
 ```

src/alias.php

@@ -0,0 +1,24 @@
+<?php
+
+declare(strict_types=1);
+
+use Yiisoft\Aliases\Aliases;
+
+
+function alias(string $path): string
+{
+    /**
+     * @var Aliases $aliases
+     */
+    $aliases = container(Aliases::class);
+    return $aliases->get($path);
+}
+
+function aliases(string ...$paths): array
+{
+    /**
+     * @var Aliases $aliases
+     */
+    $aliases = container(Aliases::class);
+    return $aliases->getArray($paths);
+}

tests/AliasTest.php

@@ -0,0 +1,45 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Xepozz\YiiShort\Tests;
+
+use Xepozz\YiiShort\State;
+use Yiisoft\Aliases\Aliases;
+use Yiisoft\Test\Support\Container\SimpleContainer;
+
+class AliasTest extends FunctionsTestCase
+{
+    public function testFunctionLoaded(): void
+    {
+        $this->assertTrue(function_exists('alias'));
+        $this->assertTrue(function_exists('aliases'));
+    }
+
+    public function testContainerIsUnset(): void
+    {
+        State::$container = null;
+
+        $this->expectException(\RuntimeException::class);
+        alias('test');
+    }
+
+    public function testAliases(): void
+    {
+        State::$container = new SimpleContainer([
+            Aliases::class => new Aliases([
+                '@test1' => '/root/test1',
+                '@test2' => '/root/test2',
+            ]),
+        ]);
+        $this->assertEquals('/root/test1', alias('@test1'));
+        $this->assertEquals('/root/test2', alias('@test2'));
+        $this->assertEquals(['/root/test1', '/root/test2'], aliases('@test1', '@test2'));
+    }
+
+    public function bootstrapFiles(): iterable
+    {
+        yield __DIR__ . '/../src/container.php';
+        yield __DIR__ . '/../src/alias.php';
+    }
+}