CodeIgniter框架怎么配置虚拟主机_CodeIgniter框架服务器目录权限设置【设置】

先说一个容易踩坑的现象：CodeIgniter 部署好了，首页能打开，但点任何子页面都跳 404。这不是框架本身的问题，而是 Web 服务器没有正确把请求路由到 index.php。另一个高频事故是：session 写不进、缓存报错、文件上传到一半就断了——十有八九是 writable/ 和 uploads/ 这两个目录的权限没配好，而且根本原因往往不是“没给 777”，而是路径不合法、或者目录缺少执行位（x）。

CodeIgniter 本身不依赖虚拟主机配置，但实际部署时必须配合 Web 服务器（Nginx/Apache）正确路由请求到 index.php，否则所有非首页 URL 都会 404；目录权限问题则几乎全部集中在 writable/ 和 uploads/ 这两个路径，错配会导致 session 创建失败、缓存写入报错、文件上传中断等——根本原因不是“没给 777”，而是路径不合法或缺少执行位。

Apache 下 VirtualHost 配置要点（.htaccess 生效前提）

CI 默认靠 .htaccess 实现 URL 重写，但这要求 Apache 启用了 mod_rewrite，且对应 VirtualHost 或 Directory 块中明确允许覆盖：

• AllowOverride All 必须存在，仅写 AllowOverride FileInfo 不够，CI 的 .htaccess 里含 Options 和 Order 指令
• DocumentRoot 应指向 CI 项目根目录（含 index.php），不是 application/ 或 public/
• 若用 CI4，DocumentRoot 应设为 public/ 子目录，此时 .htaccess 在 public/ 内，且需额外配置 SetEnvIf 传递原始 URI 给框架

Nginx 下 location / 匹配必须用 try_files

Nginx 没有 .htaccess 机制，所有重写逻辑必须写死在 server 块里。常见错误是只写 location / { ... } 却漏掉 try_files，导致除首页外全 404：

• 必须用 try_files $uri $uri/ /index.php?$query_string;，不能省略 $query_string，否则 GET 参数丢失
• location ~ \.php$ 块中，fastcgi_param SCRIPT_FILENAME 必须用 $realpath_root$fastcgi_script_name，而非硬编码路径，否则 symlink 目录下会 502
• 若启用 CI4 的 public/ 入口模式，root 应设为 /var/www/myapp/public，且 location / 块内 try_files 要去掉开头的 /，即写成 try_files $uri $uri/ /index.php?$query_string;

$config['sess_sa ve_path'] 必须是绝对路径且父目录存在

报错 mkdir(): Invalid path 的 90% 场景，是 $config['sess_sa ve_path'] 设成了相对路径或空值，PHP session 扩展不报错，但 CI 的 Session_files_driver 会主动调用 mkdir() 并炸掉：

• 绝对路径写法唯一推荐：$config['sess_sa ve_path'] = FCPATH . 'writable/sessions';（FCPATH 是 CI 自带常量）
• 手动创建目录后，权限 ≠ 777：先 mkdir -p /var/www/html/writable/sessions，再 chown www-data:www-data /var/www/html/writable/sessions，最后 chmod 700 /var/www/html/writable/sessions
• 不要用 mkdir($path, '0777') —— 字符串 '0777' 被当十进制数解析，结果是 0755；要写 mkdir($path, 0777)（八进制字面量）

upload_path 和 cache_path 的 x 权限容易被忽略

目录能 mkdir() 成功、is_dir() 返回 true，但后续 fopen() 或 move_uploaded_file() 失败，大概率是缺执行位（x）：

• Linux 中“进入目录”需要 x 权限，哪怕只是读文件也得有 x，否则 PHP 无法遍历该目录
• 检查命令：ls -ld /var/www/html/uploads，输出如 drw-r--r-- 就缺 x，应改为 drwxr-xr-x
• 修复命令：chmod +x /var/www/html/uploads（只加 x）或 chmod 755 /var/www/html/uploads（重设）
• application/cache/ 同理，CI 的 Cache 类在写文件前会先 opendir()，没 x 就直接 fail

最常被跳过的一步：改完权限后没重启 PHP-FPM 进程，旧进程仍持旧 uid/gid 缓存，导致权限变更不生效。别只 reload nginx，sudo systemctl restart php*-fpm 才算真正刷新。