Thumbor 项目教程

1. 项目的目录结构及介绍

Thumbor 项目的目录结构如下：

thumbor/
├── Dockerfile
├── LICENSE
├── README.md
├── docker-compose.yml
├── docs/
├── setup.py
├── thumbor/
│   ├── __init__.py
│   ├── app.py
│   ├── config.py
│   ├── handlers/
│   ├── loaders/
│   ├── result_storages/
│   ├── storages/
│   ├── transformers/
│   └── utils/
├── tests/
└── requirements.txt

目录结构介绍

• Dockerfile 和 docker-compose.yml：用于 Docker 部署。
• LICENSE：项目的开源许可证。
• README.md：项目的基本介绍和使用说明。
• docs/：项目的文档目录。
• setup.py：项目的安装脚本。
• thumbor/：项目的主要代码目录。
  • __init__.py：初始化文件。
  • app.py：项目的启动文件。
  • config.py：项目的配置文件。
  • handlers/：处理请求的模块。
  • loaders/：图片加载器模块。
  • result_storages/：结果存储模块。
  • storages/：图片存储模块。
  • transformers/：图片转换模块。
  • utils/：工具模块。
• tests/：测试代码目录。
• requirements.txt：项目依赖的 Python 包列表。

2. 项目的启动文件介绍

项目的启动文件是 thumbor/app.py。这个文件包含了 Thumbor 应用的主要逻辑和启动代码。以下是 app.py 的主要内容：

from thumbor.app import ThumborServiceApp
from thumbor.context import Context
from thumbor.config import Config

def main():
    config = Config.load('/path/to/config')
    context = Context(config=config)
    application = ThumborServiceApp(context)
    application.listen(8888)
    application.start()

if __name__ == '__main__':
    main()

启动文件介绍

• ThumborServiceApp：Thumbor 服务的主应用类。
• Context：上下文对象，包含配置和请求信息。
• Config：配置对象，用于加载和解析配置文件。
• main()：主函数，负责加载配置、创建上下文和启动应用。

3. 项目的配置文件介绍

项目的配置文件是 thumbor/config.py。这个文件定义了 Thumbor 的各种配置选项。以下是 config.py 的部分内容：

from thumbor.config import Config

Config.define('MAX_WIDTH', 0, 'Max width in pixels for the image')
Config.define('MAX_HEIGHT', 0, 'Max height in pixels for the image')
Config.define('QUALITY', 80, 'Quality of the image in percent')
Config.define('LOADER', 'thumbor.loaders.http_loader', 'The loader to use to load images')
Config.define('STORAGE', 'thumbor.storages.file_storage', 'The storage to use to store images')
Config.define('RESULT_STORAGE', 'thumbor.result_storages.file_storage', 'The result storage to use to store results')

配置文件介绍

• MAX_WIDTH 和 MAX_HEIGHT：图片的最大宽度和高度。
• QUALITY：图片的质量。
• LOADER：图片加载器。
• STORAGE：图片存储器。
• RESULT_STORAGE：结果存储器。

通过这些配置选项，可以灵活地调整 Thumbor 的行为和性能。