Использование дружественных URL

1. 1) Рабочий образец .htaccess
2. 2) Настройте MODX Revolution
3. 3) Отредактируйте свой шаблон (ы)
4. 4) Очистить кеш сайта
5. 5) Конвертировать WWW-URL в не-WWW или наоборот

Вы можете получить дружественные URL-адреса, полностью работающие менее чем за две минуты, выполнив простой четырехэтапный процесс.

1) Рабочий образец .htaccess

MODX предоставляет файл ht.access для редактирования в соответствии с настройками вашего сервера. Он находится в корне сайта MODX. Этот файл будет игнорироваться сервером, пока вы не переименуете его или (лучше) скопируете его в файл с именем .htaccess. Всякий раз, когда браузер запрашивает страницу, сервер проверяет файл с именем .htaccess, который может содержать информацию о том, как должны обрабатываться различные URL-адреса.

Файл .htaccess может находиться в любом месте над установкой MODX, но обычное расположение находится в корне сайта MODX (вместе с файлом ht.access, а также каталогами assets, manager и connectors, как показано на рисунке ниже). Для большинства установок вам не нужно вносить какие-либо изменения в файл, чтобы заставить работать FURL. Есть одно изменение, которое вы должны сделать, но сначала включите FURL, и мы обсудим это изменение в конце этой страницы.

Вот файл ht.access, который поставляется с одной версией MODX (ваша версия может немного отличаться).

# MODX поддерживает дружественные URL через этот файл .htaccess. Вы должны обслуживать веб-страницы через Apache с помощью mod_rewrite, чтобы использовать эту функцию, и вы должны # изменить имя файла с ht.access на .htaccess. # # Убедитесь, что RewriteBase указывает на каталог, в который вы установили MODX. # Например, "/ modx", если ваша установка находится в подкаталоге "modx". # # Вы можете сделать свои URL не чувствительными к регистру, добавив директиву NC к своему правилу: RewriteRule ^ (. *) $ Index.php? Q = $ 1 [L, QSA, NC] RewriteEngine On RewriteBase / # # # Переписать www.domain.com -> domain.com - используется с плагином SEO Strict URLs #RewriteCond% {HTTP_HOST}. #RewriteCond% {HTTP_HOST}! ^ Example-domain-please-change \ .com [NC] #RewriteRule (. *) Http://example-domain-please-change.com/$1 [R = 301, L] # # # или для противоположного domain.com -> www.domain.com используйте следующее # НЕ ИСПОЛЬЗУЙТЕ ОБА # # #RewriteCond% {HTTP_HOST}. #RewriteCond% {HTTP_HOST}! ^ Www \ .example-domain-please-change \ .com [NC] #RewriteRule (. *) Http://www.example-domain-please-change.com/$1 [R = 301, L] # # # Правильно переписывать защищенные запросы для предотвращения предупреждений SSL-сертификатов, например, запретить # https://www.domain.com, когда ваш сертификат разрешает только https://secure.domain.com #RewriteCond% {SERVER_PORT}! ^ 443 #RewriteRule (. *) Https://example-domain-please-change.com/$1 [R = 301, L] # # # Часть с дружественными URL-адресами RewriteCond% {REQUEST_FILENAME}! -F RewriteCond% {REQUEST_FILENAME} ! -d RewriteRule ^ (. *) $ index.php? q = $ 1 [L, QSA] # # # # Убедитесь, что файлы .htc обслуживаются с правильным типом MIME, который является критическим # для XP SP2. Не комментируйте, если ваш хост разрешает переопределения типа htaccess MIME. #AddType text / x-component .htc # # # Если ваш сервер еще не настроен как таковой, следующую директиву # следует раскомментировать, чтобы установить для PHP параметр register_globals в OFF. # Это закрывает большую дыру в безопасности, которая используется большинством XSS (межсайтовых # скриптовых) атак. Для получения дополнительной информации: http://php.net/register_globals # # Чтобы убедиться, что эта опция отключена, откройте Диспетчер и выберите # Отчеты -> Информация о системе, а затем нажмите ссылку phpinfo (). Сделайте поиск на странице № для "register_globals". Местное значение должно быть ВЫКЛ. Если Master Value # выключен, вам не нужна эта директива. # # ЕСЛИ ДИРЕКТИВНЫЕ ПРИЧИНЫ REGISTER_GLOBALS 500 ОШИБКИ ВНУТРЕННЕГО СЕРВЕРА: # # Ваш сервер не позволяет устанавливать директивы PHP через .htaccess. В этом случае вы должны вместо этого внести изменения в файл php.ini. Если вы # используете коммерческий веб-хостинг, обратитесь к администраторам за помощью в # выполнении этого. Не все серверы допускают локальные файлы php.ini, и они должны # включать все конфигурации PHP (не только эту), иначе вы фактически # сбросите все до значений по умолчанию PHP. Обратитесь к www.php.net за более подробной информацией о настройке директив PHP. #php_flag register_globals Off # # # Для серверов, которые поддерживают сжатие вывода, вы должны набрать немного скорости, не комментируя следующие строки. #php_flag zlib.output_compression On #php_value zlib.output_compression_level 5 # # # # Следующие директивы останавливают мерцание экрана в IE на ролловерах CSS. Если # необходимо, откомментируйте следующие правила. Когда они на месте, вам может потребоваться принудительное обновление #, чтобы увидеть изменения в ваших проектах. #ExpiresActive On #ExpiresByType image / gif A2592000 #ExpiresByType image / jpeg A2592000 #ExpiresByType image / png A2592000 #BrowserMatch "MSIE" brokenvary = 1 #BrowserMatch "Mozilla / 4. [0-9] {2} # broken_server сломано 1 "Опера"! Сломаны

Вы также можете поместить файл в / htdocs или / public_html или в то, что использует ваш сервер, если он находится в корневом каталоге MODX или выше.

Имейте в виду, что некоторым хостам нравится писать собственный .htaccess чуть выше уровня сайта, но если ваш .htaccess находится в корне сайта MODX, он должен работать нормально. Если ваш хост поместил файл .htaccess в корень сайта MODX, возможно, вам придется вставить код из файла MODX ht.access ниже кода хоста в этом файле. Обязательно сделайте резервную копию файла хоста первым! Таким образом, вы можете восстановить его, если дела пойдут плохо.

Строка RewriteBase должна заканчиваться на / для корневых установок

RewriteBase для установки подкаталога может быть введен как: RewriteBase / subdirectoryName /, хотя это обычно необходимо только при установке на локальном хосте. Строка RewriteBase почти всегда должна заканчиваться косой чертой.

2) Настройте MODX Revolution

Затем измените настройки в области «Дружественные URL-адреса» системных настроек MODX (см. Следующее изображение). В MODX 2.3 щелкните значок шестеренки в правом верхнем углу и выберите «Системные настройки». В более ранних версиях перейдите в Система -> Настройки системы. В поле «Поиск по ключу» в правом верхнем углу сетки введите «friendly» (без кавычек) и нажмите Enter. Это отобразит все настройки Friendly URL. Главное, что вы хотите, это в нижней части: использовать дружественные URL (friendly_urls). Дважды щелкните «Нет» и измените его на «Да».

Если вы не видите все настройки MODX FURL, просто измените раскрывающийся список «Площадь» в верхней части сетки на Friendly URL, как я это сделал.

Вы не найдете friendly_url_prefix и friendly_url_suffix среди настроек на изображении ниже - они устарели в пользу расширений, определенных Типы контента и container_suffix (для ресурсов контейнера с типами содержимого, имеющими mime_type text / html).

Параметр «Контейнерный суффикс» по умолчанию теперь «/», что приводит к URL-адресам ресурсов контейнера, а не к типу содержимого контейнера (другими словами, URL-адреса ресурсов, помеченных как контейнеры, будут / вместо чего-то вроде .html). Если вы хотите, чтобы ваши контейнерные ресурсы отображались как их тип контента (например, .html), удалите «/» из этого параметра. Если у вас есть проблемы с пакетами, которые используют суффикс контейнера для FURLS (например, статьи ), верните эту настройку в «/».

Параметр Использовать дружественный путь псевдонима (use_alias_path) позволяет сайту отображать структуры каталогов. Если для этого параметра установлено значение «Нет», все документы на сайте будут отображаться в URL-адресах так, как если бы они находились непосредственно вне корня, независимо от путей. Если для этого параметра установлено значение «Да» (по умолчанию), вы увидите полный путь к текущей странице в URL-адресах.

Параметр friendly_alias_urls был удален в MODX 2.1+. Включение friendly_urls подразумевает, что вы используете friendly_alias_urls в 2.1+, и эта настройка больше не нужна или не нужна.

3) Отредактируйте свой шаблон (ы)

Убедитесь, что у вас есть следующий тег в разделе заголовка всех ваших шаблонов. Если у вас есть только один внешний интерфейс (например, «web»), вы обычно можете не указывать восклицательный знак на скорость загрузки страниц:

<base href = "[[! ++ site_url]]" />

4) Очистить кеш сайта

И вы сделали!

Самый простой способ воспользоваться полностью квалифицированными дружественными URL-адресами - это позволить MODX создавать ссылки, используя теги ссылок, описанные на этой странице: синтаксис тега ссылки создавать ссылки на различные ресурсы легко, если привязать их к тегу ссылки ниже (где 1 - идентификатор ресурса страницы, на которую вы хотите перейти). Это дает дополнительное преимущество, заключающееся в возможности перемещать ресурсы по веб-проекту без необходимости исправлять кучу неработающих ссылок, поскольку MODX просто обновляет ссылки, созданные таким образом, автоматически.
<a href="[[~1]]" title="some title"> Некоторая страница </a>

5) Конвертировать WWW-URL в не-WWW или наоборот

Ранее мы упоминали одно изменение, которое вы всегда должны вносить в файл .htaccess, когда у вас работают FURL. Это касается URL, которые начинаются с «www» (или нет). Пользователь может получить доступ к большинству сайтов с доменным именем или доменным именем, перед которым стоит «www». Вы всегда должны конвертировать URL в один или другой. Причины сложны, но если вы этого не сделаете, на вашем сайте могут произойти странные вещи. Например, пользователи, которые вошли в систему, могут внезапно потерять этот статус.

Исправить это действительно легко. В приведенном выше коде файла .htaccess вы увидите два раздела, оба закомментированы. Один меняет не-www URL-адреса на www-URL-адреса, а другой - наоборот. Решите, какой из них вы хотите, и просто раскомментируйте раздел, который делает это, удалив знак # в начале каждой строки. Будьте осторожны, вы будете раскомментировать только три строки.

Например, чтобы удалить «www.» Из всех запросов на сайт с доменом «yoursite.com» измените этот раздел:

# Переписать www.domain.com -> domain.com - используется с плагином SEO Strict URLs #RewriteCond% {HTTP_HOST}. #RewriteCond% {HTTP_HOST}! ^ Пример-домена-пожалуйста-изменить \ .com [NC] #RewriteRule (. *) Http://example-domain-please-change.com/$1 [R = 301, L]

выглядеть так:

# Переписать www.domain.com -> domain.com - используется с плагином SEO Strict URLs RewriteCond% {HTTP_HOST}. RewriteCond% {HTTP_HOST}! ^ Yoursite \ .com [NC] RewriteRule (. *) Http://yoursite.com/$1 [R = 301, L]

Обратите внимание, что мы не раскомментировали первую строку. Это настоящий комментарий. Раскомментирование заставит сервер обращаться с ним как с кодом, и это может привести к сбою сервера.

Severs может быть довольно обидчивым о том, что находится в файле .htaccess. Всегда делайте резервную копию рабочего файла .htaccess перед его изменением. Таким образом, если ваша работа приводит к сбою сервера, вы можете просто скопировать сохраненную версию обратно в .htaccess и начать заново.

Предложить редактирование на эту страницу на GitHub (Требуется учетная запись GitHub. Открывает новое окно / вкладку) или стать редактором документации MODX.

Похожие

Комментарии