本教程详细指导如何在IIS服务器上部署的CodeIgniter应用中，移除URL中不必要的index.php。核心解决方案涉及修改CodeIgniter的config.php文件，将$config[‘index_page’]设置为空，并辅以正确的IIS web.config重写规则，确保应用URL的简洁性和正常路由。
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造成不利影响。
这个问题通常是由于两个层面的配置不完整或不匹配造成的：
CodeIgniter内部配置：CodeIgniter框架默认在生成URL时会包含index.php。服务器URL重写规则：IIS服务器需要明确的规则来处理不包含index.php的请求，并将其内部重写到index.php，以便CodeIgniter的路由机制能够介入。
2. 核心解决方案：CodeIgniter配置调整
解决index.php出现在URL中的首要且最直接的方法是修改CodeIgniter的配置文件。在CodeIgniter的application/config/config.php文件中，找到$config[‘index_page’]配置项，并将其值设置为空字符串。
操作步骤：
打开您的CodeIgniter项目目录，导航到application/config/。编辑config.php文件。找到以下行：
$config['index_page'] = 'index.php';
将其修改为：
$config['index_page'] = '';
代码示例：
立即学习“PHP免费学习笔记（深入）”；
<?phpdefined('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文件，其内容应类似于以下示例：
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重写模块是否已正确安装并启用。
以上就是CodeIgniter在IIS环境下实现URL重写与index.php移除指南的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1321000.html
微信扫一扫 
支付宝扫一扫 
