常见问题

Q：为什么本地开发路由 404？
开发用内置服务器时，请用 php -S host:port serve.php（serve.php 是前端控制器，会把所有请求转交 public/index.php）。生产用 Nginx/Apache 重写到 public/index.php。

Q：返回 "Array" 而不是 JSON？
控制器返回数组会自动 json()；若仍看到 "Array"，请确认 config/app.php 的 default_return_type 不涉及（本框架 response()->json() 已显式输出 JSON，不受框架返回类型影响）。

Q：Windows 上能跑 Swoole 吗？
不能。Swoole 官方不支持 Windows。请用 Linux 或 WSL 运行 php bin/server.php。Windows 开发机可用本仓库自带 PHP 8 跑通 FPM / 内置服务器 / 单元测试。

Q：如何运行测试？
php8 tests/run.php（基于 SQLite 内存库，覆盖数据库 / 组件 / 布局模板，与 MySQL 无关；零依赖，无需装 PHPUnit）。也可只跑某类：php8 tests/run.php DbTest。

Q：日志和缓存文件默认写在哪里？
默认都在 <应用根>/runtime/ 下：runtime/logs/app.log（日志）、runtime/cache/（缓存）。可用 config/log.php、config/cache.php 覆盖路径与级别/过期时间；不配置也能用，框架内置默认值。也可直接用全局助手 logger() 与 cache()。