The package aim is to store path aliases, i.e. short name representing a long path (a file path, a URL, etc.).
Path alias value may have another value as its part. For example, @vendor may store path to vendor directory
while @bin may store @vendor/bin.
- PHP 8.1 - 8.5.
The package could be installed with Composer:
composer require yiisoft/aliasesA path alias must start with the character '@' so that it can be easily differentiated from non-alias paths.
use Yiisoft\Aliases\Aliases;
$aliases = new Aliases([
'@root' => __DIR__,
]);
$aliases->set('@vendor', '@root/vendor');
$aliases->set('@bin', '@vendor/bin');
echo $aliases->get('@bin/phpunit');The code about would output "/path/to/vendor/bin/phpunit".
Note that set() method does not check if the given path exists or not. All it does is to associate the alias with
the path.
The path could be:
- a directory or a file path (e.g.
/tmp,/tmp/main.txt) - a URL (e.g.
https://www.yiiframework.com) - a path alias (e.g.
@yii/base). It will be resolved on {@see get()} call.
Any trailing / and \ characters in the given path will be trimmed.
To bulk translate path aliases into actual paths use getArray() method:
$aliases = new Aliases([
'@root' => '/my/app',
]);
// Value will be ['src' => '/my/app/src', 'tests' => '/my/app/tests']
$directories = $aliases->getAll(['src' => '@root/src', 'tests' => '@root/tests']);In case multiple aliases are registered with same root (prefix), then the most specific has precedence:
use Yiisoft\Aliases\Aliases;
$aliases = new Aliases([
'@vendor' => __DIR__ . '/vendor',
'@vendor/test' => '/special/location'
]);
echo $aliases->get('@vendor/test');That would output /special/location since @vendor/test is more specific match than @vendor.
If you need to remove alias runtime:
use Yiisoft\Aliases\Aliases;
$aliases = new Aliases([
'@root' => __DIR__,
]);
$aliases->remove('@root');The package provides AliasReference class that implements ReferenceInterface from
Yii Definition. It allows you to create references to aliases
that will be resolved at runtime:
// Create a reference to an alias
$reference = \Yiisoft\Aliases\AliasReference::to('@public/assets');
// The reference will be resolved when needed
$configPath = $reference->resolve($container);This is particularly useful in dependency injection configurations where you want to inject resolved paths but the aliases are not available at configuration time.
If you need help or have a question, the Yii Forum is a good place for that. You may also check out other Yii Community Resources.
The Yii Aliases is free software. It is released under the terms of the BSD License.
Please see LICENSE for more information.
Maintained by Yii Software.
