背景与问题阐述
在许多应用场景中，文件通常通过直接链接供用户下载，例如 https://exampledomain.com/files/file.pdf。然而，当我们需要对这些下载行为进行统计、日志记录或执行其他预处理逻辑时，直接的文件访问会绕过服务器端的 PHP 脚本，导致无法捕获相关信息。例如，使用像 iNamik/PHP-Download-Tracker 这样的下载追踪脚本时，如果用户通过 index.php（或 download.php）点击文件进行下载，脚本可以正常记录；但如果用户直接访问 /files/file.pdf，则追踪脚本会被绕过，日志功能失效。
我们的目标是，即使是直接访问文件链接，也能让请求自动重写到 PHP 追踪脚本，例如将 https://exampledomain.com/files/file.pdf 内部重写为 https://exampledomain.com/files/download.php?file=file.pdf，从而确保每次下载都能被追踪和记录。
解决方案：利用 Apache mod_rewrite
Apache 的 mod_rewrite 模块提供了强大的 URL 重写功能，可以通过 .htaccess 文件在目录级别进行配置。我们将利用这一特性来实现下载链接的自动重写。
1. 前提条件
在开始配置之前，请确保以下条件已满足：
Apache 服务器已安装并运行。
mod_rewrite 模块已启用。 通常在 Apache 配置文件中通过 a2enmod rewrite 命令（Debian/Ubuntu）或取消注释 LoadModule rewrite_module modules/mod_rewrite.so 来启用。
-
目标目录允许 .htaccess 文件覆盖。 在 Apache 站点的配置文件（例如 httpd.conf 或虚拟主机配置）中，确保下载文件所在的目录（例如 /var/www/html/files/）的 Directory 配置中包含 AllowOverride All。
Options Indexes FollowSymLinks AllowOverride All Require all granted PHP 下载追踪脚本已就绪。 假设您的追踪脚本名为 download.php，并位于下载文件所在的目录（例如 /files/）。此脚本应能接收 file 参数，处理下载，并进行日志记录。
2. .htaccess 配置示例
在您的文件下载目录（例如 public_html/files/）中创建一个名为 .htaccess 的文件，并添加以下内容：
RewriteEngine On RewriteBase /files/ RewriteRule ^(.+(file|FILE))$ download.php?file=$1 [L]
3. 配置详解
RewriteEngine On: 这一指令用于开启 mod_rewrite 重写引擎。它是使用任何重写规则的前提。
RewriteBase /files/: 这一指令设置了重写规则的基础 URL 路径。如果您的 .htaccess 文件位于 https://exampledomain.com/files/ 对应的服务器文件系统路径下，那么 RewriteBase /files/ 告诉 Apache，后续的 RewriteRule 匹配的是 /files/ 之后的路径部分。例如，当访问 https://exampledomain.com/files/file.pdf 时，RewriteRule 将会针对 file.pdf 进行匹配。
-
RewriteRule ^(.+(file|FILE))$ download.php?file= [L]: 这是核心的重写规则。
-
^(.+(file|FILE))$: 这是一个正则表达式。
- ^: 匹配字符串的开始。
- (.+(file|FILE)): 这是一个捕获组 (())。它匹配任意字符 (.) 出现一次或多次 (+)，紧接着是 file 或 FILE。这意味着这个规则会匹配像 myfile、anotherFILE 这样的文件名。$1 将引用这个捕获到的完整文件名。
- $: 匹配字符串的结束。
- 重要提示：原始答案中的这个正则表达式 ^(.+(file|FILE))$ 旨在匹配以 file 或 FILE 结尾的文件名。然而，根据您问题中提供的示例 file.pdf，此规则可能无法达到预期效果，因为它不会匹配带有常见文件扩展名的文件。
-
通用化重写规则建议： 为了更通用地匹配所有文件（除了 download.php 自身），并将其重写到 download.php 脚本，我们建议使用更灵活的正则表达式。如果您希望匹配任何带有扩展名的文件，可以考虑使用以下规则：
RewriteRule ^([^/]+\.[a-zA-Z0-9]+)$ download.php?file=$1 [L]
此规则会匹配 files/ 目录下所有包含扩展名的文件（如 file.pdf, document.docx, archive.zip 等），并将其文件名作为 file 参数传递给 download.php。
或者，如果您希望捕获所有非 download.php 的请求并将其视为文件下载：
RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule ^(?!download\.php)(.+)$ download.php?file=$1 [L,QSA]这个更高级的规则：
- RewriteCond %{REQUEST_FILENAME} !-f: 确保请求的不是一个真实存在的文件。
- RewriteCond %{REQUEST_FILENAME} !-d: 确保请求的不是一个真实存在的目录。
- ^(?!download\.php)(.+)$: 匹配任何不是 download.php 开头的字符串，并捕获其余部分。
- [L]: Last 标志，表示如果此规则匹配成功，则停止处理其他重写规则。
- [QSA]: Query String Append 标志，表示将原始请求中的查询字符串附加到重写后的 URL 后面。
在大多数情况下，如果 download.php 位于 RewriteBase 目录下，并且您想追踪所有其他文件的直接访问，最简单且有效的规则是：
RewriteRule ^(?!download\.php)(.+)$ download.php?file=$1 [L]
这个规则会捕获所有不以 download.php 开头的请求路径，并将其作为 $1 传递给 download.php。
download.php?file=$1: 这是重写的目标 URL。$1 是正则表达式中第一个捕获组匹配到的内容，即文件名。这样，当用户访问 file.pdf 时，服务器内部会将其处理为对 download.php?file=file.pdf 的请求。
[L]: Last 标志。这个标志告诉 mod_rewrite，如果当前规则匹配成功，则停止处理后续的重写规则。这对于避免不必要的循环或冲突非常重要。
-
4. 完整示例（推荐的通用规则）
考虑到实际应用中对各种文件类型的追踪需求，以下是一个更通用且推荐的 .htaccess 配置：
RewriteEngine On RewriteBase /files/ # 排除 download.php 自身，避免无限重写循环 # 匹配所有非 download.php 的请求，并将其作为文件参数传递 RewriteRule ^(?!download\.php)(.+)$ download.php?file=$1 [L]
5. 注意事项与最佳实践
- 测试重写规则: 在生产环境部署前，务必在开发或测试环境中充分测试重写规则。可以使用在线 .htaccess 测试工具或通过 Apache 的 RewriteLog 和 RewriteLogLevel 进行调试。
- 性能考量: 过多的或复杂的重写规则可能会对服务器性能产生轻微影响。尽量保持规则简洁高效。
- 安全性: 确保 download.php 脚本对传入的文件名参数进行严格的验证和过滤，以防止路径遍历、文件包含等安全漏洞。不要直接使用 $file 参数来构造文件路径，而是要验证它是否是允许下载的文件之一。
- 日志目录保护: 确保您的日志目录（如果存在）不被 Web 服务器直接访问。可以通过 .htaccess 文件在日志目录中添加 Deny From All 来实现。
- 用户体验: 重写是服务器内部操作，用户在浏览器地址栏看到的仍然是原始的直接下载链接，这符合用户预期。
总结
通过在文件下载目录中配置 .htaccess 文件，并利用 Apache mod_rewrite 模块，我们可以有效地将所有直接文件下载链接重写到 PHP 下载追踪脚本。这不仅解决了直接下载绕过日志系统的问题，还为收集下载统计数据、实现权限控制或其他自定义逻辑提供了基础。选择合适的正则表达式是实现这一目标的关键，建议使用更通用的规则来覆盖所有预期的文件下载场景。
