staticfiles 应用

StaticFilesStorage

class storage.StaticFilesStorage

FileSystemStorage 存储后端的一个子类，分别使用 STATIC_ROOT 配置作为基础文件系统位置和 STATIC_URL 配置作为基础 URL。

storage.StaticFilesStorage.post_process(paths, **options)

如果这个方法定义在一个存储上，那么在每次运行后都会被 collectstatic 管理命令调用，并得到本地存储空间和找到的文件路径作为一个字典，以及命令行选项。它产生的元组有三个值。original_path, processed_path, processed。路径值是字符串，processed 是一个布尔值，表示该值是否经过后处理，如果后处理失败则表示异常。

ManifestStaticFilesStorage 在幕后使用它将路径替换为它们的哈希对应物，并适当地更新缓存。

ManifestStaticFilesStorage

class storage.ManifestStaticFilesStorage

StaticFilesStorage 存储后台的一个子类，它通过在文件名上附加文件内容的 MD5 哈希值来存储它处理的文件名。例如，文件 css/styles.css 也会被保存为 css/styles.55e7cbb9ba48.css。

这个存储的目的是为了继续服务于旧文件，以防某些页面仍然引用这些文件，例如，因为它们被你或第三方代理服务器缓存了。此外，如果你想在部署的文件上应用 远期失效头信息 ，以加快后续页面访问的加载时间，它是非常有用的。

存储后端会自动将保存的文件中发现的与其他保存的文件相匹配的路径替换为缓存副本的路径（使用 post_process() 方法）。用于查找这些路径的正则表达式（ django.contrib.staticfiles.storage.HashedFilesMixin.pattern ）涵盖。

• 层叠样式表的 @import 规则和 url() 语句。
• Source map comments in CSS and JavaScript files.

例如，'css/styles.css' 文件有这样的内容：

@import url("../admin/css/base.css");

...将通过调用 ManifestStaticFilesStorage 存储后端的 url() 方法来替代，最终保存一个 css/styles.55e7cbb9ba48.css 文件，内容如下：

@import url("../admin/css/base.27e20196a850.css");

您可以通过使用自定义的 ManifestStaticFilesStorage 子类，设置 manifest_storage 参数来改变清单文件的位置。例如：

from django.conf import settings
from django.contrib.staticfiles.storage import (
    ManifestStaticFilesStorage, StaticFilesStorage,
)

class MyManifestStaticFilesStorage(ManifestStaticFilesStorage):
    def __init__(self, *args, **kwargs):
        manifest_storage = StaticFilesStorage(location=settings.BASE_DIR)
        super().__init__(*args, manifest_storage=manifest_storage, **kwargs)

storage.ManifestStaticFilesStorage.max_post_process_passes

由于静态文件可能会引用其他需要替换路径的静态文件，因此可能需要多次替换路径，直到文件哈希值收敛。为了防止由于哈希值不收敛而导致无限循环（例如，如果 'foo.css' 引用 'bar.css'，而后者引用 'foo.css'），在放弃后处理之前有一个最大的传递次数。在引用数量较多的情况下，可能需要更多的传递次数。通过子类 ManifestStaticFilesStorage 并设置 max_post_process_passes 属性来增加最大传递次数。默认值为 5。

要启用 ManifestStaticFilesStorage，你必须确保满足以下要求：

• STATICFILES_STORAGE 设置为 'django.contrib.staticfiles.storage.ManifestStaticFilesStorage'
• DEBUG 设置为 False
• 通过使用 collectstatic 管理命令，你已经收集了所有静态文件

由于在运行时创建 MD5 哈希可能会给网站带来性能负担，staticfiles 会自动将所有处理过的文件的哈希名映射存储在一个名为 staticfiles.json 的文件中。当你运行 collectstatic 管理命令时就会发生一次。

storage.ManifestStaticFilesStorage.manifest_strict

如果在运行时在 staticfiles.json 清单中没有找到文件，就会引发 ValueError。这种行为可以通过子类 ManifestStaticFilesStorage 并将 manifest_strict 属性设置为 False 来禁止，不存在的路径将保持不变。

由于需要运行 collectstatic，在运行测试时通常不应该使用这个存储，因为 collectstatic 并不是作为正常测试配置的一部分来运行的。在测试过程中，确保将 STATICFILES_STORAGE 设置为类似 'django.contrib.staticfiles.storage.StaticFilesStorage' （默认）这样的其他配置。

storage.ManifestStaticFilesStorage.file_hash(name, content=None)

创建文件的哈希名时使用的方法。需要返回给定文件名和内容的哈希值。默认情况下，它从上面提到的内容块中计算出一个 MD5 哈希。可以随意覆盖这个方法，使用自己的哈希算法。

ManifestFilesMixin

class storage.ManifestFilesMixin

使用这个混入和一个自定义的存储来附加文件内容的 MD5 哈希到文件名中，就像 ManifestStaticFilesStorage 那样。