使用Python-Flask框架开发Web网站系列课程（一）构建项目

前言

---

使用IDE：PyCharm

操作系统: Mac

Python版本：3.6

我的邮箱:[email protected]

交流群: 372430835

请注意，既然要学习开发，那么要注意以下几个问题。

1、开发语言版本不一样，尤其是Python，会导致同一段代码压根跑不起来的情况。所以请保证版本一致。

2、操作系统不一样，自然也会有区分，但是Mac环境和Linux环境基本还是比较相近，贴合生产，所以使用Mac作为演示环境。但与Window的差别也不会很大。

3、简易使用一样的IDE工具，但是不强求。

4、本课代码的github地址在页面最底。

 

构建项目

---

一、创建虚拟环境venv

1、从前我很皮，不喜欢创建这东西，都是直接用系统环境的Python，后来项目一多，呵呵哒，这个项目用的Django1.9，那个项目又用Django2.0。得，乱套了。所以，请养成良好的习惯，使用venv大人。

2、通过PyCharm添加虚拟环境venv ，Windows在File->Settings，Mac在PyCharm->Preferences,  打开页面后，按下图配置。Add local Python Interpreter。最后 Apply -> OK。

 

 二、安装flask

2.1 看下图，在Terminal控件里面执行 pip install flask==1.0.2  。

2.2 然后我们将这个阶段的依赖包记录下来，使用的命令为:    pip freeze>requirement.txt 

 2.3  我们开始构建目录结构

我们需要一个目录放前端的代码(frontend)，一个放后端代码(backend)，一个放公共方法代码(utils)，一个放配置文件(config)。

我们在根目录myproject里面右键New->Python Package，用这个创建包。按上面括号里面的名字建。

2.4  构建后端代码

 2.4.1 添加config.py,在/myproject/config下。

这东西就是我们网站以后所有配置存放的地方啦，其中Config放的是各个环境都一致的配置，ProdConfig放的是生产环境的配置，SitConfig存放SIT环境配置，其他类比。

最后的一行，代表config = SitConfig() 当前获取的是SIT环境的配置。

全路径为：/myproject/config/config.py

内容如下：

#!/usr/bin/python
# -*- coding: UTF-8 -*-
"""
Created by liaoyangyang1 on 2017/11/8.
"""
import os

BASE_DIR = os.path.dirname(os.path.abspath(__file__))

class Config(object):
    """Base config class."""
    # 版本
    VERSION = 'beta 0.1'
    # 项目名称
    PROJECTNAME = 'myproject'
    # 端口
    PORT = 10101

    SECRET_KEY = '1234567890!@#$%^&*()'

class ProdConfig(Config):
    """Production config class."""

    # 是否开启调试
    DEBUG = False
    # 主机ip地址
    HOST = '0.0.0.0'

class SitConfig(Config):
    """Development config class."""
    # Open the DEBUG
    # 是否开启调试
    DEBUG = True
    # 主机ip地址
    HOST = '127.0.0.1'

class DevConfig(Config):
    pass

# Default using Config settings, you can write if/else for different env
config = SitConfig()

2.4.2 修改/myproject/backend/__init__.py

这个是未来整个后端的入口文件，具体内容如下：

全路径：/myproject/backend/__init__.py

具体代码如下：

#!/usr/bin/python
# -*- coding: UTF-8 -*-
"""
Created by liaoyangyang1 on 2018/8/21 下午2:41.
"""

from flask import Flask
from config.config import config

def create_app():
    #初始化项目实例
    app = Flask(__name__)
    app.secret_key = app.config['SECRET_KEY']

    #导入配置项
    app.config.from_object(config)

    # 钩子 在请求执行之前
    @app.before_request
    def before_request():
       print('hi')


    return app

 

2.4.3 在根目录添加后端项目管理文件  manage.py

要先补一个模块   pip install Flask-Script==2.0.6

添加一个空的python脚本，manage.py

全路径：/myproject/manage.py

内容如下：

#!/usr/bin/python
# -*- coding: UTF-8 -*-
"""
Created by liaoyangyang1 on 2018/8/21 下午3:40.
"""
from flask_script import Manager, Server
from backend import create_app

app = create_app()

app.debug = app.config["DEBUG"]
# 获取根目录config.py的配置项
host = app.config["HOST"]
port = app.config["PORT"]

# Init manager object via app object
manager = Manager(app)

# Create a new commands: server
# This command will be run the Flask development_env server
manager.add_command("runserver", Server(host=host,port=port,threaded=True))

@manager.shell
def make_shell_context():
    """Create a python CLI.
    return: Default import object
    type: `Dict`
    """
    # 确保有导入 Flask app object，否则启动的 CLI 上下文中仍然没有 app 对象
    return dict(app=app)

if __name__ == '__main__':
    manager.run()

2.4.4 添加视图文件，views.py

我们访问一个链接，要显示或者返回什么东西，就是在这里处理后返回给浏览器或者接口的。

全路径：/myproject/backend/views.py

内容如下：

#!/usr/bin/python
# -*- coding: UTF-8 -*-
"""
Created by liaoyangyang1 on 2018/8/21 下午3:51.
"""
from flask import Blueprint,jsonify

#账户的蓝图  访问http://host:port/account 这个链接的子链接，都会跳到这里
account = Blueprint('/account', __name__)

# 访问http://host:port/account/test 这个链接，就会跳到这里
@account.route('/test')
#上面的链接，绑定的就是这个方法，我们给浏览器或者接口请求 一个json格式的返回
def test():
    return jsonify({'code':0,'content':'hi flask'})

2.4.5 添加路由文件，urls.py

全路径：/myproject/backend/urls.py

内容为：

#!/usr/bin/python
# -*- coding: UTF-8 -*-
"""
Created by liaoyangyang1 on 2018/8/21 下午3:50.
"""

from backend.views import account

# 蓝图注册
def register(app):
    app.register_blueprint(account, url_prefix='/account', strict_slashes=False)

2.4.6 最后一步，添加内容到入口文件__init__.py

我们添加了两行代码

from backend.urls import register

register(app)

用来干啥的呢，是要把我们路由蓝图的对应关系注册到我们的 flask实例里面。和我们之前把配置文件注册到app.config里面是一个道理。

路径：/myproject/backend/__init__.py

内容如下：

#!/usr/bin/python
# -*- coding: UTF-8 -*-
"""
Created by liaoyangyang1 on 2018/8/21 下午2:41.
"""

from flask import Flask
from config.config import config
from backend.urls import register

def create_app():

    #初始化项目实例
    app = Flask(__name__)
    app.secret_key = app.config['SECRET_KEY']

    #导入配置项
    app.config.from_object(config)
    # 注册路由
    register(app)

    # 钩子 在请求执行之前
    @app.before_request
    def before_request():
       print('hi')

    return app

三、启动项目

3.1  点击根目录的manage.py，右键执行

执行方式如图1，然后我们会发现还是缺了参数，请看图2、图3，通过edit configurations,在弹出框中的 Parameters 里面输入runserver。Apply后OK。

现在再次点击根目录的manage.py，右键执行。

 * Serving Flask app "backend" (lazy loading)
 * Environment: production
   WARNING: Do not use the development server in a production environment.
   Use a production WSGI server instead.
 * Debug mode: on
 * Running on http://127.0.0.1:10101/ (Press CTRL+C to quit)
 * Restarting with stat
 * Debugger is active!
 * Debugger PIN: 110-176-230
 

现在，我们在浏览器输入  http://127.0.0.1:10101/account/test

 

图1：

图2

图3

 

四、GITHUB地址

https://github.com/lyy8510a/myproject/releases/tag/v1