如何在Nginx中仅为特定PHP文件添加响应头？

问题背景 #

现有Nginx配置中已存在匹配所有PHP文件的location块，需要仅为某个特定PHP文件添加响应头。尝试在全局PHP块内嵌套更具体的location块，但添加的响应头无效；若直接在全局PHP块中添加响应头，会作用于所有PHP文件。相关尝试的配置如下：

location ~ \.php$ {

    location ~ ( /another/location/script.php ?? ) {
        add_header Access-Control-Allow-Origin *;
    }

    include snippets/fastcgi-php.conf;
    fastcgi_pass unix:/run/php/php8.1-fpm.sock;

} 

问题原因 #

嵌套location无法生效的核心原因是：当Nginx匹配到子location后，会优先执行子location内的配置，但你的子location中没有包含处理PHP请求的fastcgi相关指令，导致请求无法正确转发到PHP-FPM完成处理，响应头自然无法被添加到最终的响应中。此外，嵌套location的设计场景并非用于这种URI精准匹配的需求。

解决方案 #

方案一：使用if指令精准匹配URI #

在全局PHP location块内，通过if指令匹配目标文件的请求URI，仅在匹配时添加响应头。这种方式无需额外拆分location，配置更紧凑：

location ~ \.php$ {
    # 精准匹配目标PHP文件的请求路径
    if ($request_uri = /another/location/script.php) {
        add_header Access-Control-Allow-Origin *;
    }

    include snippets/fastcgi-php.conf;
    fastcgi_pass unix:/run/php/php8.1-fpm.sock;
}

方案二：独立配置特定文件的location块 #

利用Nginx location的匹配优先级，将目标PHP文件的精确匹配location放在全局PHP location之前。=前缀表示精确匹配，优先级高于正则匹配，能确保该文件的请求被单独处理：

# 精确匹配目标PHP文件，优先级最高
location = /another/location/script.php {
    add_header Access-Control-Allow-Origin *;
    include snippets/fastcgi-php.conf;
    fastcgi_pass unix:/run/php/php8.1-fpm.sock;
}

# 处理其余所有PHP文件的请求
location ~ \.php$ {
    include snippets/fastcgi-php.conf;
    fastcgi_pass unix:/run/php/php8.1-fpm.sock;
}

注意事项 #

• 使用if指令时，仅用于简单的相等匹配是安全的，避免在if内编写复杂逻辑（Nginx的if并非完全符合预期的条件判断）。
• 第二种方案的精确匹配方式性能更优，且逻辑更清晰，推荐用于明确的单个文件匹配场景。

内容的提问来源于stack exchange，提问作者RDU