FrankenPHP 容器运行404问题排查指南

在使用FrankenPHP容器时，开发者可能会遇到404 Not Found错误，这通常是由于目录映射配置不当导致的。本文将详细分析问题原因并提供解决方案。

问题现象

当开发者执行标准容器运行命令时：

docker run -v $PWD:/app/public -p 443:443 dunglas/frankenphp

访问https://localhost会出现404错误，服务器响应头显示为Caddy服务器。即使添加了测试文件如test.txt，访问该文件同样返回404。

原因分析

FrankenPHP是Caddy服务器的定制版本，内置了PHP模块，因此在响应头中看到Caddy标识是正常现象。出现404错误的根本原因是目录映射配置不正确。

解决方案

根据不同的PHP项目类型，需要采用不同的目录映射方式：

1. 对于简单PHP项目： 如果项目直接使用根目录作为文档根目录，保持原命令不变但确保目录路径正确。

2. 对于框架项目(Laravel/Symfony等)： 大多数PHP框架使用public子目录作为文档根目录，因此需要调整映射：

   docker run -v $PWD:/app -p 443:443 dunglas/frankenphp
   

   这样配置后，框架的public目录将自动被识别为文档根目录。

验证方法

成功配置后，可以通过以下方式验证：

1. 创建一个简单的phpinfo.php文件
2. 访问https://localhost/phpinfo.php
3. 应该能看到PHP信息页面而非404错误

总结

FrankenPHP容器使用中遇到404问题时，首要检查点是目录映射配置。理解项目结构并正确设置文档根目录是解决问题的关键。对于框架项目，特别注意public目录的特殊性，确保容器能够正确访问到框架的入口文件。