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

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

2025-05-29 19:21:33作者:平淮齐Percy

在使用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目录的特殊性,确保容器能够正确访问到框架的入口文件。

登录后查看全文
热门项目推荐
相关项目推荐