Manual:Short URL/wiki/Page title -- Windows with IIS7--root access

From MediaWiki.org
Jump to: navigation, search

Warning: This Short URL page contains bad advice on how to configure your server that could lead to some pages on your wiki not working and/or may cause you issues while upgrading.

This guide remains simply because an official guide on how to configure short URLs on this wiki has not been created yet.
In the meantime it is recommended that you consult Daniel Friesen for advice on how to configure short URLs on your wiki instead of following the directions on this page.
Doing so will help in adding support for your webserver to short URL configuration tools and the creation of an official guide for short URL configuration on this server.

Contents

[edit] Pretty URLs with Windows IIS7/7.5

  1. Install IIS URL Rewrite Module
  2. Modify LocalSettings.php
  3. Create a Rewrite/Redirct rule

[edit] Install IIS URL Rewrite Module 2.0

  1. Download appropriate 32bit or 64bit IIS Rewrite Module from Microsoft:
  2. Install on the host server by running the downloaded .msi file

[edit] Modify LocalSettings.php

Edit the appropriate path configurations in your LocalSettings.php file:

  • $wgScriptPath = "/w"; The directory under your document root where MediaWiki is installed
  • $wgArticlePath = "/wiki/$1"; This is the rewritten URL
  • $wgUsePathInfo = true;

[edit] Create an Inbound and Outbound rule set

  1. Open IIS Network Manager
  2. Select your wiki site from the website list
  3. Open the URL Rewrite Control from the IIS group
  4. Click on "Add Rule(s)..."
  5. Select the "User-Friendly URL" template
  6. Enter http://www.example.com/wiki/index.php?title=Main_Page
  7. Select http://www.example.com/Main_Page from the drop down
    • There IIS Rewrite template doesn't support customizing through this window, we will get to a clean up step
  8. Check both of the following options:
    • Create corresponding redirect rules
    • Create corresponding outbound rewrite rule
  9. Click OK
  10. Open the web.config file that appears in the site root directory
  11. Change the following
    • FROM: <match url="^([^/]+)/?$" />
    • TO: <match url="^(wiki/[^/]+)/?$" />
  • rules based on IIS7.5

[edit] Sample Web.Config

This is a sample web.config file that contains rules based on the above. There is a second entry other then the rules. The httpRedirect handles making sure that any request to: http://www.example.com/ is directed to http://www.example.com/wiki/. This allows mediaWiki to pick up and run with any additional redirects.

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
        <rewrite>
            <rules>
                <rule name="Redirect User Friendly URL" enabled="true" stopProcessing="true">
                    <match url="^wiki/index\.php$" />
                    <conditions>
                        <add input="{REQUEST_METHOD}" pattern="^POST$" negate="true" />
                        <add input="{QUERY_STRING}" pattern="^title=([^=&amp;]+)$" />
                    </conditions>
                    <action type="Redirect" url="{C:1}" appendQueryString="false" />
                </rule>
                <rule name="Rewrite User Friendly URL" enabled="true" stopProcessing="true">
                    <match url="^(wiki/[^/]+)/?$" />
                    <conditions>
                        <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
                        <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
                    </conditions>
                    <action type="Rewrite" url="wiki/index.php?title={R:1}" />
                </rule>
            </rules>
            <outboundRules>
                <rule name="Outbound Rewrite User Friendly URL" preCondition="ResponseIsHtml1" enabled="true">
                    <match filterByTags="A, Form, Img" pattern="^(.*/)wiki/index\.php\?title=([^=&amp;]+)$" />
                    <action type="Rewrite" value="{R:1}{R:2}/" />
                </rule>
                <preConditions>
                    <preCondition name="ResponseIsHtml1">
                        <add input="{RESPONSE_CONTENT_TYPE}" pattern="^text/html" />
                    </preCondition>
                </preConditions>
            </outboundRules>
        </rewrite>
      <httpRedirect enabled="true" exactDestination="true" httpResponseStatus="Permanent">
        <add wildcard="/" destination="/wiki/" />
      </httpRedirect>
    </system.webServer>
</configuration>
Retrieved from "http://www.mediawiki.org/w/index.php?title=Manual:Short_URL/wiki/Page_title_--_Windows_with_IIS7--root_access&oldid=621426"