基于windows环境的Flask网站搭建（mysql + conda + redis）

1下载mysql-installer-community-5.7.24.0.msi

（https://dev.mysql.com/downloads/windows/installer/8.0.html， 选择 Looking for previous GA versions?）

 

2.安装

2.1选择模块

 

  

2.2安装方式

 

 

2.3设置密码

 

 

2.4查看环境变量

 

 

 3. 配置数据库

3.1 配置服务器编码

在my.ini文件下修改（默认在C:\ProgramData\MySQL\MySQL Server 5.7，可经过查看服务启动配置文件获取）：

[client] default-character-set=utf8 [mysql] default-character-set=utf8 [mysqld] character-set-server=utf8 //注意这里和client,mysql不同

 

注意： mysql到了5.5版本， [mysql] 项内能够写default-character-set=utf8， 可是[mysqld] 项内不能再这么写了，而是必须写：character-set-server=utf8

重启服务net stop mysql57，net start mysql57

 

3.2 链接mysql

Cmd窗口输入mysql -u root -p，输入密码

 

3.3 建立数据库

create database mydatabase;

 

3.4 设置数据库编码方式

查看编码， show variables like '%character%';

 

能够经过命令 set character_set_connection = utf8;逐项修改，Windows下关注 character_set_database character_set_server character_set_system 三项就能够了

 

4. Anaconda3 + python3.6 + mysql + flask-sqlalchemy + flask-migrate配置

4.1配置Anaconda

开始菜单中启动Anaconda prompt

 

查看全部虚拟环境 
conda info -e  或 conda env list 

 

切换平台

set CONDA_FORCE_32BIT=1  //切换到32位

set CONDA_FORCE_32BIT=   // 切换到64位


建立新python环境

conda create -n env_name python=3.6 # 指定python为3.6，不然安装最新版本

conda create -n env_name numpy matplotlib python=3.6 # 同时安装必要的包

 

切换环境

conda activate env_name

conda deactivate env_name

 

移除环境

conda remove -n env_name --all

 

查看环境安装的包

conda list

conda list -n env_name

 

当前中环境安装包

conda install python3.6

　　

4.2在conda虚拟环境下经过pip安装 flask、mysql-connector-python、flask-sqlalchemy

 

4.3 按照flask、flask-sqlalchemy、flask-migrate 编写代码，并在flask配置项中配置数据库：

SQLALCHEMY_DATABASE_URI = 'mysql+mysqlconnector://uname:password@localhost:3306/mydatabase?charset=utf8;use_unicode=False'

其中，use_unicode用于解决读取二进制数据时报错：UnicodeDecodeError:'utf-8' codec can't decode byte 0xb0 in position 0

　　

4.4关于使用flask-migrate初始化、迁徙、更新数据库

python manager db init 建立初始化脚本

python manager db migrate 建立迁徙版本（版本数据表alembic_version ）

python manager db upgrade生成对应版本数据库

备注：初次按顺序执行如上三条指令时，效果同初始化数据库；

后续迁徙数据库时，依次执行后两条指令，迁徙成功后数据库数据会保留；

 

经测试，在python3.6环境下执行第二步时会出错：

File "D:\ProgramData\Anaconda3\envs\flask-test\lib\site-packages\sqlalchemy\dialects\mysql\base.py", line 1996, in get_table_names

    self.identifier_preparer.quote_identifier(current_schema))

  File "D:\ProgramData\Anaconda3\envs\flask-test\lib\site-packages\sqlalchemy\sql\compiler.py", line 3067, in quote_identifier

    self._escape_identifier(value) + \

File "D:\ProgramData\Anaconda3\envs\flask-test\lib\site-packages\sqlalchemy\dialects\mysql\mysqlconnector.py", line 97, in _escape_identifier

    value = value.replace(self.escape_quote, self.escape_to_quote)

TypeError: <flask_script.commands.Command object at 0x0000011690B8D4E0>: a bytes-like object is required, not 'str'

 

根据日志修改Anaconda3\envs\flask-test\lib\site-packages\sqlalchemy\sql\compiler.py 的3067行，增长以下代码：

if not isinstance(value, str):
    value = str(value, 'utf-8')

 

在flask数据库配置为sqlite状况下，测试迁徙成功：

app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///app.db'

 

在flask数据库配置为mysql状况下，首次执行初始化数据库时能够成功，但在Model文件变更后迁徙数据库时出现 Table '***' already exists错误

　　

 

使用flask-migrate一是出现python3.X下代码兼容问题，二是没法在mysal下成功完成数据库迁徙，故综上放弃flask-migrate的配置与使用，

同时须要修改使用flask-sqlalchemy原生的数据库建立方式，在app初始化代码后面增长：db.create_all()

 

5. 配置redis及flask-session

默认flask采用secret cookies方式进行session存储的，这种存储方式将须要的信息传输到浏览器端后存储在加密后cookies信息中，经测试这种方式存在浏览器兼容性，在手机端（ios）UC浏览器中，当flask服务端调用session.clear()清除session信息时（例如像主动退出登陆这样的场景时），浏览器端并未成功清除掉登陆信息，从而致使没法退出登陆，必须清空浏览器缓存

 

故采用redis做为session存储方式，同时redis也可配置做为flask缓存，在python代码中直接调用

redis是一个开源的、使用C语言编写的、支持网络交互的、可基于内存也可持久化的Key-Value数据库

 

5.1下载并安装配置redis

Windows系统下载微软客制版本https://github.com/MicrosoftArchive/redis

Linux系统下载官网版本 https://redis.io/download

Linux下须要先编译再安装，ubuntu下也可以使用$sudo apt-get install redis-server进行安装，安装完成的redis包含两个模块redis-server 和 redis-cli, 其中redis-cli是命令行客户端

 

在安装目录找到conf文件（windows下有两个，根据需求选择），修改或添加以下内容：

requirepass mypassword 为redis # 设置密码

port 8880 #修改端口号

 

Windows下安装为系统服务： redis-server --service-install redis.windows.conf //安装服务 redis-server --service-start //启动服务 redis-server --service-stop //中止服务 redis-server --service-uninstall //卸载服务 

 

Linux下安装和配置为自启服务参考： https://www.cnblogs.com/skyessay/p/6433349.html https://www.jb51.net/article/101508.htm

 

服务启动后可使用redis-cli测试：

 

链接redis

redis-cli.exe -h 127.0.0.1 -p 8880

 

密码认证

auth 'mypassword'

 

切换数据库（redis有16个[0-15]数据库，默认链接使用的是0）

select 1

 

查看当前全部索引

127.0.0.1:8880> keys *

 

字符串存取

set myKey abc

get myKey

 

哈希值存取

hmset myhash field1 "Hello" field2 "World"

hget myhash field1

 

列表集合存取

lpush mylist element1

lpush mylist element2

Lrange mylist 0 10

 

set集合值存取

sadd myset member1

sadd myset member2

Smembers key

 

zset有序集合（zadd myzset score member，score为序号）

zadd myzset 0 member1

zadd myzset 0 member2

Zrangebyscore myzset 0 10

　　

 

其余操做见https://www.runoob.com/redis/redis-tutorial.html

 

 

5.2安装redis，flask-session模块：

pip install redis pip install flask-session

 

在flask配置项中配置flask的session type为redis

SESSION_TYPE = 'redis'  # session类型为redis

SESSION_PERMANENT = True  # 会话持久化

PERMANENT_SESSION_LIFETIME = 60 * 30  # 持久化时间设为30分钟

SESSION_USE_SIGNER = True  # 是否对发送到浏览器上session的cookie值进行加密

SESSION_KEY_PREFIX = 'session:'  # 保存到session中的值的前缀

SESSION_REDIS = redis.Redis(host='localhost', port=8880, password='mypassword', db=1)  # 用于链接redis的配置

 

6. 打包项目并移植到新环境

使用wheel对flask项目进行打包移植，打包移植分为2种方式，

一种是打包成为模块并安装到新环境，

另一种则是仅配置当前环境依赖文件，将源码移植到新环境后按照配置一键部署新环境

 

6.1首先须要在项目根目录配置setup.py和 MANIFEST.in文件，并确保项目已安装wheel模块，具体可参考flask及pypa官方文档

https://dormousehole.readthedocs.io/en/latest/tutorial/install.html

https://packaging.python.org/tutorials/packaging-projects/

 

#[setup.py]

from setuptools import find_packages, setup setup( name='myproject', version='1.0.0', author="myname", description="myproject'package", packages=find_packages(), include_package_data=True, zip_safe=False, install_requires=[ 'flask', 'flask-sqlalchemy', 'flask-session', 'mysql-connector-python', 'redis' ], classifiers=[ "Programming Language :: Python :: 3", ] [manifest.in] graft instance graft myproject/instance graft myproject/resources/font graft myproject/static graft myproject/templates include start.py global-exclude *.pyc # 备注：graft指定拷贝的无依赖静态文件目录, include指定非模块py文件，global-exclude 指定忽略全部pyc(python可执行)文件

 

在当前python环境中执行python3 setup.py sdist bdist_wheel，会在dist目录生成tar.gz源码和whl模块两个文件

 

6.2源码移植

将tar.gz源码解压到新目录，在新python虚拟环境中定位到当前目录并执行pip install -e . ，pip会在当前文件夹中寻找 setup.py 并安装所需依赖（此时源码在当前路径也会被pip识别为一个模块）

 

6.2模块移植

模块移植是指在新python虚拟环境中定位到前面生成的whl文件并执行pip install ***.whl 进行安装pip会将模块安装到site-packages目录下，就像安装其余模块那样

 

注意：模块安装自己不存在什么问题，可是模块打包并不会将flask项目根目录的入口文件包含进去（模块仅会打包指定模块目录下的文件，如前文的myproject目录），故将flask项目做为模块安装后，在新环境下须要从新编写入口文件并启动app对象，同时要保证配置文件可以被正确识别到，当flask项目模块中设置instance_relative_config=True时，其读取配置文件的路径为：

envs\\mytest-flask\\var\\myproject-instance\\config.py

 

Flask的默认读取配置文件的路径在当前代码目录，若是在初始化时设置了instance_relative_config=True，则读取的配置文件路径在根目录下instance文件夹：

在配置文件中的关联路径的行为能够在 “关联到应用的根路径”（缺省的）和 “关联到实例文件夹”之间变换， 具体经过应用构建函数中的 instance_relative_config 来实现:

app = Flask(__name__, instance_relative_config=True)

 

若是使用虚拟python环境，建议采用源码移植部署方式，或者在flask项目打包前将instance_relative_config配置为False，同时在将配置文件及其它初始化文件放置应用模块根目录下

 

若是使用系统python环境，可以使用模块移植部署方式（此时flask项目将会做为模块安装到系统python模块目录），并编写项目入口文件，将配置文件及其余初始化文件按照应用应用实例文件夹分开放置