CodeIgniter 4 本地运行需通过 public 目录访问,正确配置 baseURL(如 http://localhost/blog/)并确保 Web 根目录指向 public 子目录,否则出现 404 或资源加载失败。

想在本地快速跑起一个PHP项目,又不想被Laravel的复杂配置劝退,CodeIgniter轻量、单文件入口、不强制依赖Composer的特点特别适合新手上手——但第一步卡在“官网打不开”“下载包解压后访问404”“改了base_url还是白屏”,这些问题其实都源于没选对下载渠道或忽略关键路径配置。
从官方渠道下载CI4最新稳定版
打开浏览器,访问 https://codeigniter.com/download(不是旧版ci.org.cn,该站已停止维护),页面自动跳转至GitHub Releases页。
向下滚动,找到最新带“Latest release”标签的版本(当前为v4.6.0),点击Assets展开区,下载 codeigniter4-v4.6.0-stable.zip 文件(不是Source code那行)。
注意:不要下载“Source code (zip)”——它不含预编译的vendor依赖,直接解压运行会报Class not found错误。
用Composer创建CI4项目(推荐给有命令行基础的新手)
方法一:全局镜像方式(需提前配置阿里云镜像)
执行命令:composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/,必须带composer类型声明和末尾/,否则静默失效。
接着运行:composer create-project codeigniter4/appstarter myproject --prefer-dist --no-interaction,等待下载完成,myproject即为你本地项目文件夹名。
方法二:项目级镜像(更可靠,尤其在宝塔或Docker环境)
新建空文件夹 → 进入该目录 → 执行composer init -n生成空composer.json → 再执行composer config repo.packagist composer https://mirrors.aliyun.com/composer/(去掉-g参数)→ 最后运行composer create-project codeigniter4/appstarter . --prefer-dist --no-interaction。
解压后部署到Web服务器根目录
第一步:将下载的codeigniter4-xxx.zip解压,得到一个名为codeigniter4的文件夹。
第二步:把整个codeigniter4文件夹复制到你的Web服务器根目录下(如XAMPP的htdocs、phpStudy的www、IIS的inetpub/wwwroot)。
第三步:重命名该文件夹为有意义的项目名,例如blog或admin-panel——不能保留原名codeigniter4,否则public目录下的index.php无法正确解析APPPATH路径。
第四步:用浏览器访问http://localhost/your-project-name/public/(CI4必须通过public子目录访问,不是根目录!)。
修改base_url确保资源加载正常
打开app/Config/App.php文件,找到$baseURL变量。
若项目部署在http://localhost/blog/public/,则写成:$baseURL = 'http://localhost/blog/';(结尾不加public,框架会自动补)。
若使用HTTPS或自定义端口(如8080),必须完整写入:$baseURL = 'https://mysite.local:8080/';,漏掉协议或端口会导致CSS/JS 404。


















