Использование символических ссылок

Последнее обновление Oct 20th, 2026 | История страницы | Улучшить эту страницу | Сообщить о проблеме

Support the team building MODX with a monthly donation.

The budget raised through OpenCollective is transparent, including payouts, and any contributor can apply to be paid for their work on MODX.

Backers

Budget

$186 per month—let's make that $500!

Learn more

Понимание символической ссылки¶

Символическая ссылка переадресует запрос другому ресурсу и возвращает его вывод по собственному URL. Содержимое не копируется, HTTP-перенаправление не отправляется. Ссылку можно разместить в любом месте дерева, и у каждой будет свой URL. Используйте её, чтобы сохранить старый URL, показать ресурс в нескольких местах, сократить длинный URL или закрыть варианты написания.

Символическая ссылка MODX — не файловый симлинк. Она переадресует запросы только внутри MODX.

Создание символической ссылки¶

Создайте ресурс и выберите тип Символическая ссылка или используйте Создать символическую ссылку в дереве ресурсов.
Укажите заголовок и псевдоним.
Запишите в поле содержимого ID целевого ресурса.
Сохраните, затем очистите кеш сайта и кеш документов, если цель не появилась.

Цель должна быть ID ресурса. URL или псевдоним не работают; для внешних адресов используйте веб-ссылку.

Объединение полей¶

Когда symlink_merge_fields включена (по умолчанию), непустые поля символической ссылки перекрывают поля цели при переадресации. Поэтому ссылка может использовать свой шаблон, заголовок меню и другие значения, показывая содержимое цели.

Некоторые поля не объединяются никогда:

Поле	Причина
`content`	Всегда ID целевого ресурса.
`pub_date`, `unpub_date`	Даты публикации принадлежат цели.
`richtext`	Сохраняется настройка редактора цели.
`_content`, `_processed`	Внутренние значения времени выполнения.

Список forward_merge_excludes по умолчанию также защищает type, published и class_key. Добавьте в настройку имена полей через запятую, чтобы защитить другие поля.

Когда symlink_merge_fields выключена, MODX использует поля цели и игнорирует переопределения ссылки, кроме URL и ID цели.

SEO¶

URL символической ссылки отдаёт 200 и показывает содержимое цели. Поисковые системы могут проиндексировать оба URL как дубликаты. Добавьте канонический тег в шаблон ссылки, если URL не должны конкурировать, или используйте веб-ссылку с кодом 301, когда старый URL должен постоянно переехать.

Пример¶

В этом примере содержимое страницы об образовании отдаётся по адресу me.html.

Смотрите также¶