欢迎使用 Flask — Flask 0.10.1 documentation
欢迎阅读 Flask 文档。本文档由很多部分构成。我强烈推荐你们从 安装 开始,接着可以浏览下 快速入门。比起快速入门( 快速入门 ),教程 内容更详细一些,该文档介绍了如何创建一个完整(尽管很小)的 Flask 应用。如果你想要深入研究 Flask 的话,可以查看 API 。在 Flask 范例 章节中描述一些常见的模式。
Flask 依赖着两个外部库: Jinja2 模板引擎以及 Werkzeug WSGI 工具集。本文档并不包含这两个库的文档,查看它们的文档请移步:
Jinja2 文档
Werkzeug 文档
用户指南
这部分的文档比较松散,以介绍 Flask 背景开始,然后集中阐述了用 Flask 进行 web 开发的步骤。
前言
什么是 “微”?
配置和约定
与 Flask 共同成长
给经验丰富的程序员的前言
Flask 中的本地线程
小心翼翼地进行 Web 开发
Python 3 的状况
安装
virtualenv
全局安装
体验最新的 Flask (Living on the Edge)
Windows 下的 pip 和 distribute
快速入门
一个最小的应用
调试模式
路由
静态文件
渲染模板
接收请求数据
重定向和错误
关于响应
会话
消息闪烁
日志
整合 WSGI 中间件
部署到 Web 服务器
教程
介绍 Flaskr
Step 0: 创建文件夹
Step 1: 数据库模式
Step 2: 应用设置代码
Step 3: 创建数据库
Step 4: 请求数据库连接
Step 5: 视图函数
Step 6: 模版
Step 7: 添加样式
福利: 测试应用
模版
Jinja 配置
标准上下文
标准过滤器
控制自动转义
注册过滤器
上下文处理器
测试 Flask 应用
应用程序
测试骨架
第一个测试
登录和注销
测试添加消息
其它测试技巧
伪造资源和上下文
保持上下文
访问和修改会话
记录应用程序错误
错误邮件
记录到一个文件中
控制日志格式
其它的库
调试应用程序错误
有疑问时,手动运行
使用调试器
配置处理
基本配置
内置的配置值
从文件中配置
配置最佳实践
开发/生产
示例文件夹
信号
订阅信号
创建信号
发送信号
信号与 Flask 的请求上下文
基于信号订阅的装饰器
核心信号
插拨式视图
基本规则
方法提示
基于调度的方法
装饰视图
用于 APIs 的方法视图
应用上下文
应用上下文目的
创建一个应用上下文
应用上下文的局部变量
应用上下文的用法
请求上下文
深入与上下文本地变量
上下文如何工作
回调和错误
销毁回调
代理注意事项
错误时上下文保存
用蓝图实现模块化应用
为什么用蓝图?
蓝图的概念
第一个蓝图
注册蓝图
蓝图资源
构建 URLs
Flask 扩展
查找扩展
使用扩展
Flask 0.8 以前的 Flask
在 Shell 中使用 Flask
创建一个请求上下文
在请求之前/之后使用 shell
进一步提升 Shell 体验
Flask 范例
大型应用
应用工厂
应用调度
实现 API 异常
URL 处理器
使用 Distribute 部署
使用 Fabric 部署
在 Flask 中使用 SQLite 3
在 Flask 中使用 SQLAlchemy
上传文件
缓存
视图装饰器
使用 WTForms 进行表单验证
模板继承
消息闪现
用 jQuery 实现 Ajax
自定义出错页面
惰性载入视图
在 Flask 中使用 MongoKit
添加一个页面图标
数据流
延迟请求回调
添加 HTTP Method Overrides
请求内容校验
基于后台作业的 Celery
部署方式
mod_wsgi (Apache)
独立 WSGI 容器
uWSGI
FastCGI
CGI
大型应用
阅读源代码
挂接,扩展
继承
用中间件包装
派生
专家级的伸缩性
与社区沟通
API参考
如果你在寻找一个特定函数、类或方法的信息,那么这部分文档就是为你准备的。
API
应用对象
蓝图对象
传入请求数据
响应对象
会话
会话接口
测试客户端
应用全局变量
有用的函数和类
消息闪现
JSON 支持
渲染模版
配置
扩展
流辅助函数
有用的内部函数
信号
基于类的视图
URL 路由注册
视图函数选项
其它材料
这部分文档包含:设计说明,法律信息以及变更记录,有兴趣的读者可以参看。
Flask 中的设计决策
显式的应用对象
路由系统
某个模板引擎
微与依赖
线程局域变量
Flask 是什么,不是什么?
HTML/XHTML 常见问题
XHTML 的历史
HTML5 的历史
HTML 对 XHTML
“严格”意味着什么?
HTML5 中的新技术
应该使用什么?
安全注意事项
跨站脚本攻击(XSS)
跨站请求伪造(CSRF)
JSON 安全
Flask 中的 Unicode
自动转换
金科玉律
自行编解码
配置编辑器
Flask 扩展开发
剖析扩展
“Hello Flaskext!”
初始化扩展
扩展的代码
使用 _app_ctx_stack
销毁行为
他山之玉,可以攻石
已审核的扩展
扩展导入的过渡
Pocoo 风格指引
总体布局
表达式和语句
命名约定
文档字符串
注释
Python 3 支持
要求
API 稳定性
用户少
小生态系统
建议
Upgrading to Newer Releases
Version 0.10
Version 0.9
Version 0.8
Version 0.7
Version 0.6
Version 0.5
Version 0.4
Version 0.3
Flask 更新历史
Version 1.0
Version 0.10.2
Version 0.10.1
Version 0.10
Version 0.9
Version 0.8.1
Version 0.8
Version 0.7.3
Version 0.7.2
Version 0.7.1
Version 0.7
Version 0.6.1
Version 0.6
Version 0.5.2
Version 0.5.1
Version 0.5
Version 0.4
Version 0.3.1
Version 0.3
Version 0.2
Version 0.1
许可证
作者
通用许可证定义
Flask 许可证
Flask 插图许可证
参考