CodeIgniter 4 默认要求Web服务器根目录指向public文件夹以实现安全隔离,而非移除public目录;此举保持框架结构完整、保障自动加载与升级兼容性,并需同步防护writable等敏感目录。

CodeIgniter 4 默认要求通过 public/ 目录访问(如 https://example.com/public/index.php),这是出于安全设计——把可公开访问的资源和应用核心文件物理隔离。想让 URL 更干净(比如直接访问 https://example.com/),**不是“去掉” public 目录,而是把 Web 服务器的根目录指向 public 文件夹**。这是标准且安全的做法。
把 Web 服务器根目录设为 public
这是最推荐、最稳妥的方式,无需修改框架结构,也不影响安全性。
-
Apache:在虚拟主机配置中将
DocumentRoot指向项目路径下的public/,例如:DocumentRoot "/var/www/myapp/public"
同时确保对应<Directory>块也指向该路径,并启用AllowOverride All以便 .htaccess 生效。 -
Nginx:把
root指令设为/var/www/myapp/public,并确保 PHP-FPM 的SCRIPT_FILENAME正确解析到public/index.php(通常需配置fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;)。 -
本地开发(PHP 内置服务器):运行命令时指定 public 目录为文档根:
php -S localhost:8000 -t public/ public/index.php
不建议:把 index.php 移出 public 目录
有人尝试把 public/index.php 复制或移动到项目根目录,再调整路径常量(如 FCPATH、APPPATH)。这会破坏 CI4 的目录约定,导致自动加载失败、资源路径错乱、Composer 脚本异常,且后续升级极易出问题。官方明确不支持这种结构。
补充:URL 中仍显示 /public?检查重写规则
如果已正确设置根目录为 public/,但访问 /public/xxx 仍能打开,说明服务器未禁用对旧路径的响应。应添加防护:
- 在项目根目录(非 public 下)放一个
.htaccess,内容为:Deny from all(Apache) - 或在 Nginx 配置中显式拒绝访问
/public/路径以外的敏感目录(如/app/、/writable/)
额外提醒:别忽略 writable 权限与日志安全
改完根目录后,请确认 writable/ 目录仍不可通过 Web 访问(例如浏览器不能打开 https://example.com/writable/logs/)。可在 public/.htaccess 或服务器配置中统一禁止访问所有非 public 子目录,避免敏感日志泄露。


















