06.flask博客项目实战一之项目框架搭建
配套视频教程
1、创建一个目录,名为:microblog;
2、创建虚拟环境
C:\Users\Administrator>d:
D:\>cd D:\microblog
D:\microblog>python -m venv venv
D:\microblog>
3、激活虚拟环境:activate
D:\microblog>cd D:\microblog\venv\Scripts
D:\microblog\venv\Scripts>activate
(venv) D:\microblog\venv\Scripts>
注:退出虚拟环境 deactivate
4、安装Flask:pip install flask
安装指定版本的第三方库可用命令:pip install flask==版本号
(venv) D:\microblog\venv\Scripts>pip install flask
Collecting flask
Using cached https://files.pythonhosted.org/packages/7f/e7/08578774ed4536d3242b14dacb4696386634607af824ea997202cd0edb4b/Flask-1.0.2-py2.py3-none-any.whl
Collecting Werkzeug>=0.14 (from flask)
Using cached https://files.pythonhosted.org/packages/20/c4/12e3e56473e52375aa29c4764e70d1b8f3efa6682bef8d0aae04fe335243/Werkzeug-0.14.1-py2.py3-none-any.whl
Collecting itsdangerous>=0.24 (from flask)
Using cached https://files.pythonhosted.org/packages/dc/b4/a60bcdba945c00f6d608d8975131ab3f25b22f2bcfe1dab221165194b2d4/itsdangerous-0.24.tar.gz
Collecting Jinja2>=2.10 (from flask)
Using cached https://files.pythonhosted.org/packages/7f/ff/ae64bacdfc95f27a016a7bed8e8686763ba4d277a78ca76f32659220a731/Jinja2-2.10-py2.py3-none-any.whl
Collecting click>=5.1 (from flask)
Using cached https://files.pythonhosted.org/packages/34/c1/8806f99713ddb993c5366c362b2f908f18269f8d792aff1abfd700775a77/click-6.7-py2.py3-none-any.whl
Collecting MarkupSafe>=0.23 (from Jinja2>=2.10->flask)
Using cached https://files.pythonhosted.org/packages/4d/de/32d741db316d8fdb7680822dd37001ef7a448255de9699ab4bfcbdf4172b/MarkupSafe-1.0.tar.gz
Installing collected packages: Werkzeug, itsdangerous, MarkupSafe, Jinja2, click, flask
Running setup.py install for itsdangerous ... done
Running setup.py install for MarkupSafe ... done
Successfully installed Jinja2-2.10 MarkupSafe-1.0 Werkzeug-0.14.1 click-6.7 flask-1.0.2 itsdangerous-0.24
可看到会附带安装好:Werkzeug, itsdangerous, MarkupSafe, Jinja2, click。
并可在目录D:\microblogvenv\Lib\site-packages下查看到。
上述重要库对应版本:
库名 | 版本号 | 简要说明 |
---|---|---|
flask | 1.0.2 | 内核 |
werkzeug | 0.14.1 | 核心1,路由模块 |
jinja2 | 2.10 | 核心2,模板引擎 |
itsdangerous | 0.24 | (加密数据)签名模块 |
MarkupSafe | 0.23 | 为Python实现XML / HTML / XHTML 标记安全字符串 |
click | 5.1 | 命令行工具库 |
以上的库均由Armin Ronacher及其Flask团队pallets开发编写。
5、创建一个“Hello,World!” Flask应用程序
0)、该应用程序将存在于一个包(app)中。在Python中,包含init.py文件的子目录被视为包,其可被导入。当导入一个包时,init.py将会执行并定义“暴露”给外部的标识(告诉你们,我是一个包 package)。
在D:\microblog下创建一个目录,名为app。并写一个init.py文件,表明app是一个包 package。
init.py,它将创建Flask应用程序实例,代码如下:
from flask import Flask#从flask包中导入Flask类
app = Flask(__name__)#将Flask类的实例 赋值给名为 app 的变量。这个实例成为app包的成员。
#print('等会谁(哪个包或模块)在使用我:',__name__)
from app import routes#从app包中导入模块routes
#注:上面两个app是完全不同的东西。两者都是纯粹约定俗成的命名,可重命名其他内容。
上述脚本只是创建了一个作为Flask类的实例的应用程序对象,Flask类是从flask包中导入的。传递给Flask类的变量name是一个Python预定义的变量,该变量设置为使用它的模块的名字。可加入一句打印用于理解,如上(不用时注释掉或删除该行代码)。当应用程序运行时,可看到打印的是包 app。
当需要加载如模板文件等相关资源时,Flask将使用此处传递的模块的位置作为起点。
传递的变量name总是以正确的方式配置给Flask。
接着,从包 app中导入模块routes,目前尚未编写它。
还注意到:routes模块是在脚本底部导入,而不是顶部,因为它始终是完成的。底部导入是避免循环导入(circular import)问题的解决方法。在接下来的routes模块中,需要导入这个脚本(init.py)中的变量app,因此将其放置在底部导入,以避免由这俩个文件之间的相互引用引起的error。
1)、routes模块
路由,是处理URL 和函数 之间关系的程序。使用route()装饰器来把函数绑定到URL。
在Flask中,应用程序 路由的处理程序被编写为Python函数,称为 视图函数,例此模块中的index()。 视图函数映射到一个或多个路由URL,以便Flask知道客户端请求给定URL时要执行的逻辑(Python代码)。
app/routes.py代码:
from app import app#从app包中导入 app这个实例
#2个路由
@app.route('/')
@app.route('/index')
#1个视图函数
def index():
return "Hello,World!"#返回一个字符串
@app.route
装饰器 为作为一个参数给定的URL和函数之间创建关联。代码中有两个装饰器,它们共同将URL /
和 /index
关联至index()
函数。这意味着当浏览器这俩个URL中任一个时,Flask将调用此函数(index()
)并将其返回值(字符串)作为响应 Response传递回浏览器。
2)、为完成这个简单的应用程序,还需在顶层 top-level定义一个Flask应用程序实例 的Python脚本,命名为microblog.py,并仅有一行代码,即导入应用程序实例。代码如下:
from app import app#从app包中导入变量app(它是作为app包成员的变量)
目前为止,项目结构图:
microblog/
venv/
app/
__init__.py
routes.py
microblog.py
3)运行程序。
运行之前,设置FLASK_APP
环境变量,它会告诉Flask如何导入刚写的应用程序。
(venv) D:\microblog\venv\Scripts>cd D:\microblog
(venv) D:\microblog>set FLASK_APP=microblog.py
使用命令 flask run
运行程序:
(venv) D:\microblog>flask run
* Serving Flask app "microblog.py"
* Environment: production
WARNING: Do not use the development server in a production environment.
Use a production WSGI server instead.
* Debug mode: off
* Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)
127.0.0.1 - - [02/Aug/2018 16:36:28] "GET / HTTP/1.1" 200 -
127.0.0.1 - - [02/Aug/2018 16:36:29] "GET /favicon.ico HTTP/1.1" 404 -
127.0.0.1 - - [02/Aug/2018 16:36:41] "GET /index HTTP/1.1" 200 -
服务器初始化后,它将等待客户端链接。flask run
命令指示服务器在IP地址127.0.0.1上运行,也即 localhost。
网络服务器侦听特定端口号上的连接。部署在生产Web服务器上的应用程序通常侦听端口443(若未实施加密,可能是侦听80),但访问这些端口需要管理权限。上述应用程序是开发环境中运行,Flask将使用免费提供的端口5000。浏览器地址栏输入如下URL并回车:
http://localhost:5000/
或使用其他URL:
http://localhost:5000/index
注:环境变量不会在终端中被记住,比如打开新的终端窗口时,得重新设置它。不过,Flask允许注册 在运行flask 命令时要自动导入的环境变量。要使用这个选项,得安装python-dotenv包:
(venv) D:\microblog>pip install python-dotenv
然后,在项目的顶级目录中创建一个.env
文件(如microblog/microblog.env),文件中编写环境变量名称、值:
FLASK_APP=microblog.py
参考
https://blog.miguelgrinberg.com/post/the-flask-mega-tutorial-part-i-hello-world