Содержание
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}&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-адреса будут перезаписаны.