DokuWiki с IIS

Это для тех, кто хочет использовать DokuWiki на компьютере с Windows и веб-сервером IIS (Windows 2000, Windows XP или Windows Server 2003, 2008)

IIS6 и предыдущие

Установить PHP

Новая DL-ссылка для PHP под IIS (автоматическая установка): Ссылка IIS-Aid не работает/Скачать невозможно
Если вы хотите выполнить автономную установку и хотите использовать fast-cgi, установите дополнение перед установкой php: IIS-FastCGI

(Просто установите и оставьте настройку «загрузить и установить FastCGI», и он автоматически обнаружит fast-cgi в вашей системе)

Используйте установку Windows с веб-сайта PHP. Посетите сайт PHP для инсталляторов или полных пакетов. PHP не полностью совместим с основными выпусками, по состоянию на Q1/2021 выберите новейший выпуск 7.x. Если у вас есть сомнения, обратитесь к системным requirements требованиям. PHP может работать как CGI-приложение или как расширение ISAPI. В качестве альтернативы посетите сайт Microsoft IIS для автоматической настройки PHP.
Если вы используете расширение кэширования Windows для PHP, вам необходимо отключить функцию кэширования файлов расширения, установив wincache.fcenabled значение 0 в php.ini.

Настроить IIS

Извлеките архив DokuWiki
Переименуйте dokuwiki-YYYY-MM-DD каталог в dokuwiki (или как вам нравится) и переместите его в:
- ЛУЧШАЯ Практика — поместить его куда-нибудь, кроме вашего «системного» диска, «D:\dokuwiki». Это необходимо для безопасности и снижения вероятности состояния «диск заполнен» на этом диске.
- Где-то ниже documentroot вашего нового веб-сервера, например c:\inetpub\wwwroot\dokuwiki
- Защитите все каталоги, как описано в шаге 2 главной страницы установки .
Настройте IIS (выполните одно из следующих действий):
- Виртуальный каталог на существующем веб-сайте, например, « www.YourSite.com/wiki »: поэтому обязательно настройте сопоставление виртуального каталога с wiki-code-location
- Новый веб-сайт, например «wiki.YourSite.com»: добавьте новый website-Config в IIS и установите Root-Directory в wiki-code-location
Перейдите в dokuwiki/ каталог и проверьте свойства папки data/. Убедитесь, что учетная запись гостя Интернета (IUSR_имя_компьютера ) или соответствующая учетная запись веб-сервера (или группа веб-сервера, например IIS_WPG) имеет разрешения на запись на уровне папки data/.
Установщик wiki теперь должен быть доступен по адресу http://localhost/dokuwiki/install.php

ПРИМЕЧАНИЯ

Если вы хотите записать /conf/local.php (а это нужно сделать во время процесса установки!), убедитесь, что гостевая учетная запись Интернета (IUSR_имя_компьютера ) или соответствующая группа веб-сервера (например, IIS_WPG) имеют права «Запись» для этого conf/local.php файла.
Если вы хотите запустить новую DokuWiki, убедитесь, что гостевая учетная запись Интернета (IUSR_имя_компьютера ) или соответствующая группа веб-сервера (например, IIS_WPG) имеют права «Запись» для файла conf/local.php.

IIS7/10

Установить PHP

Используйте установку Windows с веб-сайта PHP. Посетите сайт PHP для получения установщиков или полных пакетов. PHP не полностью совместим между основными выпусками, по состоянию на Q1/2021 выберите новейший выпуск 7.x. Если у вас есть сомнения, обратитесь к системным требованиям . Существует 2 установщика: «потокобезопасный» и «непотокобезопасный». Рекомендуется использовать непотокобезопасную сборку PHP с IIS 7 FastCGI. Непотокобезопасная сборка PHP обеспечивает значительный прирост производительности по сравнению со стандартной сборкой, не выполняя никаких проверок потокобезопасности, которые не нужны, поскольку FastCGI обеспечивает однопоточную среду выполнения.
PHP может работать как CGI-приложение или как расширение ISAPI. Эти инструкции предназначены для Fast-CGI, так как он быстрее и стабильнее ISAPI. Даже Microsoft рекомендует устанавливать с помощью Fast-CGI, хотя они и изобрели ISAPI. См. How To

Настроить IIS

Извлеките архив DokuWiki
Переименуйте dokuwiki-YYYY-MM-DD каталог в dokuwiki (или как вам нравится) и переместите его в:
- ЛУЧШИЙ способ — разместить его где-нибудь, кроме системного диска (например D:\dokuwiki). Это необходимо для безопасности и снижения вероятности переполнения диска на этом диске.
- Однако вы также можете поместить его где-нибудь ниже корневого каталога документов вашего нового веб-сервера, (например c:\inetpub\wwwroot\dokuwiki)
Защитите все каталоги, как описано в шаге 2 главной страницы установки .
- Вам придется предоставить учетной записи IUSR разрешения на чтение и выполнение на веб-сайте, поскольку по умолчанию они отсутствуют.
  - В диспетчере IIS щелкните левой кнопкой мыши имя сайта.
  - Нажмите «Изменить разрешения» на панели «Действия» ИЛИ щелкните правой кнопкой мыши и выберите «Изменить разрешения» в контекстном меню.
  - Нажмите вкладку «Безопасность».
  - Нажмите кнопку «Изменить».
  - Нажмите кнопку «Добавить».
  - Нажмите кнопку «Расположения» и выберите имя локального сервера.
  - Теперь введите IUSR и нажмите «ОК», а затем еще раз «ОК».
Настройте IIS (выполните одно из следующих действий):
- Виртуальный каталог на существующем веб-сайте, например, « www.YourSite.com/wiki »: поэтому обязательно настройте сопоставление виртуального каталога с wiki-code-location
- Новый веб-сайт, например «wiki.YourSite.com»: добавьте новый website-Config в IIS и установите Root-Directory в wiki-code-location
Перейдите в dokuwiki/ каталог и проверьте свойства папки data/. Убедитесь, что учетная запись гостя Интернета (IUSR), соответствующая учетная запись веб-сервера или группа серверов (IIS_IUSRS) имеет разрешения на запись на уровне папки data/. Инструкции см. выше.
Перейдите в dokuwiki/каталог и убедитесь, что учетная запись гостя Интернета (IUSR), соответствующая учетная запись веб-сервера или группа серверов (IIS_IUSRS) имеет разрешения на запись на уровне папки conf/. Инструкции см. выше.

conf/
lib/plugins ( если вы этого не сделаете, вы увидите предупреждающее сообщение в менеджере расширений )

Установщик вики теперь должен быть доступен. В зависимости от того, как вы его установили, вы можете найти его по адресу http://localhost/dokuwiki/install.php ИЛИ http://(название сайта вики) /install.php
Перейдите в dokuwiki/ каталог и удалите файл install.php.

Переписать

Включите перезапись URL-адресов и вставьте соответствующий набор правил:

<rewrite>
<rules>
 
<rule name="rule 1C" stopProcessing="true">
	<match url="^_media/(.*)" />
	<action type="Rewrite" url="/lib/exe/fetch.php?media={R:1}" appendQueryString="true" />
</rule>
<rule name="rule 2C" stopProcessing="true">
	<match url="^_detail/(.*)" />
	<action type="Rewrite" url="/lib/exe/detail.php?media={R:1}" appendQueryString="true" />
</rule>
<rule name="rule 3C" stopProcessing="true">
	<match url="^_export/([^/]+)/(.*)" />
	<action type="Rewrite" url="/doku.php?do=export_{R:1}&amp;id={R:2}" appendQueryString="true" />
</rule>
<rule name="rule 4C" stopProcessing="true">
	<match url="^$" />
	<action type="Rewrite" url="/doku.php" />
          <conditions>
            <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
            <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
           </conditions>
</rule>
<rule name="rule 5C" stopProcessing="true">
	<match url="(.*)" />
	<action type="Rewrite" url="/doku.php?id={R:1}" appendQueryString="true" />
          <conditions>
            <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
            <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
          </conditions>
</rule>
<rule name="rule 6C">
	<match url="^index.php$" />
	<action type="Rewrite" url="/doku.php" />
</rule>
</rules>
</rewrite>

Если вы используете Azure Web App, просто поместите эти строки под тегами <system.webServer> в файле web.config (расположенном в wwwroot вашего приложения).

IIS 7.0 или выше

IIS 7.0 и выше можно расширить с помощью модуля URL Rewrite 2.0, доступного от Microsoft для x86 и x64.

Сохраните правила Apache выше в файле .htaccess, удалив строку «RewriteBase /dokuwiki». Это не потребуется, так как мы будем добавлять правила непосредственно в корень вики.

В диспетчере IIS выберите папку Wiki, а в разделе IIS выберите « URL Rewrite» (если диспетчер был открыт перед установкой, потребуется обновление).

На панели действий справа выберите «Импортировать правила».

Для вашего файла конфигурации выберите файл .htaccess и импортируйте его. Это должно дать вам 6 преобразованных правил.

Наконец, нажмите «Применить» на панели «Действия» справа.

Настройте свою Wiki на использование правил .htaccess для перезаписи, и теперь вы должны увидеть, как ваши URL-адреса будут перезаписаны.