CodeIgniter在IIS环境下实现URL重写与index.php移除指南

1. 问题背景与分析

在使用codeigniter开发并部署到iis服务器（特别是windows共享主机环境，如plesk控制面板）时，开发者常会遇到url中持续出现index.php的问题。例如，期望的url是www.example.com/auth，但实际访问或应用生成的url却是www.example.com/index.php/auth。虽然手动输入包含index.php的url可以正确跳转，但直接访问根域名却可能导致重定向到带有index.php的url，这不仅影响用户体验，也可能对seo造成不利影响。

这个问题通常是由于两个层面的配置不完整或不匹配造成的：

1. CodeIgniter内部配置：CodeIgniter框架默认在生成URL时会包含index.php。
2. 服务器URL重写规则：IIS服务器需要明确的规则来处理不包含index.php的请求，并将其内部重写到index.php，以便CodeIgniter的路由机制能够介入。

2. 核心解决方案：CodeIgniter配置调整

解决index.php出现在URL中的首要且最直接的方法是修改CodeIgniter的配置文件。在CodeIgniter的application/config/config.php文件中，找到$config['index_page']配置项，并将其值设置为空字符串。

操作步骤：

1. 打开您的CodeIgniter项目目录，导航到application/config/。
2. 编辑config.php文件。
3. 找到以下行：

   $config['index_page'] = 'index.php';

   登录后复制
4. 将其修改为：

   $config['index_page'] = '';

   登录后复制

代码示例：

立即学习“PHP免费学习笔记（深入）”；

<?php
defined('BASEPATH') OR exit('No direct script access allowed');

/*
|--------------------------------------------------------------------------
| Index File
|--------------------------------------------------------------------------
|
| Typically this will be your index.php file, unless you've renamed it to
| something else. If you are using mod_rewrite to remove the page
| then set this variable to blank.
|
*/
$config['index_page'] = ''; // 将 'index.php' 修改为空字符串

// ... 其他配置项

完成此修改后，CodeIgniter在生成内部URL时将不再包含index.php。

3. IIS URL重写规则配置

即使CodeIgniter内部配置了不显示index.php，IIS服务器也需要知道如何处理那些直接访问控制器/方法路径（如www.example.com/auth）的请求。这就需要配置IIS的URL重写模块。

CodeIgniter应用通常会提供一个.htaccess文件用于Apache服务器的URL重写。在IIS环境下，我们需要将其转换为web.config文件。确保您的应用程序根目录（与index.php同级）包含一个web.config文件，其内容应类似于以下示例：

降重鸟

要想效果好，就用降重鸟。AI改写智能降低AIGC率和重复率。

113

查看详情

web.config示例：

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
        <rewrite>
            <rules>
                <rule name="CodeIgniter Rewrite Rule" stopProcessing="true">
                    <match url="^(.*)$" ignoreCase="false" />
                    <conditions>
                        <!-- 排除 index.php, resources, robots.txt 等文件/目录 -->
                        <add input="{R:1}" pattern="^(index\.php|resources|robots\.txt)" ignoreCase="false" negate="true" />
                        <!-- 排除真实存在的文件 -->
                        <add input="{REQUEST_FILENAME}" matchType="IsFile" ignoreCase="false" negate="true" />
                        <!-- 排除真实存在的目录 -->
                        <add input="{REQUEST_FILENAME}" matchType="IsDirectory" ignoreCase="false" negate="true" />
                    </conditions>
                    <!-- 将请求重写到 index.php，并传递原始路径作为查询字符串 -->
                    <action type="Rewrite" url="index.php?/{R:1}" appendQueryString="true" />
                </rule>
            </rules>
        </rewrite>
    </system.webServer>
</configuration>

web.config规则解析：

• <match url="^(.*)$" ignoreCase="false" />：匹配所有传入的URL路径。
• <conditions>：定义了重写规则的生效条件。
  • pattern="^(index\.php|resources|robots\.txt)" ignoreCase="false" negate="true"：排除那些以index.php、resources目录或robots.txt文件开头的请求，不对它们进行重写。
  • matchType="IsFile" negate="true"：排除那些对应真实存在文件的请求。这意味着如果请求的是assets/css/style.css，且该文件存在，则不会被重写。
  • matchType="IsDirectory" negate="true"：排除那些对应真实存在目录的请求。
• <action type="Rewrite" url="index.php?/{R:1}" appendQueryString="true" />：如果满足所有条件，IIS会将当前请求的URL内部重写到index.php，并将捕获到的原始路径（由{R:1}表示）作为查询字符串传递给index.php。appendQueryString="true"确保原始请求中的任何查询参数也会被保留。

注意事项：

• IIS URL Rewrite Module：确保您的IIS服务器已安装“URL Rewrite Module”。如果未安装，您可以通过Web Platform Installer或手动下载安装。
• 文件位置：web.config文件必须放置在应用程序的根目录，即与index.php文件同级。
• 权限：确保IIS进程对web.config文件及其所在的目录有足够的读取权限。

4. 工作原理与总结

要彻底解决CodeIgniter在IIS上URL中包含index.php的问题，CodeIgniter内部配置和IIS服务器重写规则两者缺一不可：

1. $config['index_page'] = '';：此设置告诉CodeIgniter框架在生成内部链接（如使用base_url()或site_url()时）时，不要在路径中包含index.php。这样，应用本身生成的URL就是干净的。
2. web.config文件：此文件告诉IIS服务器，当接收到一个不包含index.php但又不是真实文件或目录的请求时，应该将其内部转发给index.php处理。这样，当用户直接访问www.example.com/auth时，IIS会将这个请求透明地传递给index.php，然后CodeIgniter的路由系统才能正确解析/auth路径。

通过同时实施这两个配置，您可以确保CodeIgniter应用程序在IIS环境下拥有简洁、美观的URL，并实现预期的路由行为。如果遇到问题，请首先检查config.php的修改是否正确，然后确认web.config文件是否存在且内容无误，最后验证IIS的URL重写模块是否已正确安装并启用。

以上就是CodeIgniter在IIS环境下实现URL重写与index.php移除指南的详细内容，更多请关注php中文网其它相关文章！