Просмотр кода страницы .htaccess в IIS web.config

[[Category: IIS Windows]]

=.htaccess в IIS web.config=

[https://www.iis.net/learn/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig Оригинал]

==Request Filtering==
Тут используется директива FilesMatch в файле .htacess, чтобы ограничить доступ браузера к файлам, которые являются компонентами приложения.
 <nowiki><FilesMatch "\.(engine|inc|info|install|module|profile|po|sh|.*sql|theme|tpl(\.php)?|xtmpl)$|^(code-style\.pl|Entries.*|Repository|Root|Tag|Template)$"></nowiki>
   <nowiki>Order allow,deny</nowiki>
 <nowiki></FilesMatch></nowiki>
IIS использует модуль фильтрации запросов, чтобы ограничить доступ браузера к файлам. Web.config для примера выше:
       <nowiki><security></nowiki>
            <nowiki><requestFiltering></nowiki>
                <<nowiki>denyUrlSequences></nowiki>
                    <nowiki><add sequence="engine" /></nowiki>
                    <nowiki><add sequence="inc" /></nowiki>
                    <<nowiki>add sequence="info" /></nowiki>
                    <nowiki><add sequence="install" /></nowiki>
                    <nowiki><add sequence="module" /></nowiki>
                    <nowiki><add sequence="profile" /></nowiki>
                    <nowiki><add sequence="po" /></nowiki>
                    <nowiki><add sequence="sh" /></nowiki>
                    <nowiki><add sequence="theme" /></nowiki>
                    <nowiki><add sequence="tpl(\.php" /></nowiki>
                    <nowiki><add sequence="Root" /></nowiki>
                    <nowiki><add sequence="Tag" /></nowiki>
                    <nowiki><add sequence="Template" /></nowiki>
                    <nowiki><add sequence="Repository" /></nowiki>
                    <nowiki><add sequence="code-style" /></nowiki>
                <nowiki></denyUrlSequences></nowiki>
                <nowiki><fileExtensions></nowiki>
                    <nowiki><add fileExtension=".sql" allowed="false" /></nowiki>
                    <nowiki><add fileExtension=".pl" allowed="false" /></nowiki>
                <nowiki></fileExtensions></nowiki>
            <nowiki></requestFiltering></nowiki>
        <nowiki></security></nowiki>

Альтернативой использованию фильтрации запросов является использование модуля URL Rewriter для возврата ошибки 403 для любого из соответствующих типов файлов. Преимущество модуля URL Rewriter заключается в том, что он использует регулярное выражение для сопоставления.

        <nowiki><rule name="Protect files and directories from prying eyes" stopProcessing="true"></nowiki>
                <nowiki><match url="\.(engine|inc|info|install|module|profile|test|po|sh|.*sql|theme|tpl(\.php)?|xtmpl|svn-base)$|^(code-style\.pl|Entries.*|Repository|Root|Tag|Template|all-wcprops|entries|format)$" /></nowiki>
                <nowiki><action type="CustomResponse" statusCode="403" subStatusCode="0"</nowiki>
                    <nowiki>statusReason="Forbidden"</nowiki>
                    <nowiki>statusDescription="Access is forbidden." /></nowiki>
        <nowiki></rule></nowiki>

==Default Document==
В файле .htaccess директива DirectoryIndex сообщает веб-серверу, какой файл загружать, если имя файла не включено в URL-адресе
 # Set the default handler.
 <nowiki>DirectoryIndex index.php</nowiki>

Для IIS, документ по умолчанию должен быть установлен в самой верхней иерархии веб-сайта в качестве обработчика модуля. Например, PHP, обработчик модуля обычно устанавливается на уровне веб-сервера. Документ по умолчанию должен быть установлен на этом уровне также, а не локально в контексте веб-сайта. Следующий код в файле Web.config может переопределить какой файл использовать:
        <nowiki><defaultDocument></nowiki>
            <nowiki><files></nowiki>
                <nowiki><remove value="index.php" /></nowiki>
                <nowiki><add value="index.php" /></nowiki>
            <nowiki></files></nowiki>
        <nowiki></defaultDocument></nowiki>

==URL Rewriting==
IIS включает модуль URL Rewrite. Вы можете использовать это расширение для предоставления правилам IIS перезаписи входящих запросов URL. Наиболее распространенное использование URL Rewriting - предоставление более коротких и удобных для запоминания URL-адресов.

Многие PHP-приложения в настоящее время поставляются с rewrite правилами в своих файлах .htaccess. Эти правила описывают mod_rewrite Apache, как и когда переписывать входящие запросы. Модуль URL Rewriting IIS может читать эти правила и транслировать их в правила URL Rewriting.

Для примера правила mod_rewrite в файле .htaccess:
  <nowiki>RewriteCond %{HTTP_HOST} ^example\.com$ [NC]</nowiki>
  <nowiki>RewriteRule ^(.*)$ http://www.example.com/$1 [L,R=301]</nowiki>
 
  <nowiki>RewriteCond %{REQUEST_FILENAME} !-f</nowiki>
  <nowiki>RewriteCond %{REQUEST_FILENAME} !-d</nowiki>
  <nowiki>RewriteCond %{REQUEST_URI} !=/favicon.ico</nowiki>
  <nowiki>RewriteRule ^(.*)$ index.php?q=$1 [L,QSA]</nowiki>

Переведенные правила URL Rewriter:
 <nowiki><rewrite></nowiki>
  <nowiki><rules></nowiki>
    <nowiki><rule name="Imported Rule 1" stopProcessing="true"></nowiki>
      <nowiki><match url="^(.*)$" ignoreCase="false" /></nowiki>
      <nowiki><conditions></nowiki>
        <nowiki><add input="{HTTP_HOST}" pattern="^example\.com$" /></nowiki>
      <nowiki></conditions></nowiki>
      <nowiki><action type="Redirect" redirectType="Permanent" url="http://www.example.com/{R:1}" /></nowiki>
    <nowiki></rule></nowiki>
    <nowiki><rule name="Imported Rule 2" stopProcessing="true"></nowiki>
      <nowiki><match url="^(.*)$" ignoreCase="false" /></nowiki>
      <nowiki><conditions></nowiki>
        <nowiki><add input="{REQUEST_FILENAME}" matchType="IsFile" ignoreCase="false" negate="true" /></nowiki>
        <nowiki><add input="{REQUEST_FILENAME}" matchType="IsDirectory" ignoreCase="false" negate="true" /></nowiki>
        <nowiki><add input="{URL}" pattern="^/favicon.ico$" ignoreCase="false" negate="true" /></nowiki>
      <nowiki></conditions></nowiki>
      <nowiki><action type="Rewrite" url="index.php?q={R:1}" appendQueryString="true" /></nowiki>
    <nowiki></rule></nowiki>
  <nowiki></rules></nowiki>
 <nowiki></rewrite></nowiki>

==Error Page Redirects / Handling==
Некоторые приложения обрабатывают стандартные ошибки в рамках приложения. Директива ErrorDocument в файле .htaccess примера сообщает веб-серверу загрузить домашнюю страницу для  обработки любых ошибок 404 или «Файл не найден»
 <nowiki># Make Application handle any 404 errors.</nowiki>
 <nowiki>ErrorDocument 404 /index.php</nowiki>
IIS использует директиву httpErrors для этой функции. Однако, поскольку возможность установки этого параметра на уровне приложения по умолчанию отключена для IIS, этот раздел должен быть закомментирован.:
        <nowiki><!-- HTTP Errors section should only be enabled if the "Error Pages"</nowiki>
        <nowiki>feature has been delegated as "Read/Write" at the Web Server level.</nowiki>
           <nowiki><httpErrors></nowiki>
               <nowiki><remove statusCode="404" subStatusCode="-1" /></nowiki>
               <nowiki><error statusCode="404" prefixLanguageFilePath="" path="/index.php" responseMode="ExecuteURL" /></nowiki>
           <nowiki></httpErrors></nowiki>
        <nowiki>--></nowiki>

==Directory Browsing==
Другая часто применяемая мера безопасности (или целостности) приложения - отключение просмотра каталогов. Многие конфигурации веб-серверов позволят пользователям просматривать список файлов в каталоге, который не содержит один из файлов документов по умолчанию. .htaccess пример (директива Options):
 # Don't show directory listings for URLs which map to a directory.
 <nowiki>Options -Indexes</nowiki>
Аналогичный пример Web.config с помощью директивы directoryBrowse:
        <nowiki><directoryBrowse enabled="false" /></nowiki>

==Cache Aging==
Директивы кэширования используются для обеспечения кэширования статического содержимого в течение определенного периода времени, а динамический контент вообще не кэшируется. В файле .htaccess пример использования директивы ExpiresBy, предоставляемые модулем mod_expires:
 # Requires mod_expires to be enabled.
 <nowiki><IfModule mod_expires.c></nowiki>
   # Enable expirations.
   ExpiresActive On
  
   # Cache all files for 2 weeks after access (A).
   ExpiresDefault A1209600
  
   # Do not cache dynamically generated pages.
   <nowiki>ExpiresByType text/html A1</nowiki>
 <nowiki></IfModule></nowiki>
В файле Web.config IIS использует модуль Output Caching и директиву кэширования для управления кешированием. В примере приложения вы можете включить кеширование для .html-файлов максимум 14 дней. Для .php-файлов кеширование вообще не выполняется:
        <nowiki><caching></nowiki>
            <nowiki><profiles></nowiki>
                <nowiki><add extension=".php" policy="DisableCache" kernelCachePolicy="DisableCache" /></nowiki>
                <nowiki><add extension=".html" policy="CacheForTimePeriod" kernelCachePolicy="CacheForTimePeriod" duration="14:00:00:00" /></nowiki>
            <nowiki></profiles></nowiki>
        <nowiki></caching></nowiki>
[http://www.iis.net/learn/extensions/url-rewrite-module/iis-url-rewriting-and-aspnet-routing IIS URL Rewriting and Microsoft® ASP.NET routing].