有时候安装了一个Python库,可能在IDE如PyCharm中不能使用,这是因为:
通过pip安装的库默认一般在全局环境中,而PyCharm一般会默认创建虚拟环境,所以两者的环境不一致,导致安装的包不能正常导入使用,解决办法有2种:
一般情况下,Python第三方库安装是直接通过pip install xxx
的方式进行安装的,这样安装会将库安装到系统级的Python环境中。
但是有时可能会面临这样的问题:如果现在用Django 1.10.x写了个网站,但是同时有一个Django 0.9开发的项目需要维护,并i企鹅可能Django 1.10不再兼容Django 0.9的一些语法了,这就需要同时拥有Django 1.10和Django 0.9两套环境,这时候我们就可以通过虚拟环境来解决这个问题。
虚拟环境管理有很多工具,这里我选择pipenv。
pipenv的安装命令:
Windows下pip install pipenv
Mac下
brew install pipenv
Linux下
pip install pipenv
创建虚拟环境
安装之后即可创建虚拟环境。
创建虚拟环境使用命令pipenv shell
,如下:
出现图中所标提示Flask_Framework-rL0Lvhvz
及说明安装成功,此时再运行pip list
可以看到虚拟环境中默认安装的库:
Package Version
---------- -------
pip 20.0.2
setuptools 46.1.3
wheel 0.34.2
不能同时使用全局环境和虚拟环境的库,只能选择使用其中一个。
虚拟环境默认会安装到系统盘(C盘)下的当前用户目录下的 .virtualenvs 目录下,如果想指定安装到其他目录,可以设置系统环境变量,示意如下:
此时再安装虚拟环境,即会安装到指定的目录下。
虚拟环境安装好之后,需要在PyCharm中设置虚拟环境为当前创建的虚拟环境,即定位选择虚拟环境下的python.exe文件,与前面方法相同。
需要在虚拟环境中通过命令pip install flask
安装Flask,再查看安装的库,结果如下:
Package Version
------------ -------
click 7.1.1
Flask 1.1.2
itsdangerous 1.1.0
Jinja2 2.11.1
MarkupSafe 1.1.1
pip 20.0.2
setuptools 46.1.3
Werkzeug 1.0.1
wheel 0.34.2
显然,在安装flask时,安装了存在依赖关系的其他库。
如果电脑中同时拥有Python3和Python2,可以指定版本:
pipenv --three # 泛指Python3的版本
pipenv --two # 泛指Python2的版本
pipenv --python 3.7 # 指定Python具体版本
虚拟环境管理
pipenv shell # 如果虚拟环境已存在则进入虚拟环境,否则创建并进入虚拟环境
exit # 退出虚拟环境
pipenv --rm # 删除整个环境 不会删除pipfile
pipfile和pipfile.lock
在创建虚拟环境后,虚拟环境目录下会生成pipfile文件,内容如下:
[[source]]
name = “pypi”
url = “https://pypi.org/simple”
verify_ssl = true
[dev-packages]
[packages]
[requires] python_version = “3.7”
参数说明:
urlpipfile.lock详细记录环境依赖,并且使用了Hash算法以保证完整的对应关系。
如果需要将安装的库记录到Pipfile中,可以使用pip install --dev 库名
将库安装到开发环境。
在虚拟环境中运行项目示意run参数:
pipenv run python manage.py runserver
pipenv有一个缺点:
lock不稳定而且时间非常长,所以安装包的时候记得加上--skip-lock
,如下:
pipenv install django --skip-lock
最后开发完成要提交到仓库的时候再执行pipenv lock
命令。
flask是一款非常流行的Python Web框架,诞生于2010年,作者是Armin Ronacher,这个项目最初只是作者在愚人节的一个玩笑,后来由于非常受欢迎,逐渐成为一个正式的项目。
flask自2010年发布第一个版本以来,大受欢迎,深得开发者的喜爱,并且在多个公司已经得到了应用,flask能如此流行的原因,可以分为以下几点:
from flask import Flask
# 传入__name__初始化一个Flask实例
app = Flask(__name__)
# 装饰器,将当前路由映射到指定函数
@app.route('/')
def hello_world():
return 'hello world'
if __name__ == '__main__':
app.run()
打印:
* Serving Flask app "first_flask" (lazy loading)
* Environment: production
WARNING: This is a development server. Do not use it in a production deployment.
Use a production WSGI server instead.
* Debug mode: off
* Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)
此时已经创建服务,在浏览器中打开http://127.0.0.1:5000/即可看到:
并且在开启的服务状态栏下会看到请求的记录,如:
127.0.0.1 - - [09/Apr/2020 07:54:10] "GET / HTTP/1.1" 200 -
127.0.0.1 - - [09/Apr/2020 07:54:10] "GET /favicon.ico HTTP/1.1" 404 -
说明:
@app.route('/')
装饰器映射URL和执行的函数。这个设置将URL映射到指定的函数上,例中指定当前路由为根目录,如果为根目录时也可以不写 /,但是尽量写上以示区别。
app.run()
是让flask项目运行起来,可以指定主机号和端口号。默认情况下flask不会开启DEBUG模式,开启DEBUG模式后,flask会在每次保存代码的时候自动的重新载入代码,并且如果代码有错误,会在终端进行提示。
在hello_world()
函数中加入错误代码进行测试:
from flask import Flask
app = Flask(__name__)
# 装饰器,将当前路由映射到指定函数
@app.route('/')
def hello_world():
result = 1 / 0
return 'hello world'
if __name__ == '__main__':
app.run()
重新运行开启服务后,会发现:
在日志中也会发现报错:
[2020-04-09 08:07:17,881] ERROR in app: Exception on / [GET]
Traceback (most recent call last):
File "C:\Users\Lenovo\.virtualenvs\Flask_Framework-rL0Lvhvz\lib\site-packages\flask\app.py", line 2447, in wsgi_app
response = self.full_dispatch_request()
File "C:\Users\Lenovo\.virtualenvs\Flask_Framework-rL0Lvhvz\lib\site-packages\flask\app.py", line 1952, in full_dispatch_request
rv = self.handle_user_exception(e)
File "C:\Users\Lenovo\.virtualenvs\Flask_Framework-rL0Lvhvz\lib\site-packages\flask\app.py", line 1821, in handle_user_exception
reraise(exc_type, exc_value, tb)
File "C:\Users\Lenovo\.virtualenvs\Flask_Framework-rL0Lvhvz\lib\site-packages\flask\_compat.py", line 39, in reraise
raise value
File "C:\Users\Lenovo\.virtualenvs\Flask_Framework-rL0Lvhvz\lib\site-packages\flask\app.py", line 1950, in full_dispatch_request
rv = self.dispatch_request()
File "C:\Users\Lenovo\.virtualenvs\Flask_Framework-rL0Lvhvz\lib\site-packages\flask\app.py", line 1936, in dispatch_request
return self.view_functions[rule.endpoint](**req.view_args)
File "xxx/first_flask.py", line 9, in hello_world
result = 1 / 0
ZeroDivisionError: division by zero
127.0.0.1 - - [09/Apr/2020 08:07:17] "GET / HTTP/1.1" 500 -
这与显然很麻烦,每次修改之后必须重新运行,而且错误信息在日志中才能看到。
我们可以开启Debug模式,这样每次修改代码后都会载入代码重新运行,并且代码有问题时会显示错误信息。
开启Debug模式有几种方式:
在run()
方法中设置debug参数为True
if __name__ == '__main__':
app.run(debug=True)
设置app对象实例的属性为True
if __name__ == '__main__':
app.debug = True
app.run()
通过配置参数config设置
if __name__ == '__main__':
app.config.update(DEBUG=True)
app.run()
config是继承自字典类型的,所以可以使用字典的update()
方法。
开启Debug模式测试如下:
from flask import Flask
app = Flask(__name__)
# 装饰器,将当前路由映射到指定函数
@app.route('/')
def hello_world():
result = 1 / 0
return 'hello world'
if __name__ == '__main__':
app.run(debug=True)
此时再看网页:
并且控制台中也会提示已开启Debug模式:
* Serving Flask app "first_flask" (lazy loading)
* Environment: production
WARNING: This is a development server. Do not use it in a production deployment.
Use a production WSGI server instead.
* Debug mode: on
* Restarting with stat
* Debugger is active!
* Debugger PIN: 313-629-160
* Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)
在开启了DEBUG模式后,当程序有异常而进入错误堆栈模式,第一次点击某个堆栈想查看变量值的时候,页面会弹出一个对话框,提示输入PIN值,比如在刚刚启动的项目中的PIN值为313-629-160,输入这个值后,Werkzeug会把这个PIN值作为cookie的一部分保存起来,并在8小时后过期,8小时内不需要再输入PIN值。这样做的目的是为了提高安全性,让调试模式下的攻击者更难攻击到本站。
现在每次修改完代码保存之后,都会自动加载代码重启服务,不需要再手动关闭服务再重启了。
此时在报错的网页中可以Debug,需要使用控制台提供的PIN,操作示意如下:
Debug模式是在开发环境中开启的,开发完成上线之后要关闭Debug模式,因为DEBUG模式会带来非常大的安全隐患。
Flask项目的配置,都是通过app.config对象来进行配置的。
比如要配置一个项目处于DEBUG模式下,那么可以使用app.config['DEBUG] = True
来进行设置,那么Flask项目将以DEBUG模式运行。
在Flask项目中,有四种方式进行项目的配置。
app = Flask(__name__)
app.config['DEBUG'] = True
硬编码的方式不灵活,不便于进行复用。
2.通过update()方法因为app.config是flask.config.Config的实例,而Config类是继承自dict,因此可以通过update()
方法进行配置。
app.config.update(
DEBUG=True,
SECRET_KEY='...'
)
3.通过from_object()方法
如果配置项特别多,可以把所有的配置项都放在一个模块中,然后通过加载模块的方式进行配置,假设有一个settings.py模块,专门用来存储配置项的,此你可以通过app.config.from_object()
方法进行加载,并且该方法既可以接收模块的的字符串名称,也可以模块对象。
有两种形式:
# 1. 通过模块字符串
app.config.from_object('settings')
# 2. 通过模块对象
import settings
app.config.from_object(settings)
添加配置文件后,将配置项都放入该文件中,其他文件直接引用该配置文件中的配置项,提高了代码的复用性、降低了耦合度,同时,在配置文件中修改了配置项时,其他代码中均不需要修改,从而提高了代码的灵活性。
新建config.py文件,添加一些配置项如下:
# 设置Debug模式为True
DEBUG = True
# 指定HOST
HOST = '127.0.0.1'
在flask文件中导入:
from flask import Flask
import config
app = Flask(__name__)
# 装饰器,将当前路由映射到指定函数
@app.route('/')
def hello_world():
result = 1 / 0
return 'hello world'
if __name__ == '__main__':
app.config.from_object(config)
app.run()
再运行,也能开启Debug模式。
也可以通过字符串形式导入:
if __name__ == '__main__':
app.config.from_object('config')
app.run()
此时不需要再导入config模块。
4.通过from_pyfile()方法app.config.from_pyfile()
方法传入一个文件名,通常是以.py结尾的文件,但也不限于只使用.py后缀的文件。
通过导入Python文件的形式导入配置文件:
if __name__ == '__main__':
app.config.from_pyfile('config.py')
app.run()
from_pyfile()
方法有一个silent参数,设置为True时,如果配置文件不存在也不会报错;
不仅支持Python格式的配置文件,也支持.ini等格式。
从前面的例子中,我们可以看到,一个URL要与执行函数进行映射,使用的是@app.route
装饰器。
@app.route
装饰器中,可以指定URL的规则来进行更加详细的映射,比如现在要映射一个文章详情的URL,文章详情的URL是/article/id/
,id有可能为1、2、3…,那么可以通过以下方式:
@app.route('/article/')
def article(id):
return '%s article detail' % id
其中,尖括号是固定语法,表示地址中传入的参数,默认的数据类型是字符串。
如果需要限制参数类型,则要写成converter:variable
,其中converter是类型名称,可以有以下几种:
新增路由域函数映射测试:
from flask import Flask
app = Flask(__name__)
@app.route('/')
def hello_world():
return 'hello world'
@app.route('/corley')
def hello_corley():
return '这是我的第一个Flask页面'
if __name__ == '__main__':
app.run(debug=True)
显示:
显然,在地址中访问http://127.0.0.1/corley可以访问到,因为在flask中已经定义了。
同时还可以动态传入参数:
from flask import Flask
app = Flask(__name__)
@app.route('/')
def hello_world():
return 'hello world'
@app.route('/corley')
def hello_corley():
return '这是我的第一个Flask页面'
@app.route('/list/')
def article_list(aid):
return '这是第{}篇文章'.format(aid)
if __name__ == '__main__':
app.run(debug=True)
显示:
显然,因为未定义 /list 所以不能访问http://127.0.0.1:5000/list;
可以根据传入的参数动态显示视图,但是并未对数据类型进行限制,可以增加对数据类型的限制:
from flask import Flask
app = Flask(__name__)
@app.route('/')
def hello_world():
return 'hello world'
@app.route('/corley')
def hello_corley():
return '这是我的第一个Flask页面'
@app.route('/list/')
def article_list(aid):
return '这是第{}篇文章'.format(aid)
if __name__ == '__main__':
app.run(debug=True)
显示:
显然,此时参数只能是整型数字了。
一般情况下参数中不能含有 /,要想含有 /,必须限制为path类型,除了此区别,path与string类型基本一样。
示例如下:
from flask import Flask
app = Flask(__name__)
@app.route('/')
def hello_world():
return 'hello world'
@app.route('/corley')
def hello_corley():
return '这是我的第一个Flask页面'
@app.route('/list/')
def article_list(aid):
return '这是第{}篇文章'.format(aid)
@app.route('/list/')
def comment_list(aid):
return '这是第{}个评论'.format(aid)
if __name__ == '__main__':
app.run(debug=True)
显示:
显然,如果参数为数字时,匹配article_list(aid)
函数,如果为字符串类型或者参数中含有 / 时匹配comment_list(aid)
函数。
访问两个路径用同一个函数可以用any来限制,示例如下:
from flask import Flask
app = Flask(__name__)
@app.route('/')
def hello_world():
return 'hello world'
@app.route('/corley')
def hello_corley():
return '这是我的第一个Flask页面'
@app.route('/list/')
def article_list(aid):
return '这是第{}篇文章'.format(aid)
@app.route('/list/')
def comment_list(aid):
return '这是第{}个评论'.format(aid)
@app.route('//')
def message(url_path):
return '当前路径是'.format(url_path)
if __name__ == '__main__':
app.run(debug=True)
显示:
此时需要在路由路径最后添加 / 才能正常访问。
如果不想指定子路径来传递参数,也可以通过 ?= 的形式来传递参数,例如:/article?id=xxx
,这种情况下,可以通过request.args.get('id')
来获取id的值。如果是post方法,则可以通过request.form.get('id')
来进行获取。
在flask中添加这类的地址参数需要先从flask中导入request,示例如下:
from flask import Flask
from flask import request
app = Flask(__name__)
@app.route('/')
def hello_world():
return 'hello world'
@app.route('/corley')
def hello_corley():
return '这是我的第一个Flask页面'
@app.route('/list/')
def article_list(aid):
return '这是第{}篇文章'.format(aid)
@app.route('/list/')
def comment_list(aid):
return '这是第{}个评论'.format(aid)
@app.route('//')
def message(url_path):
return url_path
@app.route('/wd')
def baidu_search():
return request.args.get('keyword')
if __name__ == '__main__':
app.run(debug=True)
显示:
显然,如果传入的参数未在函数中定义,会报错。