如何无需执行php spark serve命令运行Codeigniter 4项目

问题原因排查 #

你当前的配置错误大概率出在端口和目录映射匹配上，按照以下步骤修正即可：

修正现有移动文件方案的配置 #

如果你选择将public目录下的所有文件移动到htdocs/cms根目录，按如下步骤调整：

• 确认目录结构符合要求：

  htdocs/
  └── cms/
      ├── app/
      ├── system/
      ├── writable/
      ├── index.php # 从public目录移动而来
      └── .htaccess # 从public目录移动而来
  

• 修正端口配置：php spark serve默认使用8080端口，Apache默认使用80端口，如果你没有手动修改Apache监听端口，需要将App.php和.env里的baseURL修改为http://localhost/cms/，去掉末尾的8080端口。
• 确认index.php中的路径配置为$pathsConfig = FCPATH . 'app/Config/Paths.php';，和你之前修改的一致即可。
• 检查Apache配置：确保mod_rewrite扩展已开启，且Apache站点配置中的AllowOverride参数设置为All，保证.htaccess规则生效。
• Linux环境下需要给writable目录授予读写权限，执行命令chmod -R 755 writable即可。

更安全的替代方案（无需移动文件） #

直接配置Apache虚拟主机指向CI4的public目录，既不用调整文件结构，也能避免核心目录暴露在Web根目录下，操作步骤：

1. 打开Apache的httpd-vhosts.conf配置文件，添加如下规则（路径替换为你本地的实际项目路径）：

<VirtualHost *:80>
    DocumentRoot "C:/xampp/htdocs/cms/public"
    ServerName cms.local
    <Directory "C:/xampp/htdocs/cms/public">
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

2. 编辑本地hosts文件，添加一行记录127.0.0.1 cms.local
3. 重启Apache，之后直接访问http://cms.local即可正常访问项目。

排查技巧 #

如果调整后还是无法正常运行，将.env文件中的CI_ENVIRONMENT参数设置为development开启调试模式，即可看到具体的错误信息定位问题。

内容的提问来源于stack exchange，提问作者Sinan Sarıkaya