XAMPP环境下多端口部署CodeIgniter-php教程-PHP中文网

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

xampp环境下多端口部署codeigniter

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></virtualhost> 块，不能复用同一端口写多个 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 和对应 <directory></directory> 必须严格匹配这一路径，不能指向项目根目录或 public/index.php 文件本身。

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

 <virtualhost>
    DocumentRoot "D:/projects/ci4-app1/public"
    ServerName localhost:8090
    <directory>
        AllowOverride All
        Require all granted
    </directory></virtualhost><virtualhost>
    DocumentRoot "D:/projects/ci4-app2/public"
    ServerName localhost:8091
    <directory>
        AllowOverride All
        Require all granted
    </directory></virtualhost>

注意：

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

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

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

XAMPP 8.0.30

XAMPP 8.0.30 是一款免费、开源的跨平台 Web 服务器集成包，专为快速搭建本地 PHP 开发环境而设计。该版本核心组件包括：Apache 2.4.56、MySQL 8.0.33、PHP 8.0.30、phpMyAdmin 5.2.1 等。它支持 Windows、Linux 和 macOS 系统，可让开发者在个人电脑上轻松模拟服务器环境，无需复杂配置即可运行 WordPress、Thin

下载

检查与修复步骤：

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

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

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

关键动作：