如何利用 Request 构造函数 实现请求配置的复用与模块化管理

夏芳同学_8959

夏芳同学_8959

2026-05-24

217人浏览

原创

真正实现配置复用与模块化靠的是Session+自定义配置类/工厂函数,而非直接调用requests.request();Session天然支持连接复用、共享headers/auth/cookies/超时/重试,是推荐方式。

如何利用 request 构造函数 实现请求配置的复用与模块化管理

直接用 requests.request() 构造函数本身并不支持配置复用或模块化管理——它只是一个底层通用接口,每次调用都新建请求、不保留状态、也不自动复用连接。真正实现配置复用与模块化,靠的是上层封装机制,核心是 Session + 自定义配置类/工厂函数,而非直接操作 request()。

用 Session 封装共用配置

这是最自然、最推荐的方式。Session 天然支持跨请求复用连接、共享 headers、auth、cookies、超时、重试策略等:

  • 创建一个预设好 headers、timeout、认证信息的 Session 实例,作为“请求客户端”统一出口
  • 所有业务请求都通过该 Session 发起,避免重复传参
  • 连接池、SSL 验证、代理等也随 Session 统一管理

示例:

python
import requests
<p>class APIClient:
def <strong>init</strong>(self, base_url, timeout=(3, 10), user_agent="MyApp/1.0"):
self.session = requests.Session()
self.base_url = base_url.rstrip("/")
self.session.headers.update({"User-Agent": user_agent})
self.timeout = timeout</p><h1>可选:挂载带连接池和重试的 adapter</h1><pre class="brush:php;toolbar:false;">    adapter = requests.adapters.HTTPAdapter(
        pool_connections=10,
        pool_maxsize=20,
        max_retries=2
    )
    self.session.mount("http://", adapter)
    self.session.mount("https://", adapter)

def get(self, path, **kwargs):
    url = f"{self.base_url}{path}"
    return self.session.get(url, timeout=self.timeout, **kwargs)

def post(self, path, **kwargs):
    url = f"{self.base_url}{path}"
    return self.session.post(url, timeout=self.timeout, **kwargs)

使用

client = APIClient("https://www.php.cn/link/710ba53b0d353329706ee1bedf4b9b39") resp = client.get("/users") data = resp.json()

用函数工厂生成定制化请求函数

适合轻量级、配置差异明确的场景(如不同环境、不同认证方式)。用闭包把固定参数“冻结”进函数里:

  • 每个工厂函数返回一个已绑定 base_url、headers、auth 的专用请求函数
  • 调用时只需传动态参数(如 path、json),逻辑清晰、无状态污染
  • 便于单元测试和 mock

示例:

python
import requests
<p>def make_requester(base_url, auth=None, headers=None, timeout=(3, 10)):
base_headers = {"User-Agent": "MyApp/1.0"}
if headers:
base_headers.update(headers)</p><pre class="brush:php;toolbar:false;">def requester(method, path, **kwargs):
    url = f"{base_url.rstrip('/')}{path}"
    kwargs.setdefault("headers", {}).update(base_headers)
    kwargs.setdefault("auth", auth)
    kwargs.setdefault("timeout", timeout)
    return requests.request(method, url, **kwargs)
return requester

生成生产环境请求器

prod_req = make_requester("https://www.php.cn/link/fa731652c97f2dd6f285126b577e0d1e", auth=("u", "p"))

生成测试环境请求器

test_req = make_requester("https://www.php.cn/link/4129970ba309510811271efc661fd669", headers={"X-Env": "test"})

使用

resp = prod_req("GET", "/status")

用配置字典驱动请求行为

把请求模板(method、url、headers、params 等)写成结构化配置,配合通用执行函数,实现声明式调用:

  • 配置与逻辑分离,适合多接口、多版本、YAML/JSON 配置驱动的项目
  • 可结合 jinja2 模板、环境变量注入动态值(如 token、host)
  • 便于生成文档、做请求审计或录制回放

示例(简化版):

python
import requests
<p>REQUEST_CONFIGS = {
"get_user": {
"method": "GET",
"url": "<a href="https://www.php.cn/link/710ba53b0d353329706ee1bedf4b9b39/users/%7Buser_id">https://www.php.cn/link/710ba53b0d353329706ee1bedf4b9b39/users/{user_id</a>}",
"headers": {"Accept": "application/json"},
"timeout": (3, 15),
},
"create_order": {
"method": "POST",
"url": "<a href="https://www.php.cn/link/710ba53b0d353329706ee1bedf4b9b39/orders">https://www.php.cn/link/710ba53b0d353329706ee1bedf4b9b39/orders</a>",
"headers": {"Content-Type": "application/json"},
"json": {"items": []},
}
}</p><p>def call_api(config_key, <strong>context):
config = REQUEST_CONFIGS[config_key].copy()
url = config.pop("url").format(</strong>context)  # 替换路径变量
method = config.pop("method")
return requests.request(method, url, <strong>config, </strong>context)</p><h1>使用</h1><p>resp = call_api("get_user", user_id=123)
</p>

不复杂但容易忽略:真正复用的不是 request() 函数本身,而是它背后的 Session 实例、预设的 adapter、封装好的类或闭包。模块化关键在于把“变”与“不变”分清楚——把不变的配置抽出来,让业务代码只关注变化的数据和路径。

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
js获取数组长度的方法
js获取数组长度的方法

在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

5126

5

js刷新当前页面
js刷新当前页面

js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

2023.07.04

1269

3

js四舍五入
js四舍五入

js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

2023.07.04

5044

6

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

2023.09.01

980

4

JavaScript转义字符
JavaScript转义字符

JavaScript中的转义字符是反斜杠和引号,可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

1916

5

js生成随机数的方法
js生成随机数的方法

js生成随机数的方法有:1、使用random函数生成0-1之间的随机数;2、使用random函数和特定范围来生成随机整数;3、使用random函数和round函数生成0-99之间的随机整数;4、使用random函数和其他函数生成更复杂的随机数;5、使用random函数和其他函数生成范围内的随机小数;6、使用random函数和其他函数生成范围内的随机整数或小数。

2023.09.04

3605

4

如何启用JavaScript
如何启用JavaScript

JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍:1、内联脚本是将JavaScript代码直接嵌入到HTML标签中;2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中;3、外部脚本是将JavaScript代码放置在一个独立的文件;4、外部脚本是将JavaScript代码放置在一个独立的文件。

2023.09.12

4693

6

Js中Symbol类详解
Js中Symbol类详解

javascript中的Symbol数据类型是一种基本数据类型,用于表示独一无二的值。Symbol的特点:1、独一无二,每个Symbol值都是唯一的,不会与其他任何值相等;2、不可变性,Symbol值一旦创建,就不能修改或者重新赋值;3、隐藏性,Symbol值不会被隐式转换为其他类型;4、无法枚举,Symbol值作为对象的属性名时,默认是不可枚举的。

2023.09.20

3080

5

java访问控制修饰符介绍
java访问控制修饰符介绍

java访问控制修饰符有四种,分别是public、protected、private、默认访问修饰符。详细介绍:1、public,public是最宽松的访问控制修饰符,被修饰的类、方法和变量可以被任何其他类访问,当一个类、方法或变量被声明为public时,它们可以在任何地方被访问,无论是同一个包中的类还是不同包中的类;2、protected修饰符等等。

2023.09.20

988

7

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 133.9万人学习