Docker-PHP项目中Unit容器的PHP文件解析问题分析与解决方案

问题背景

在使用serversideup/docker-php项目的Unit容器镜像时，开发人员发现了一个关于PHP文件处理的配置问题。默认配置下，只有index.php文件能够被正确解析执行，而其他PHP文件会被直接下载而非执行。这显然不符合PHP应用的常规需求，特别是对于现代PHP框架如Laravel等，通常需要处理多种PHP文件请求。

问题分析

Unit作为轻量级应用服务器，其PHP处理能力需要通过精确的JSON配置来实现。原配置存在以下不足：

1. 路由规则过于简单，仅处理根路径和index.php
2. 缺少对.php扩展名的显式处理规则
3. 静态文件处理和动态PHP处理的优先级设置不当

解决方案

经过社区讨论和测试，我们提出以下改进配置方案：

{
  "listeners": {
    "*:8080": {
      "pass": "routes",
      "forwarded": {
        "client_ip": "X-Forwarded-For",
        "protocol": "X-Forwarded-Proto",
        "recursive": false,
        "source": [
          "172.16.0.0/12"
        ]
      }
    }
  },
  "routes": [
    {
      "match": {
        "uri": "/healthcheck"
      },
      "action": {
        "return": 200
      }
    },
    {
      "match": {
        "uri": [
          "/",
          "*.php",
          "*.php/*"
        ]
      },
      "action": {
        "pass": "applications/php/direct"
      }
    },
    {
      "action": {
        "share": "/var/www/html/public$uri",
        "fallback": {
          "pass": "applications/php/index"
        }
      }
    }
  ],
  "applications": {
    "php": {
      "type": "php",
      "processes": {
        "max": 5,
        "spare": 1,
        "idle_timeout": 30
      },
      "targets": {
        "index": {
          "root": "/var/www/html/public/",
          "script": "index.php"
        },
        "direct": {
          "root": "/var/www/html/public/",
          "index": "index.php"
        }
      }
    }
  }
}

配置详解

1. 路由规则优化：

   • 添加了对.php和.php/*路径的显式匹配规则
   • 将PHP处理分为直接处理(direct)和索引处理(index)两种模式
   • 保留了静态文件分享功能，并设置了回退到index.php的机制

2. 应用目标定义：

   • direct目标用于直接处理PHP文件请求
   • index目标用于处理前端控制器模式的请求(如Laravel的路由)

3. 健康检查端点：

   • 保留了/healthcheck端点用于容器健康检查

注意事项

1. 此配置假设项目使用public目录作为Web根目录，这是现代PHP框架的常见做法
2. 对于目录访问(index.php自动加载)需要显式配置URI规则
3. 静态文件处理优先级低于PHP文件处理，确保.php请求不会被当作静态文件

最佳实践建议

1. 对于生产环境，建议添加更多安全相关的配置，如请求限制
2. 根据应用特点调整进程池大小和超时设置
3. 考虑添加对常见前端文件(如.js,.css)的缓存控制头

此解决方案已在社区中得到验证，能够有效解决Unit容器中PHP文件处理不完整的问题，同时保持了对现代PHP框架的良好支持。