ci4控制器必须放在app/controllers目录，因自动加载仅注册该路径；类需继承controller、命名匹配文件名；路由须显式配置；读配置用config()、写日志用log_message()；避免输出提前触发headers错误。
CI4 项目初始化后，app 目录为什么不能直接放控制器？
因为 CodeIgniter4 默认不从 app 下自动加载控制器——它只认 app/Controllers 这个固定路径。你把 Home.php 放进 app/ 根目录，路由会 404，错误信息是 Class "App\Home" not found。
-
app/Controllers是唯一被自动注册为命名空间App\Controllers的目录（在app/Config/Autoload.php中配置） - 自定义控制器类必须继承
CodeIgniter\Controller，且文件名首字母大写（如Home.php），类名严格匹配（class Home extends Controller） - 别手贱改
app/Config/Autoload.php里的$psr4映射——CI4 的自动加载依赖 PSR-4 规范，乱加路径容易导致Class not found且无明确提示
路由配置写在 app/Config/Routes.php，但访问还是 404？
常见原因是没关掉「强制 HTTPS」或没配好 Apache/Nginx 的重写规则，导致请求根本没进 CI4 的入口文件 public/index.php。
- 先确认 Web 服务器是否转发所有请求到
public/index.php：Apache 要启用mod_rewrite并确保.htaccess生效；Nginx 必须有try_files $uri $uri/ /index.php?$query_string; - CI4 默认关闭全局路由（
$routes->setAutoRoute(false)），所以即使控制器存在，也必须显式注册：$routes->get('/', 'Home::index'); - 别用
$routes->add()写闭包路由来调试——它绕过中间件和命名空间解析，容易掩盖真实问题，临时调试完得删掉
public 目录以外的文件，怎么安全地读取配置或日志？
CI4 的设计原则是「public 只暴露入口，其余全隔离」。你不能用 file_get_contents('../app/Config/App.php') 这种相对路径去读，会触发 open_basedir 错误或权限拒绝。
- 读配置一律走
config('App')或service('config')，它们由框架封装，自动处理环境差异和缓存 - 写日志必须用
log_message('error', 'xxx')，它默认写入writable/logs/，而这个目录在安装时已被设为可写（PHP 进程用户有权限） - 想读自定义 JSON/YAML 配置？放
app/Config/下，新建一个类继承BaseConfig，再用config('YourConfig')加载——别自己json_decode(file_get_contents())
升级到 CI4.5 后，session_start() 报错说 headers already sent？
这是典型的输出提前触发，根源在 app/Config/Session.php 的驱动配置和 PHP 输出缓冲冲突。CI4.4+ 默认启用了 session.use_strict_mode = 1，对输出更敏感。
- 检查
app/Config/Session.php中$driver是否设为'CodeIgniter\Session\Handlers\FileHandler'（推荐），别用php原生驱动 - 确保所有控制器、模型、服务类的 PHP 文件末尾没有空行或空格——CI4 自动加载时会因 BOM 或多余换行导致 header 发送失败
- 如果用了第三方库（比如 Twig 扩展），确认它们没在构造函数里
echo或print_r——这种调试残留是 80% 的 headers already sent 根源
CI4 的结构干净，但它的“约定大于配置”藏得深：路径、命名、权限、输出时机，四个点只要一个松动，整个请求链就断在你看不见的地方。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
