======DokuWiki с IIS======
Это для тех, кто хочет использовать [[wiki:wiki|DokuWiki]] на компьютере с Windows и веб-сервером IIS (Windows 2000, Windows XP или Windows Server 2003, 2008)
=====IIS6 и предыдущие=====
====Установить PHP====
* Новая DL-ссылка для PHP под IIS (автоматическая установка): Ссылка [[http://www.iis-aid.com/iis_aid_php_installer|IIS-Aid]] FIXME не работает/Скачать невозможно
* Если вы хотите выполнить автономную установку и хотите использовать fast-cgi, установите дополнение перед установкой php: [[http://www.iis.net/extensions/FastCGI|IIS-FastCGI]]
(Просто установите и оставьте настройку «загрузить и установить FastCGI», и он автоматически обнаружит fast-cgi в вашей системе)
* Используйте установку Windows с веб-сайта PHP. Посетите [[http://www.php.net/|сайт PHP]] для инсталляторов или полных пакетов. PHP не полностью совместим с основными выпусками, по состоянию на Q1/2021 выберите новейший выпуск 7.x. Если у вас есть сомнения, обратитесь к системным [[wiki:requirements|]] требованиям. PHP может работать как CGI-приложение или как расширение ISAPI. В качестве альтернативы посетите [[http://php.iis.net/|сайт Microsoft IIS]] для автоматической настройки PHP.
* Если вы используете [[http://www.php.net/manual/en/book.wincache.php|расширение кэширования Windows для PHP]], вам необходимо отключить функцию кэширования файлов расширения, установив [[http://example.com|wincache.fcenabled]] значение ''0'' в ''php.ini''.
====Настроить IIS====
- [[wiki:install:unpacking|Извлеките]] архив DokuWiki
- Переименуйте ''dokuwiki-YYYY-MM-DD'' каталог в ''dokuwiki'' (или как вам нравится) и переместите его в:
* ЛУЧШАЯ Практика — поместить его куда-нибудь, кроме вашего «системного» диска, «D:\dokuwiki». Это необходимо для безопасности и снижения вероятности состояния «диск заполнен» на этом диске.
* Где-то ниже documentroot вашего нового веб-сервера, например ''c:\inetpub\wwwroot\dokuwiki''
* Защитите все каталоги, как описано в шаге 2 главной страницы установки .
- Настройте IIS (выполните одно из следующих действий):
* Виртуальный каталог на существующем веб-сайте, например, « www.YourSite.com/wiki »: поэтому обязательно настройте сопоставление виртуального каталога с wiki-code-location
* Новый веб-сайт, например [[http://www.yoursite.com/wiki|«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 с [[http://windows.php.net/download/m|веб-сайта PHP]]. Посетите сайт PHP для получения установщиков или полных пакетов. PHP не полностью совместим между основными выпусками, по состоянию на Q1/2021 выберите новейший выпуск 7.x. Если у вас есть сомнения, обратитесь к системным требованиям . Существует 2 установщика: «потокобезопасный» и «непотокобезопасный». Рекомендуется использовать непотокобезопасную сборку PHP с IIS 7 FastCGI. Непотокобезопасная сборка PHP обеспечивает значительный прирост производительности по сравнению со стандартной сборкой, не выполняя никаких проверок потокобезопасности, которые не нужны, поскольку FastCGI обеспечивает однопоточную среду выполнения.
* PHP может работать как CGI-приложение или как расширение ISAPI. Эти инструкции предназначены для Fast-CGI, так как он быстрее и стабильнее ISAPI. Даже Microsoft рекомендует устанавливать с помощью Fast-CGI, хотя они и изобрели ISAPI. См. [[http://learn.iis.net/page.aspx/246/using-fastcgi-to-host-php-applications-on-iis-7/|How To]]
====Настроить IIS====
- [[wiki:install:unpacking|Извлеките]] архив DokuWiki
- Переименуйте ''dokuwiki-YYYY-MM-DD'' каталог в ''dokuwiki'' (или как вам нравится) и переместите его в:
* __ЛУЧШИЙ__ способ — разместить его где-нибудь, кроме системного диска (например ''D:\dokuwiki''). Это необходимо для безопасности и снижения вероятности переполнения диска на этом диске.
* Однако вы также можете поместить его где-нибудь ниже корневого каталога документов вашего нового веб-сервера, (например ''c:\inetpub\wwwroot\dokuwiki'')
- Защитите все каталоги, как описано в шаге 2 главной страницы установки .
* Вам придется предоставить учетной записи IUSR разрешения на чтение и выполнение на веб-сайте, поскольку по умолчанию они отсутствуют.
* В диспетчере IIS щелкните левой кнопкой мыши имя сайта.
* Нажмите «Изменить разрешения» на панели «Действия» ИЛИ щелкните правой кнопкой мыши и выберите «Изменить разрешения» в контекстном меню.
* Нажмите вкладку «Безопасность».
* Нажмите кнопку «Изменить».
* Нажмите кнопку «Добавить».
* Нажмите кнопку «Расположения» и выберите имя локального сервера.
* Теперь введите IUSR и нажмите «ОК», а затем еще раз «ОК».
- Настройте IIS (выполните __одно__ из следующих действий):
* Виртуальный каталог на существующем веб-сайте, например, « www.YourSite.com/wiki »: поэтому обязательно настройте сопоставление виртуального каталога с wiki-code-location
* Новый веб-сайт, например [[http://www.yoursite.com/wiki|«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-адресов и вставьте соответствующий набор правил:
**Если вы используете Azure Web App**, просто поместите эти строки под тегами в файле web.config (расположенном в wwwroot вашего приложения).
===IIS 7.0 или выше===
IIS 7.0 и выше можно расширить с помощью модуля URL Rewrite 2.0, доступного от Microsoft для [[https://download.microsoft.com/download/D/8/1/D81E5DD6-1ABB-46B0-9B4B-21894E18B77F/rewrite_x86_en-US.msi|x86]] и [[https://download.microsoft.com/download/1/2/8/128E2E22-C1B9-44A4-BE2A-5859ED1D4592/rewrite_amd64_en-US.msi|x64]].
Сохраните правила Apache выше в файле .htaccess, удалив строку «RewriteBase /dokuwiki». Это не потребуется, так как мы будем добавлять правила непосредственно в корень вики.
В диспетчере IIS выберите папку Wiki, а в разделе IIS выберите « URL Rewrite» (если диспетчер был открыт перед установкой, потребуется обновление).
На панели действий справа выберите «Импортировать правила».
Для вашего файла конфигурации выберите файл .htaccess и импортируйте его. Это должно дать вам 6 преобразованных правил.
Наконец, нажмите «Применить» на панели «Действия» справа.
Настройте свою Wiki на использование правил .htaccess для перезаписи, и теперь вы должны увидеть, как ваши URL-адреса будут перезаписаны.