Вот есть у меня в проекте папка web, в ней лежат каталоги css, js, fonts. Подключение всего этого добра в проекте происходит через указание пути css/some.css, а путь к каталогу web указан как @web. Искаропки phpStorm не умеет в поиск файлов по такому пути, хотя по обычному пути предлагает.
Как ему сказать, что @web/ это web/ ? Утомляет и отнимает много времени подключение ресурсов с длинными именами + вероятность опечатки, потом сидишь и ищешь, в имени какого из файлов ошибка.
Вот как это выглядит в коде:
public $basePath = '@webroot';
public $baseUrl = '@web';
public $css = [
'css/site.css',
'css/bootstrap-united.css',
];
Т.е. я указал каталог web/ в виде @web, css уже указываются относительно пути этого каталога.