移除PHP扩展名的Firebase Hosting指南

理解Firebase Hosting的cleanUrls机制

Firebase Hosting提供了一个名为cleanUrls的配置选项，其主要目的是为了美化URL，自动移除.html文件的扩展名。当此选项设置为true时，例如，访问https://example.com/contact.html将自动显示为https://example.com/contact。这是Firebase Hosting针对静态HTML内容设计的功能，旨在提供更简洁的用户体验。

在firebase.json中启用此功能的示例如下：

{
  "hosting": {
    "public": "public",
    "cleanUrls": true,
    "trailingSlash": true
  }
}

需要强调的是，cleanUrls功能是硬编码（by design）仅针对.html文件生效的。它不会自动识别并移除.php、.asp、.jsp或其他任何非.html文件的扩展名。

Firebase Hosting对PHP文件的处理方式

Firebase Hosting是一个静态内容托管服务。这意味着它主要用于托管HTML、CSS、JavaScript、图片等静态资源。Firebase Hosting不具备执行PHP代码的能力。 当您将一个.php文件部署到Firebase Hosting时，它会被视为一个普通的静态文件。

这意味着：

1. 代码不被执行： 文件中的PHP代码（例如）不会被服务器解析或执行。
2. 内容以纯文本形式提供： 默认情况下，Firebase Hosting可能会将.php文件的内容作为纯文本（或根据您的配置，如Content-Type: text/html）直接发送给浏览器。浏览器接收到这些内容后，不会将其作为可执行的PHP脚本处理，而是可能直接显示其中的PHP标签和代码，或者根据Content-Type将其渲染为HTML（如果内容本身符合HTML结构）。

用户在firebase.json中配置的以下headers规则，正是为了强制.php文件以HTML的形式呈现：

"headers": [ {
  "source": "*.php",
  "headers": [ {
    "key": "Content-Type",
    "value": "text/html"
  } ]
} ]

此配置使得浏览器在请求*.php文件时，会将其内容解释为HTML，而不是尝试执行PHP脚本。然而，这并不能改变Firebase Hosting不执行PHP代码的本质。

移除.php扩展名的解决方案

鉴于上述特性，移除.php扩展名并使其像cleanUrls一样工作的解决方案取决于您的.php文件是否真的包含PHP代码。

情景一：.php文件不包含PHP代码

如果您的.php文件实际上不包含任何需要PHP解释器执行的代码，例如它只是一个静态的HTML文件，但错误地使用了.php扩展名，那么解决方案非常简单：

将您的.php文件重命名为.html。

例如，将contact.php重命名为contact.html。一旦文件扩展名变为.html，并且您的firebase.json中已设置"cleanUrls": true，Firebase Hosting将自动为您处理URL重写，使https://google.com/contact.html能够通过https://google.com/contact访问。

情景二：.php文件包含PHP代码

如果您的.php文件确实包含需要PHP解释器执行的动态代码，那么Firebase Hosting本身无法直接满足您的需求。在这种情况下，您需要采取以下策略：

1. 使用后端服务： 将PHP代码部署到一个支持PHP运行时的后端服务。这可以是：

   • Google Cloud Functions： 编写PHP函数并通过PHP运行时（如php-fpm结合自定义运行时）执行。
   • Google Cloud Run： 将您的PHP应用打包成Docker容器，并部署到Cloud Run。
   • Compute Engine (VM)： 部署一个完整的Web服务器（如Apache或Nginx）和PHP-FPM环境。

2. Firebase Hosting作为前端代理： 配置Firebase Hosting的rewrites规则，将特定路径的请求代理到您的后端服务。例如：

   {
     "hosting": {
       "public": "public",
       "rewrites": [
         {
           "source": "/api/**",
           "destination": "https://your-cloud-run-service.run.app/api"
         },
         {
           "source": "/contact",
           "destination": "https://your-php-backend-url.com/contact.php"
         }
       ]
     }
   }

   通过这种方式，当用户访问https://google.com/contact时，Firebase Hosting会将其请求转发到您的PHP后端，然后将后端返回的内容呈现给用户。

关于firebase.json中的rewrites规则

用户提供的firebase.json中包含一个rewrites规则：

"rewrites": [
  {
    "source": "**/!(*.css|*.js|*.map|*.jpg|*.gif|*.png|*.php),/post/**",
    "dynamicLinks": true
  }
]

此规则的source属性实际上包含两个以逗号分隔的模式：

1. **/!(*.css|*.js|*.map|*.jpg|*.gif|*.png|*.php)：匹配所有不以.css, .js, .map, .jpg, .gif, .png, .php结尾的路径。
2. /post/**：匹配所有以/post/开头的路径。

这两个模式组合在一起，意味着任何匹配其中之一的请求都将触发此重写规则（此处配置为dynamicLinks: true，用于Firebase动态链接，但通常重写规则会指定一个destination）。

关于合并规则的疑问： 将多个源模式用逗号分隔在一个source字段中是Firebase Hosting支持的写法，表示只要匹配其中任何一个模式，就应用该重写规则。如果这些模式都指向相同的重写目标（例如，都是为了处理动态链接，或者都重写到同一个后端服务），那么合并它们是完全可行的，并且可以使配置更简洁。

然而，需要明确的是，rewrites规则与cleanUrls是两种不同的机制。 rewrites主要用于路径重定向、URL重写或代理到后端服务，它不会自动移除文件扩展名。移除.html扩展名是cleanUrls的特定功能。用户试图通过rewrites规则来移除.php扩展名是行不通的，因为cleanUrls不识别.php。

注意事项与总结

• Firebase Hosting是静态托管服务。 它的核心优势在于快速、安全地提供静态内容。对于需要服务器端逻辑（如PHP）的应用，需要结合其他Google Cloud服务。
• cleanUrls仅适用于.html文件。 如果您的.php文件不含PHP代码，请将其重命名为.html以利用此功能。
• PHP代码执行需要后端。 如果您的应用确实依赖PHP，请考虑使用Cloud Functions、Cloud Run或其他VM实例来运行您的PHP后端，并通过Firebase Hosting的rewrites功能进行集成。
• 仔细区分cleanUrls和rewrites。 它们服务于不同的目的。cleanUrls是针对.html文件扩展名的自动化处理，而rewrites是更通用的URL路径匹配和重写机制。

通过正确理解Firebase Hosting的能力和限制，您可以为您的Web应用选择最合适的架构和配置方案。