XAMPP环境下多端口部署CodeIgniter

从现在开始，我们要努力学习啦！今天我给大家带来《XAMPP环境下多端口部署CodeIgniter》，感兴趣的朋友请继续看下去吧！下文中的内容我们主要会涉及到等等知识点，如果在阅读本文过程中有遇到不清楚的地方，欢迎留言呀！我们一起讨论，一起学习！

Apache监听多端口需显式修改httpd.conf中Listen指令，为每个端口配置独立VirtualHost并指向CI4的public目录，启用mod_rewrite及AllowOverride All，确保.env位于项目根目录且编码正确。

Apache Listen端口必须显式修改，否则所有虚拟主机共享80端口

CodeIgniter项目在XAMPP中启用多端口（如 8090、8091）部署的前提，是Apache本身监听多个端口。XAMPP默认只监听 80（或 443），不改配置就配再多 VirtualHost 也只会被路由到默认端口，甚至触发端口冲突或静默失败。

实操要点：

• 打开 XAMPP\apache\conf\httpd.conf，找到第58行左右的 Listen 80，在其下方追加你需要的端口，例如：
  Listen 8090
Listen 8091
• 每个新端口都必须对应一个独立的 块，不能复用同一端口写多个 VirtualHost
• Windows下若提示“Address already in use”，先用 netstat -ano | findstr :8090 查进程，再用 taskkill /PID xxx /F 杀掉占用者（常见是 Skype 或另一个 Apache 实例）

每个端口需配独立 VirtualHost，且 DocumentRoot 必须指向 CI4 的 public 目录

CodeIgniter 4 要求 Web 服务器根目录为 public/ 子目录，否则会报 Cannot find app/Config/App.php 或白屏。多端口部署时，每个 VirtualHost 的 DocumentRoot 和对应 必须严格匹配这一路径，不能指向项目根目录或 public/index.php 文件本身。

示例（httpd-vhosts.conf 末尾）：

 <VirtualHost *:8090>
    DocumentRoot "D:/projects/ci4-app1/public"
    ServerName localhost:8090
    <Directory "D:/projects/ci4-app1/public">
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

<VirtualHost *:8091>
    DocumentRoot "D:/projects/ci4-app2/public"
    ServerName localhost:8091
    <Directory "D:/projects/ci4-app2/public">
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

注意：

• ServerName 写成 localhost:8090 是可选的，但推荐加上，避免 Apache 日志里出现警告
• 路径必须与 DocumentRoot 完全一致，大小写和斜杠方向都要核对（Windows 下反斜杠 \ 在配置中建议统一换成正斜杠 /）
• 别漏掉 AllowOverride All —— 这是让 .htaccess 生效的关键，缺了会导致所有非 index.php 路由 404

mod_rewrite 必须全局启用，且每个 VirtualHost 的 Directory 都要允许重写

CI4 的路由完全依赖 Apache 的 URL 重写能力。XAMPP 默认关闭 mod_rewrite，且即使启用，若某个 块里仍是 AllowOverride None，该端口下的项目仍会 404。

检查与修复步骤：

• 确认 httpd.conf 中这行已取消注释：LoadModule rewrite_module modules/mod_rewrite.so
• 查找所有 块（不止是 htdocs 那个），把其中的 AllowOverride None 全部改为 AllowOverride All
• 重启 Apache 后，可在对应端口根目录放一个空 .htaccess 文件测试：访问 http://localhost:8090/.htaccess，如果返回 500 错误，说明重写未生效；如果 404 或 403，说明模块已启用但规则被拒绝或文件权限问题

.env 文件位置和编码错误会导致多端口项目全部卡在 production 模式

多个 CI4 项目共存于同一台 XAMPP 时，容易误以为只要改端口就互不影响。但实际中，若任一项目的 .env 文件因隐藏属性、BOM 头或放错位置（比如丢进了 public/），Apache 进程可能读取失败，导致所有项目退回到默认的 production 环境——表现为错误不显示、日志不生成、缓存路径写入失败，排查时极易误判为端口或路由问题。

关键动作：

• .env 必须位于项目根目录（与 app/、public/ 同级），不是 public/ 下，也不是 htdocs/ 根下
• 右键 → 属性 → 取消勾选「隐藏」，避免 Windows 资源管理器自动忽略
• 用记事本打开 → 「另存为」→ 编码选「UTF-8」（不是 UTF-8-BOM），文件名填 .env（注意开头的点）
• 内容至少包含：CI_ENVIRONMENT = development，且不能有空格或中文标点

多端口部署真正麻烦的不是端口本身，而是每个端口背后都是一套独立的 Apache 上下文——DocumentRoot、Directory 权限、.htaccess 生效条件、环境变量加载路径，四者缺一不可。少改一行 AllowOverride 或多加一个 BOM，整个端口就变成黑盒。

理论要掌握，实操不能落！以上关于《XAMPP环境下多端口部署CodeIgniter》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！