官方文档链接：

 

urllib.request定义了以下函数：

urllib.request.urlopen(url, data=None, [timeout, ]*, cafile=None, capath=None, cadefault=False, context=None)

参数：

打开url链接，可以是字符串或者是Request对象。

data必须是一个定义了向服务器所发送额外数据的对象，或者如果没有必要数据的话，就是None值。可以查阅Request获取详细信息。

url.request模块在HTTP请求中使用了HTTP/1.1，并且包含了Connection：close头部。

可选的timeout参数指定阻止诸如连接尝试等操作的超时时间（以秒为单位）（如果未指定，将使用全局默认超时设置）。这实际上只适用于HTTP，HTTPS和FTP连接。

 如果指定了context，则它必须是描述各种SSL选项的ssl.SSLContext实例。 有关更多详细信息，请参阅HTTPSConnection。

可选的cafile和capath参数为HTTPS请求指定一组可信的CA证书。 cafile应指向包含一系列CA证书的单个文件，而capath应指向散列证书文件的目录。 更多信息可以在ssl.SSLContext.load_verify_locations（）中找到。

cadefault参数被忽略。

返回值：

该函数总是返回一个可以作为context manager使用的对象，并且具有方法，例如;

geturl()-返回检索的资源的URL，通常用于确定是否遵循重定向;

info()-以email.message_from_string（）实例的形式返回页面的元信息（如headers）（可快速参考HTTP Headers）;

getcode()-返回响应的HTTP状态码。

 

对于HTTP和HTTPS URL，此函数返回稍微修改的http.client.HTTPResponse对象。 除上述三种新方法之外，msg属性还包含与reason属性（服务器返回的原因短语）相同的信息，而不是HTTPResponse文档中指定的响应标头。

对于由传统URLopener和FancyURLopener类明确处理的FTP，文件和数据URL和请求，此函数返回一个urllib.response.addinfourl对象。

在协议错误上引发URLError。

请注意，如果没有处理请求的handler，则可能返回None（尽管默认安装的全局OpenerDirector使用UnknownHandler来确保永不发生这种情况）。

另外，如果检测到代理设置（例如，如果设置了诸如http_proxy的* _proxy环境变量），则默认安装ProxyHandler，并确保通过代理处理请求。

来自Python 2.6及更早版本的遗留urllib.urlopen函数已停止使用; urllib.request.urlopen（）对应于旧的urllib2.urlopen。 通过使用ProxyHandler对象可以获得通过将字典参数传递给urllib.urlopen完成的代理处理。