webdevops nginx - 从 url 中删除 .php 要求

Question

我有一个基于 webdevops/php-nginx:7.2 的 docker，我正在尝试配置 nginx 以将带有或不带有 .php 扩展名的请求路由到适当的文件。

如果abc.php 存在，我需要/abc 和/abc.php 路由到abc.php。其他一切都将转到index.php

当前设置如下：

Dockerfile 包含

WEB_DOCUMENT_ROOT=/app/public
COPY docker/opt/docker/etc /opt/docker/etc/

opt/docker/etc/nginx/conf.d/10-location-root.conf

server {
  index index.html index.php;
  location / {
    try_files $uri $uri/ /index.php?_url=$uri&$args;
  }
}

/app/public 包含

index.php
abc.php

目前，此配置将所有内容路由到 index.php，/abc.php 除外。尝试将/abc 路由到index.php。

谢谢:)

编辑：使用 Ivan 的回答 docker 记录垃圾邮件：

app_1  | -> Executing /opt/docker/bin/service.d/nginx.d//10-init.sh
app_1  | 2020-10-20 10:31:59,273 INFO success: nginxd entered RUNNING state, process has stayed up for > than 0 seconds (startsecs)
app_1  | nginx: [emerg] unknown "_uri" variable
app_1  | 2020-10-20 10:31:59,287 INFO exited: nginxd (exit status 1; not expected)

Answer 1

如果我正确理解了这个系统是如何工作的，让我们从以下两个文件开始：

• /opt/docker/etc/nginx/vhost.common.d/10-location-root.conf

location / {
    try_files $uri $uri/ @extensionless-php;
}
location @extensionless-php {
    rewrite ^ $uri.php last;
}

• /opt/docker/etc/nginx/vhost.common.d/10-php.conf

location ~ \.php$ {
    try_files $uri /<DOCUMENT_INDEX>?_url=$uri&$args;
    fastcgi_pass php;
    include fastcgi_params;
    fastcgi_param SCRIPT_FILENAME $request_filename;
    fastcgi_read_timeout <PHP_TIMEOUT>;
}

上述配置有一个严重缺陷。如果请求的 URI 不是现有 PHP 文件的名称（带有或不带有 .php 扩展名），则 $uri 内部 nginx 变量值将始终以 .php 结尾，因为 rewrite 规则在@extensionless-php 命名位置。这将导致以下结果（假设文件 /app/public/some/path.php 不存在）：

/some/path => /index.php?_url=/some/path.php

/some/path.php => /index.php?_url=/some/path.php

要解决这个问题，我们可以将原始的 $uri 变量值保存在 extensionless-php 命名位置中：

• /opt/docker/etc/nginx/vhost.common.d/10-location-root.conf

location / {
    try_files $uri $uri/ @extensionless-php;
}
location @extensionless-php {
    set $original_uri $uri;
    rewrite ^ $uri.php last;
}

• /opt/docker/etc/nginx/vhost.common.d/10-php.conf

location ~ \.php$ {
    try_files $uri /<DOCUMENT_INDEX>?_url=$original_uri&$args;
    fastcgi_pass php;
    include fastcgi_params;
    fastcgi_param SCRIPT_FILENAME $request_filename;
    fastcgi_read_timeout <PHP_TIMEOUT>;
}

这个配置比较好，但还是有缺陷。如果请求的 URI 以 .php 结尾并且在 /app/public 目录中没有对应的 PHP 文件，则不会初始化 $original_uri 变量，并且 _url 查询参数将作为空字符串传递给后端：

/some/path => /index.php?_url=/some/path

/some/path.php => /index.php?_url=

这对于某些 Web 应用程序来说是可以的（空的 _url 查询参数总是意味着一个无效的路由），但是如果我们想要得到一个原始的 URI，我们必须做什么呢？我们可以借助 map 指令（一个非常强大的 nginx 功能）来实现它。但是所有的map 块都应该在server 块之外声明，所以我们需要一个额外的文件：

• /opt/docker/etc/nginx/conf.d/10-map.conf

map $_uri $original_uri {
    ""          $uri;
    default     $_uri;
}

• /opt/docker/etc/nginx/vhost.common.d/10-location-root.conf

location / {
    try_files $uri $uri/ @extensionless-php;
}
location @extensionless-php {
    set $_uri $uri;
    rewrite ^ $uri.php last;
}

• /opt/docker/etc/nginx/vhost.common.d/10-php.conf

location ~ \.php$ {
    try_files $uri /<DOCUMENT_INDEX>?_url=$original_uri&$args;
    fastcgi_pass php;
    include fastcgi_params;
    fastcgi_param SCRIPT_FILENAME $request_filename;
    fastcgi_read_timeout <PHP_TIMEOUT>;
}

这个map 块意味着$original_uri 变量将等于$uri，如果它没有被修改（$_uri 变量没有初始化并且为空）。如果$_uri 变量不为空，则意味着原始$uri 已修改，$_uri 变量现在保持其原始值，因此$original_uri 变量的值将设置为$_uri。此配置适用于将原始 URI 保留为 _url 查询参数的任何请求。