CodeIgniter IIS下移除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'] = '';

代码示例：

完成此修改后，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文件，其内容应类似于以下示例：
web.config示例：


    
        
            
                
                    
                    
                        
                        
                        
                        
                        
                        
                    
                    
                    
                
            
        
    
web.config规则解析：
：匹配所有传入的URL路径。
：定义了重写规则的生效条件。
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"：排除那些对应真实存在目录的请求。
：如果满足所有条件，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服务器重写规则两者缺一不可：
$config['index_page'] = '';：此设置告诉CodeIgniter框架在生成内部链接（如使用base_url()或site_url()时）时，不要在路径中包含index.php。这样，应用本身生成的URL就是干净的。
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重写模块是否已正确安装并启用。