CodeIgniter本地运行需确保PHP、Web服务器与框架三者兼容互通:版本匹配(CI3≥PHP5.6,CI4≥PHP7.3)、路径正确(如XAMPP放htdocs下)、重写生效,配置base_url和数据库后访问welcome路由即可显示欢迎页。

CodeIgniter下载后在本地运行,关键不是“放上去就完事”,而是让框架、PHP、Web服务器三者能互相认得、说得上话。只要环境版本匹配、路径配置准确、重写规则生效,打开浏览器就能看到欢迎页。
确认PHP和Web服务器已就绪
CodeIgniter本身不带服务器,必须依赖外部环境:
- CI3:要求PHP 5.6 或更高版本;CI4:最低需PHP 7.3,推荐PHP 8.2+(尤其CI4.5以上)
- Web服务器选Apache或Nginx均可。新手建议用XAMPP、WAMP(Windows)、MAMP(macOS)这类集成包,它们已预装PHP+Apache+MySQL,开箱即用
- 检查PHP是否启用必要扩展:mbstring、intl(CI4必需)、curl、pdo_mysql(如连MySQL)
解压并放置到Web根目录
不要双击运行zip,要“部署”:
- 将下载的CodeIgniter压缩包解压,得到application、system、public(CI4)或index.php(CI3)等目录结构
- 把整个文件夹复制到Web服务器的可访问目录下。例如:
- XAMPP → htdocs/my_project
- WAMP → www/my_project
- 手动Apache → /var/www/html/my_project(Linux)
- 确保index.php位于Web可访问路径的最外层(CI4中是public/index.php,这是唯一应被直接访问的入口)
完成基础配置
核心是两份配置文件,改对就通一大半:
-
设置 base_url:编辑 app/Config/App.php(CI4)或 application/config/config.php(CI3),找到$config['base_url'](CI3)或$baseURL(CI4),填入完整地址,例如:
http://localhost/my_project/(CI3)或http://localhost/my_project/public/(CI4) - 配置数据库(如需):修改 app/Config/Database.php(CI4)或 application/config/database.php(CI3),填入hostname、username、password、database
- 调整环境模式:CI4通过.env文件控制,去掉# CI_ENVIRONMENT = development前的#号;CI3则在index.php顶部把ENVIRONMENT设为development
启用URL重写(去掉index.php)
默认访问地址带index.php,要去掉它,需Web服务器支持重写:
-
Apache:确保mod_rewrite已开启;在项目根目录(CI3)或public目录(CI4)放一个.htaccess文件,内容为:
RewriteEngine On RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule ^(.*)$ index.php/$1 [L] -
Nginx:在server块中添加:
try_files $uri $uri/ /index.php?$query_string;(CI3)或
try_files $uri $uri/ /index.php?$query_string;(CI4,注意location需指向public) - 验证方式:访问http://localhost/my_project/welcome(CI3)或http://localhost/my_project/public/welcome(CI4),能显示欢迎页即成功


















