CodeIgniter部署需Web服务器正确路由至index.php，否则非首页URL全404；核心权限问题集中在writable/和uploads/路径，根本原因是路径不合法或缺失执行位（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_save_path'] 必须是绝对路径且父目录存在
报错 mkdir(): Invalid path 的 90% 场景，是 $config['sess_save_path'] 设成了相对路径或空值，PHP session 扩展不报错，但 CI 的 Session_files_driver 会主动调用 mkdir() 并炸掉：
- 绝对路径写法唯一推荐：
$config['sess_save_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 才算真正刷新。
