staticfiles 应用

collectstatic

django-admin collectstatic

将静态文件收集到 STATIC_ROOT 中。

重复的文件名默认的解析方式与模板解析的方式类似：首先在指定位置找到的文件将被使用。如果你感到困惑， findstatic 命令可以帮助你显示哪些文件被找到。

在随后运行 collectstatic 时（如果 STATIC_ROOT 不是空的），只有当文件的修改时间戳大于 STATIC_ROOT 中文件的时间戳时，才会被复制。因此，如果你从 INSTALLED_APPS 中删除一个应用程序，最好使用 collectstatic --clear 选项来删除过时的静态文件。

通过使用 启用的查找器 搜索文件。默认情况是在 STATICFILES_DIRS 中定义的所有位置和 INSTALLED_APPS 配置指定的应用程序的 'static' 目录中查找。

collectstatic 管理命令在每次运行后调用 staticfiles 存储后端的 post_process() 方法，并传递由管理命令找到的路径列表。它还接收 collectstatic 的所有命令行选项。默认情况下，这由 ManifestStaticFilesStorage 使用。

默认情况下，收集的文件从 FILE_UPLOAD_PERMISSIONS 中获得权限，收集的目录从 FILE_UPLOAD_DIRECTORY_PERMISSIONS 中获得权限。如果你希望这些文件和／或目录有不同的权限，你可以将 静态文件存储类 中的任何一个子类化，并分别指定 file_permissions_mode 和／或 directory_permissions_mode 参数。例如：

from django.contrib.staticfiles import storage

class MyStaticFilesStorage(storage.StaticFilesStorage):
    def __init__(self, *args, **kwargs):
        kwargs["file_permissions_mode"] = 0o640
        kwargs["directory_permissions_mode"] = 0o760
        super().__init__(*args, **kwargs)

然后在 STORAGES 设置中将 staticfiles 存储后端设置为 'path.to.MyStaticFilesStorage'。

一些常用的选项是：

--noinput, --no-input

不要提示用户进行任何形式的输入。

--ignore PATTERN, -i PATTERN

忽略与此 glob 样式模式匹配的文件、目录或路径。多次使用可以忽略更多的文件、目录或路径。当指定路径时，始终使用正斜线，即使在 Windows 上也是如此。

--dry-run, -n

除了修改文件系统外，其他都要做。

--clear, -c

在尝试复制或链接原始文件之前，先清除现有文件。

--link, -l

为每个文件创建一个符号链接，而不是复制。

--no-post-process

不要从 STORAGES 中配置的 staticfiles 存储后端调用 post_process() 方法。

--no-default-ignore

不要忽视常见的私有 glob 样式模式 'CVS'、'.*' 和 '*~'。

完整的选项列表，请参考命令本身的帮助，运行：

$ python manage.py collectstatic --help

...\> py manage.py collectstatic --help

from django.contrib.staticfiles.apps import StaticFilesConfig

class MyStaticFilesConfig(StaticFilesConfig):
    ignore_patterns = [...]  # your custom ignore list

findstatic

django-admin findstatic staticfile [staticfile ...]

通过启用的查找器搜索一个或多个相对路径。

例如：

$ python manage.py findstatic css/base.css admin/js/core.js
Found 'css/base.css' here:
  /home/special.polls.com/core/static/css/base.css
  /home/polls.com/core/static/css/base.css
Found 'admin/js/core.js' here:
  /home/polls.com/src/django/contrib/admin/media/js/core.js

...\> py manage.py findstatic css\base.css admin\js\core.js
Found 'css/base.css' here:
  /home/special.polls.com/core/static/css/base.css
  /home/polls.com/core/static/css/base.css
Found 'admin/js/core.js' here:
  /home/polls.com/src/django/contrib/admin/media/js/core.js

findstatic --first

默认情况下，会找到所有匹配的位置。要只返回每个相对路径的第一个匹配点，请使用 --first 选项：

$ python manage.py findstatic css/base.css --first
Found 'css/base.css' here:
  /home/special.polls.com/core/static/css/base.css

...\> py manage.py findstatic css\base.css --first
Found 'css/base.css' here:
  /home/special.polls.com/core/static/css/base.css

这是一个调试辅助工具，它会告诉你到底哪个静态文件会被收集到一个给定的路径。

通过将 --verbosity 标志设置为 0，你可以抑制额外的输出，只获取路径名：

$ python manage.py findstatic css/base.css --verbosity 0
/home/special.polls.com/core/static/css/base.css
/home/polls.com/core/static/css/base.css

...\> py manage.py findstatic css\base.css --verbosity 0
/home/special.polls.com/core/static/css/base.css
/home/polls.com/core/static/css/base.css

另一方面，通过将 --verbosity 标志设置为 2，可以得到所有被搜索的目录。

$ python manage.py findstatic css/base.css --verbosity 2
Found 'css/base.css' here:
  /home/special.polls.com/core/static/css/base.css
  /home/polls.com/core/static/css/base.css
Looking in the following locations:
  /home/special.polls.com/core/static
  /home/polls.com/core/static
  /some/other/path/static

...\> py manage.py findstatic css\base.css --verbosity 2
Found 'css/base.css' here:
  /home/special.polls.com/core/static/css/base.css
  /home/polls.com/core/static/css/base.css
Looking in the following locations:
  /home/special.polls.com/core/static
  /home/polls.com/core/static
  /some/other/path/static

runserver

django-admin runserver [addrport]

如果 staticfiles 应用程序被 installed，则覆盖核心 runserver 命令，并增加静态文件的自动服务。文件服务不通过 MIDDLEWARE 运行。

该命令增加了这些选项：

--nostatic

使用 --nostatic 选项来完全禁止使用 静态文件 应用程序提供静态文件。只有当 静态文件 应用在你的项目的 INSTALLED_APPS 配置中时，这个选项才可用。

使用实例：

$ django-admin runserver --nostatic

...\> django-admin runserver --nostatic

--insecure

使用 --insecure 选项来强制使用 静态文件 应用服务静态文件，即使 DEBUG 设置为 False。通过使用这个选项，你承认了这样的事实，即这是 效率低下的，而且可能是 不安全的。这仅用于本地开发，不应在生产中使用，并且只有当 静态文件 应用在你的项目的 INSTALLED_APPS 设置中时才可用。

--insecure 不能与 ManifestStaticFilesStorage 一起工作。

使用实例：

$ django-admin runserver --insecure

...\> django-admin runserver --insecure

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() 语句。

• CSS 和 JavaScript 文件中的 源映射 (source map) 注释。

如果您想要使用实验性的正则表达式来覆盖，可以子类化 ManifestStaticFilesStorage 并将 support_js_module_import_aggregation 属性设置为 True：

• JavaScript 中的 模块导入 (modules import)。

• JavaScript 中的 模块聚合 (modules aggregation)。

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

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

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

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