1172 lines
28 KiB
PHP
1172 lines
28 KiB
PHP
<?php
|
||
|
||
namespace Yurun\Util;
|
||
|
||
use Yurun\Util\YurunHttp\Attributes;
|
||
use Yurun\Util\YurunHttp\Http\Psr7\Consts\MediaType;
|
||
use Yurun\Util\YurunHttp\Http\Psr7\UploadedFile;
|
||
use Yurun\Util\YurunHttp\Http\Request;
|
||
|
||
class HttpRequest
|
||
{
|
||
/**
|
||
* 处理器.
|
||
*
|
||
* @var \Yurun\Util\YurunHttp\Handler\IHandler|null
|
||
*/
|
||
private $handler;
|
||
|
||
/**
|
||
* 需要请求的Url地址
|
||
*
|
||
* @var string
|
||
*/
|
||
public $url;
|
||
|
||
/**
|
||
* 发送内容，可以是字符串、数组（支持键值、Yurun\Util\YurunHttp\Http\Psr7\UploadedFile，其中键值会作为html编码，文件则是上传）.
|
||
*
|
||
* @var mixed
|
||
*/
|
||
public $content;
|
||
|
||
/**
|
||
* `curl_setopt_array()`所需要的第二个参数.
|
||
*
|
||
* @var array
|
||
*/
|
||
public $options = [];
|
||
|
||
/**
|
||
* 请求头.
|
||
*
|
||
* @var array
|
||
*/
|
||
public $headers = [];
|
||
|
||
/**
|
||
* Cookies.
|
||
*
|
||
* @var array
|
||
*/
|
||
public $cookies = [];
|
||
|
||
/**
|
||
* 失败重试次数，默认为0.
|
||
*
|
||
* @var int
|
||
*/
|
||
public $retry = 0;
|
||
|
||
/**
|
||
* 是否使用代理，默认false.
|
||
*
|
||
* @var bool
|
||
*/
|
||
public $useProxy = false;
|
||
|
||
/**
|
||
* 代理设置.
|
||
*
|
||
* @var array
|
||
*/
|
||
public $proxy = [];
|
||
|
||
/**
|
||
* 是否验证证书.
|
||
*
|
||
* @var bool
|
||
*/
|
||
public $isVerifyCA = false;
|
||
|
||
/**
|
||
* CA根证书路径.
|
||
*
|
||
* @var string|null
|
||
*/
|
||
public $caCert;
|
||
|
||
/**
|
||
* 连接超时时间，单位：毫秒.
|
||
*
|
||
* @var int
|
||
*/
|
||
public $connectTimeout = 30000;
|
||
|
||
/**
|
||
* 总超时时间，单位：毫秒.
|
||
*
|
||
* @var int
|
||
*/
|
||
public $timeout = 30000;
|
||
|
||
/**
|
||
* 下载限速，为0则不限制，单位：字节
|
||
*
|
||
* @var int|null
|
||
*/
|
||
public $downloadSpeed;
|
||
|
||
/**
|
||
* 上传限速，为0则不限制，单位：字节
|
||
*
|
||
* @var int|null
|
||
*/
|
||
public $uploadSpeed;
|
||
|
||
/**
|
||
* 用于连接中需要的用户名.
|
||
*
|
||
* @var string|null
|
||
*/
|
||
public $username;
|
||
|
||
/**
|
||
* 用于连接中需要的密码
|
||
*
|
||
* @var string|null
|
||
*/
|
||
public $password;
|
||
|
||
/**
|
||
* 请求结果保存至文件的配置.
|
||
*
|
||
* @var mixed
|
||
*/
|
||
public $saveFileOption = [];
|
||
|
||
/**
|
||
* 是否启用重定向.
|
||
*
|
||
* @var bool
|
||
*/
|
||
public $followLocation = true;
|
||
|
||
/**
|
||
* 最大重定向次数.
|
||
*
|
||
* @var int
|
||
*/
|
||
public $maxRedirects = 10;
|
||
|
||
/**
|
||
* 证书类型
|
||
* 支持的格式有"PEM" (默认值), "DER"和"ENG".
|
||
*
|
||
* @var string
|
||
*/
|
||
public $certType = 'pem';
|
||
|
||
/**
|
||
* 一个包含 PEM 格式证书的文件名.
|
||
*
|
||
* @var string
|
||
*/
|
||
public $certPath = '';
|
||
/**
|
||
* 使用证书需要的密码
|
||
*
|
||
* @var string
|
||
*/
|
||
public $certPassword = null;
|
||
|
||
/**
|
||
* certType规定的私钥的加密类型，支持的密钥类型为"PEM"(默认值)、"DER"和"ENG".
|
||
*
|
||
* @var string
|
||
*/
|
||
public $keyType = 'pem';
|
||
|
||
/**
|
||
* 包含 SSL 私钥的文件名.
|
||
*
|
||
* @var string
|
||
*/
|
||
public $keyPath = '';
|
||
|
||
/**
|
||
* SSL私钥的密码
|
||
*
|
||
* @var string
|
||
*/
|
||
public $keyPassword = null;
|
||
|
||
/**
|
||
* 请求方法.
|
||
*
|
||
* @var string
|
||
*/
|
||
public $method = 'GET';
|
||
|
||
/**
|
||
* Http 协议版本.
|
||
*
|
||
* @var string
|
||
*/
|
||
public $protocolVersion = '1.1';
|
||
|
||
/**
|
||
* 是否启用连接池，默认为 null 时取全局设置.
|
||
*
|
||
* @var bool|null
|
||
*/
|
||
public $connectionPool = null;
|
||
|
||
/**
|
||
* 代理认证方式.
|
||
*
|
||
* @var array
|
||
*/
|
||
public static $proxyAuths = [];
|
||
|
||
/**
|
||
* 代理类型.
|
||
*
|
||
* @var array
|
||
*/
|
||
public static $proxyType = [];
|
||
|
||
/**
|
||
* 自动扩展名标志.
|
||
*/
|
||
const AUTO_EXT_FLAG = '.*';
|
||
|
||
/**
|
||
* 自动扩展名用的临时文件名.
|
||
*/
|
||
const AUTO_EXT_TEMP_EXT = '.tmp';
|
||
|
||
/**
|
||
* 构造方法.
|
||
*
|
||
* @return mixed
|
||
*/
|
||
public function __construct()
|
||
{
|
||
$this->open();
|
||
}
|
||
|
||
/**
|
||
* 析构方法.
|
||
*/
|
||
public function __destruct()
|
||
{
|
||
$this->close();
|
||
}
|
||
|
||
/**
|
||
* 打开一个新连接，初始化所有参数。一般不需要手动调用。
|
||
*
|
||
* @return void
|
||
*/
|
||
public function open()
|
||
{
|
||
$this->handler = YurunHttp::getHandler();
|
||
$this->retry = 0;
|
||
$this->headers = $this->options = [];
|
||
$this->url = $this->content = '';
|
||
$this->useProxy = false;
|
||
$this->proxy = [
|
||
'auth' => 'basic',
|
||
'type' => 'http',
|
||
];
|
||
$this->isVerifyCA = false;
|
||
$this->caCert = null;
|
||
$this->connectTimeout = 30000;
|
||
$this->timeout = 30000;
|
||
$this->downloadSpeed = null;
|
||
$this->uploadSpeed = null;
|
||
$this->username = null;
|
||
$this->password = null;
|
||
$this->saveFileOption = [];
|
||
}
|
||
|
||
/**
|
||
* 关闭连接。一般不需要手动调用。
|
||
*
|
||
* @return void
|
||
*/
|
||
public function close()
|
||
{
|
||
if ($this->handler)
|
||
{
|
||
$handler = $this->handler;
|
||
$this->handler = null;
|
||
$handler->close();
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 创建一个新会话，等同于new.
|
||
*
|
||
* @return static
|
||
*/
|
||
public static function newSession()
|
||
{
|
||
return new static();
|
||
}
|
||
|
||
/**
|
||
* 获取处理器.
|
||
*
|
||
* @return \Yurun\Util\YurunHttp\Handler\IHandler|null
|
||
*/
|
||
public function getHandler()
|
||
{
|
||
return $this->handler;
|
||
}
|
||
|
||
/**
|
||
* 设置请求地址
|
||
*
|
||
* @param string $url 请求地址
|
||
*
|
||
* @return static
|
||
*/
|
||
public function url($url)
|
||
{
|
||
$this->url = $url;
|
||
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* 设置发送内容，requestBody的别名.
|
||
*
|
||
* @param mixed $content 发送内容，可以是字符串、数组
|
||
*
|
||
* @return static
|
||
*/
|
||
public function content($content)
|
||
{
|
||
return $this->requestBody($content);
|
||
}
|
||
|
||
/**
|
||
* 设置参数，requestBody的别名.
|
||
*
|
||
* @param mixed $params 发送内容，可以是字符串、数组
|
||
*
|
||
* @return static
|
||
*/
|
||
public function params($params)
|
||
{
|
||
return $this->requestBody($params);
|
||
}
|
||
|
||
/**
|
||
* 设置请求主体.
|
||
*
|
||
* @param string|string|array $requestBody 发送内容，可以是字符串、数组
|
||
*
|
||
* @return static
|
||
*/
|
||
public function requestBody($requestBody)
|
||
{
|
||
$this->content = $requestBody;
|
||
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* 批量设置CURL的Option.
|
||
*
|
||
* @param array $options curl_setopt_array()所需要的第二个参数
|
||
*
|
||
* @return static
|
||
*/
|
||
public function options($options)
|
||
{
|
||
$thisOptions = &$this->options;
|
||
foreach ($options as $key => $value)
|
||
{
|
||
$thisOptions[$key] = $value;
|
||
}
|
||
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* 设置CURL的Option.
|
||
*
|
||
* @param int $option 需要设置的CURLOPT_XXX选项
|
||
* @param mixed $value 值
|
||
*
|
||
* @return static
|
||
*/
|
||
public function option($option, $value)
|
||
{
|
||
$this->options[$option] = $value;
|
||
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* 批量设置请求头.
|
||
*
|
||
* @param array $headers 键值数组
|
||
*
|
||
* @return static
|
||
*/
|
||
public function headers($headers)
|
||
{
|
||
$thisHeaders = &$this->headers;
|
||
$thisHeaders = array_merge($thisHeaders, $headers);
|
||
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* 设置请求头.
|
||
*
|
||
* @param string $header 请求头名称
|
||
* @param string $value 值
|
||
*
|
||
* @return static
|
||
*/
|
||
public function header($header, $value)
|
||
{
|
||
$this->headers[$header] = $value;
|
||
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* 批量设置请求头，.
|
||
*
|
||
* @param array $headers 纯文本 header 数组
|
||
*
|
||
* @return static
|
||
*/
|
||
public function rawHeaders($headers)
|
||
{
|
||
$thisHeaders = &$this->headers;
|
||
foreach ($headers as $header)
|
||
{
|
||
$list = explode(':', $header, 2);
|
||
$thisHeaders[trim($list[0])] = trim($list[1]);
|
||
}
|
||
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* 设置请求头.
|
||
*
|
||
* @param string $header 纯文本 header
|
||
*
|
||
* @return static
|
||
*/
|
||
public function rawHeader($header)
|
||
{
|
||
$list = explode(':', $header, 2);
|
||
$this->headers[trim($list[0])] = trim($list[1]);
|
||
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* 设置Accept.
|
||
*
|
||
* @param string $accept
|
||
*
|
||
* @return static
|
||
*/
|
||
public function accept($accept)
|
||
{
|
||
$this->headers['Accept'] = $accept;
|
||
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* 设置Accept-Language.
|
||
*
|
||
* @param string $acceptLanguage
|
||
*
|
||
* @return static
|
||
*/
|
||
public function acceptLanguage($acceptLanguage)
|
||
{
|
||
$this->headers['Accept-Language'] = $acceptLanguage;
|
||
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* 设置Accept-Encoding.
|
||
*
|
||
* @param string $acceptEncoding
|
||
*
|
||
* @return static
|
||
*/
|
||
public function acceptEncoding($acceptEncoding)
|
||
{
|
||
$this->headers['Accept-Encoding'] = $acceptEncoding;
|
||
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* 设置Accept-Ranges.
|
||
*
|
||
* @param string $acceptRanges
|
||
*
|
||
* @return static
|
||
*/
|
||
public function acceptRanges($acceptRanges)
|
||
{
|
||
$this->headers['Accept-Ranges'] = $acceptRanges;
|
||
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* 设置Cache-Control.
|
||
*
|
||
* @param string $cacheControl
|
||
*
|
||
* @return static
|
||
*/
|
||
public function cacheControl($cacheControl)
|
||
{
|
||
$this->headers['Cache-Control'] = $cacheControl;
|
||
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* 批量设置Cookies.
|
||
*
|
||
* @param array $cookies 键值对应数组
|
||
*
|
||
* @return static
|
||
*/
|
||
public function cookies($cookies)
|
||
{
|
||
$this->cookies = array_merge($this->cookies, $cookies);
|
||
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* 设置Cookie.
|
||
*
|
||
* @param string $name 名称
|
||
* @param string $value 值
|
||
*
|
||
* @return static
|
||
*/
|
||
public function cookie($name, $value)
|
||
{
|
||
$this->cookies[$name] = $value;
|
||
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* 设置Content-Type.
|
||
*
|
||
* @param string $contentType
|
||
*
|
||
* @return static
|
||
*/
|
||
public function contentType($contentType)
|
||
{
|
||
$this->headers['Content-Type'] = $contentType;
|
||
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* 设置Range.
|
||
*
|
||
* @param string $range
|
||
*
|
||
* @return static
|
||
*/
|
||
public function range($range)
|
||
{
|
||
$this->headers['Range'] = $range;
|
||
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* 设置Referer.
|
||
*
|
||
* @param string $referer
|
||
*
|
||
* @return static
|
||
*/
|
||
public function referer($referer)
|
||
{
|
||
$this->headers['Referer'] = $referer;
|
||
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* 设置User-Agent.
|
||
*
|
||
* @param string $userAgent
|
||
*
|
||
* @return static
|
||
*/
|
||
public function userAgent($userAgent)
|
||
{
|
||
$this->headers['User-Agent'] = $userAgent;
|
||
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* 设置User-Agent，userAgent的别名.
|
||
*
|
||
* @param string $userAgent
|
||
*
|
||
* @return static
|
||
*/
|
||
public function ua($userAgent)
|
||
{
|
||
return $this->userAgent($userAgent);
|
||
}
|
||
|
||
/**
|
||
* 设置失败重试次数，状态码为5XX或者0才需要重试.
|
||
*
|
||
* @param string $retry
|
||
*
|
||
* @return static
|
||
*/
|
||
public function retry($retry)
|
||
{
|
||
$this->retry = $retry < 0 ? 0 : $retry; //至少请求1次，即重试0次
|
||
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* 代理.
|
||
*
|
||
* @param string $server 代理服务器地址
|
||
* @param int $port 代理服务器端口
|
||
* @param string $type 代理类型，支持：http、socks4、socks4a、socks5
|
||
* @param string $auth 代理认证方式，支持：basic、ntlm。一般默认basic
|
||
*
|
||
* @return static
|
||
*/
|
||
public function proxy($server, $port, $type = 'http', $auth = 'basic')
|
||
{
|
||
$this->useProxy = true;
|
||
$this->proxy = [
|
||
'server' => $server,
|
||
'port' => $port,
|
||
'type' => $type,
|
||
'auth' => $auth,
|
||
];
|
||
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* 代理认证
|
||
*
|
||
* @param string $username
|
||
* @param string $password
|
||
*
|
||
* @return static
|
||
*/
|
||
public function proxyAuth($username, $password)
|
||
{
|
||
$this->proxy['username'] = $username;
|
||
$this->proxy['password'] = $password;
|
||
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* 设置超时时间.
|
||
*
|
||
* @param int $timeout 总超时时间，单位：毫秒
|
||
* @param int $connectTimeout 连接超时时间，单位：毫秒
|
||
*
|
||
* @return static
|
||
*/
|
||
public function timeout($timeout = null, $connectTimeout = null)
|
||
{
|
||
if (null !== $timeout)
|
||
{
|
||
$this->timeout = $timeout;
|
||
}
|
||
if (null !== $connectTimeout)
|
||
{
|
||
$this->connectTimeout = $connectTimeout;
|
||
}
|
||
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* 限速
|
||
*
|
||
* @param int $download 下载速度，为0则不限制，单位：字节
|
||
* @param int $upload 上传速度，为0则不限制，单位：字节
|
||
*
|
||
* @return static
|
||
*/
|
||
public function limitRate($download = 0, $upload = 0)
|
||
{
|
||
$this->downloadSpeed = $download;
|
||
$this->uploadSpeed = $upload;
|
||
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* 设置用于连接中需要的用户名和密码
|
||
*
|
||
* @param string $username 用户名
|
||
* @param string $password 密码
|
||
*
|
||
* @return static
|
||
*/
|
||
public function userPwd($username, $password)
|
||
{
|
||
$this->username = $username;
|
||
$this->password = $password;
|
||
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* 保存至文件的设置.
|
||
*
|
||
* @param string $filePath 文件路径
|
||
* @param string $fileMode 文件打开方式，默认w+
|
||
*
|
||
* @return static
|
||
*/
|
||
public function saveFile($filePath, $fileMode = 'w+')
|
||
{
|
||
$this->saveFileOption['filePath'] = $filePath;
|
||
$this->saveFileOption['fileMode'] = $fileMode;
|
||
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* 获取文件保存路径.
|
||
*
|
||
* @return string|null
|
||
*/
|
||
public function getSavePath()
|
||
{
|
||
$saveFileOption = $this->saveFileOption;
|
||
|
||
return isset($saveFileOption['filePath']) ? $saveFileOption['filePath'] : null;
|
||
}
|
||
|
||
/**
|
||
* 设置SSL证书.
|
||
*
|
||
* @param string $path 一个包含 PEM 格式证书的文件名
|
||
* @param string $type 证书类型，支持的格式有”PEM”(默认值),“DER”和”ENG”
|
||
* @param string $password 使用证书需要的密码
|
||
*
|
||
* @return static
|
||
*/
|
||
public function sslCert($path, $type = null, $password = null)
|
||
{
|
||
$this->certPath = $path;
|
||
if (null !== $type)
|
||
{
|
||
$this->certType = $type;
|
||
}
|
||
if (null !== $password)
|
||
{
|
||
$this->certPassword = $password;
|
||
}
|
||
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* 设置SSL私钥.
|
||
*
|
||
* @param string $path 包含 SSL 私钥的文件名
|
||
* @param string $type certType规定的私钥的加密类型，支持的密钥类型为”PEM”(默认值)、”DER”和”ENG”
|
||
* @param string $password SSL私钥的密码
|
||
*
|
||
* @return static
|
||
*/
|
||
public function sslKey($path, $type = null, $password = null)
|
||
{
|
||
$this->keyPath = $path;
|
||
if (null !== $type)
|
||
{
|
||
$this->keyType = $type;
|
||
}
|
||
if (null !== $password)
|
||
{
|
||
$this->keyPassword = $password;
|
||
}
|
||
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* 设置请求方法.
|
||
*
|
||
* @param string $method
|
||
*
|
||
* @return static
|
||
*/
|
||
public function method($method)
|
||
{
|
||
$this->method = $method;
|
||
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* 设置是否启用连接池.
|
||
*
|
||
* @param bool $connectionPool
|
||
*
|
||
* @return static
|
||
*/
|
||
public function connectionPool($connectionPool)
|
||
{
|
||
$this->connectionPool = $connectionPool;
|
||
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* 处理请求主体.
|
||
*
|
||
* @param string|string|array $requestBody
|
||
* @param string|null $contentType 内容类型，支持null/json，为null时不处理
|
||
*
|
||
* @return array
|
||
*/
|
||
protected function parseRequestBody($requestBody, $contentType)
|
||
{
|
||
$body = $files = [];
|
||
if (\is_string($requestBody))
|
||
{
|
||
$body = $requestBody;
|
||
}
|
||
elseif (\is_array($requestBody))
|
||
{
|
||
switch ($contentType)
|
||
{
|
||
case 'json':
|
||
$body = json_encode($requestBody);
|
||
$this->header('Content-Type', MediaType::APPLICATION_JSON);
|
||
break;
|
||
default:
|
||
foreach ($requestBody as $k => $v)
|
||
{
|
||
if ($v instanceof UploadedFile)
|
||
{
|
||
$files[$k] = $v;
|
||
}
|
||
else
|
||
{
|
||
$body[$k] = $v;
|
||
}
|
||
}
|
||
$body = http_build_query($body, '', '&');
|
||
}
|
||
}
|
||
else
|
||
{
|
||
throw new \InvalidArgumentException('$requestBody only can be string or array');
|
||
}
|
||
|
||
return [$body, $files];
|
||
}
|
||
|
||
/**
|
||
* 构建请求类.
|
||
*
|
||
* @param string $url 请求地址，如果为null则取url属性值
|
||
* @param string|array $requestBody 发送内容，可以是字符串、数组，如果为空则取content属性值
|
||
* @param string|null $method 请求方法，GET、POST等
|
||
* @param string|null $contentType 内容类型，支持null/json，为null时不处理
|
||
*
|
||
* @return \Yurun\Util\YurunHttp\Http\Request
|
||
*/
|
||
public function buildRequest($url = null, $requestBody = null, $method = null, $contentType = null)
|
||
{
|
||
if (null === $url)
|
||
{
|
||
$url = $this->url;
|
||
}
|
||
if (null === $method)
|
||
{
|
||
$method = $this->method;
|
||
}
|
||
list($body, $files) = $this->parseRequestBody(null === $requestBody ? $this->content : $requestBody, $contentType);
|
||
$request = new Request($url, $this->headers, $body, $method);
|
||
$saveFileOption = $this->saveFileOption;
|
||
$request = $request->withUploadedFiles($files)
|
||
->withCookieParams($this->cookies)
|
||
->withAttribute(Attributes::MAX_REDIRECTS, $this->maxRedirects)
|
||
->withAttribute(Attributes::IS_VERIFY_CA, $this->isVerifyCA)
|
||
->withAttribute(Attributes::CA_CERT, $this->caCert)
|
||
->withAttribute(Attributes::CERT_PATH, $this->certPath)
|
||
->withAttribute(Attributes::CERT_PASSWORD, $this->certPassword)
|
||
->withAttribute(Attributes::CERT_TYPE, $this->certType)
|
||
->withAttribute(Attributes::KEY_PATH, $this->keyPath)
|
||
->withAttribute(Attributes::KEY_PASSWORD, $this->keyPassword)
|
||
->withAttribute(Attributes::KEY_TYPE, $this->keyType)
|
||
->withAttribute(Attributes::OPTIONS, $this->options)
|
||
->withAttribute(Attributes::SAVE_FILE_PATH, isset($saveFileOption['filePath']) ? $saveFileOption['filePath'] : null)
|
||
->withAttribute(Attributes::USE_PROXY, $this->useProxy)
|
||
->withAttribute(Attributes::USERNAME, $this->username)
|
||
->withAttribute(Attributes::PASSWORD, $this->password)
|
||
->withAttribute(Attributes::CONNECT_TIMEOUT, $this->connectTimeout)
|
||
->withAttribute(Attributes::TIMEOUT, $this->timeout)
|
||
->withAttribute(Attributes::DOWNLOAD_SPEED, $this->downloadSpeed)
|
||
->withAttribute(Attributes::UPLOAD_SPEED, $this->uploadSpeed)
|
||
->withAttribute(Attributes::FOLLOW_LOCATION, $this->followLocation)
|
||
->withAttribute(Attributes::CONNECTION_POOL, $this->connectionPool)
|
||
->withProtocolVersion($this->protocolVersion)
|
||
;
|
||
foreach ($this->proxy as $name => $value)
|
||
{
|
||
$request = $request->withAttribute('proxy.' . $name, $value);
|
||
}
|
||
|
||
return $request;
|
||
}
|
||
|
||
/**
|
||
* 发送请求，所有请求的老祖宗.
|
||
*
|
||
* @param string|null $url 请求地址，如果为null则取url属性值
|
||
* @param string|array|null $requestBody 发送内容，可以是字符串、数组，如果为空则取content属性值
|
||
* @param string $method 请求方法，GET、POST等
|
||
* @param string|null $contentType 内容类型，支持null/json，为null时不处理
|
||
*
|
||
* @return \Yurun\Util\YurunHttp\Http\Response|null
|
||
*/
|
||
public function send($url = null, $requestBody = null, $method = null, $contentType = null)
|
||
{
|
||
$request = $this->buildRequest($url, $requestBody, $method, $contentType);
|
||
|
||
return YurunHttp::send($request, $this->handler);
|
||
}
|
||
|
||
/**
|
||
* 发送 Http2 请求不调用 recv().
|
||
*
|
||
* @param string|null $url 请求地址，如果为null则取url属性值
|
||
* @param string|array|null $requestBody 发送内容，可以是字符串、数组，如果为空则取content属性值
|
||
* @param string $method 请求方法，GET、POST等
|
||
* @param string|null $contentType 内容类型，支持null/json，为null时不处理
|
||
*
|
||
* @return \Yurun\Util\YurunHttp\Http\Response|null
|
||
*/
|
||
public function sendHttp2WithoutRecv($url = null, $requestBody = null, $method = 'GET', $contentType = null)
|
||
{
|
||
$request = $this->buildRequest($url, $requestBody, $method, $contentType)
|
||
->withProtocolVersion('2.0')
|
||
->withAttribute(Attributes::HTTP2_NOT_RECV, true);
|
||
|
||
return YurunHttp::send($request, $this->handler);
|
||
}
|
||
|
||
/**
|
||
* GET请求
|
||
*
|
||
* @param string $url 请求地址，如果为null则取url属性值
|
||
* @param string|array $requestBody 发送内容，可以是字符串、数组，如果为空则取content属性值
|
||
*
|
||
* @return \Yurun\Util\YurunHttp\Http\Response|null
|
||
*/
|
||
public function get($url = null, $requestBody = null)
|
||
{
|
||
if (!empty($requestBody))
|
||
{
|
||
if (strpos($url, '?'))
|
||
{
|
||
$url .= '&';
|
||
}
|
||
else
|
||
{
|
||
$url .= '?';
|
||
}
|
||
$url .= http_build_query($requestBody, '', '&');
|
||
}
|
||
|
||
return $this->send($url, [], 'GET');
|
||
}
|
||
|
||
/**
|
||
* POST请求
|
||
*
|
||
* @param string $url 请求地址，如果为null则取url属性值
|
||
* @param string|array $requestBody 发送内容，可以是字符串、数组，如果为空则取content属性值
|
||
* @param string|null $contentType 内容类型，支持null/json，为null时不处理
|
||
*
|
||
* @return \Yurun\Util\YurunHttp\Http\Response|null
|
||
*/
|
||
public function post($url = null, $requestBody = null, $contentType = null)
|
||
{
|
||
return $this->send($url, $requestBody, 'POST', $contentType);
|
||
}
|
||
|
||
/**
|
||
* HEAD请求
|
||
*
|
||
* @param string $url 请求地址，如果为null则取url属性值
|
||
* @param string|array $requestBody 发送内容，可以是字符串、数组，如果为空则取content属性值
|
||
*
|
||
* @return \Yurun\Util\YurunHttp\Http\Response|null
|
||
*/
|
||
public function head($url = null, $requestBody = null)
|
||
{
|
||
return $this->send($url, $requestBody, 'HEAD');
|
||
}
|
||
|
||
/**
|
||
* PUT请求
|
||
*
|
||
* @param string $url 请求地址，如果为null则取url属性值
|
||
* @param string|array $requestBody 发送内容，可以是字符串、数组，如果为空则取content属性值
|
||
* @param string|null $contentType 内容类型，支持null/json，为null时不处理
|
||
*
|
||
* @return \Yurun\Util\YurunHttp\Http\Response|null
|
||
*/
|
||
public function put($url = null, $requestBody = null, $contentType = null)
|
||
{
|
||
return $this->send($url, $requestBody, 'PUT', $contentType);
|
||
}
|
||
|
||
/**
|
||
* PATCH请求
|
||
*
|
||
* @param string $url 请求地址，如果为null则取url属性值
|
||
* @param string|array $requestBody 发送内容，可以是字符串、数组，如果为空则取content属性值
|
||
* @param string|null $contentType 内容类型，支持null/json，为null时不处理
|
||
*
|
||
* @return \Yurun\Util\YurunHttp\Http\Response|null
|
||
*/
|
||
public function patch($url = null, $requestBody = null, $contentType = null)
|
||
{
|
||
return $this->send($url, $requestBody, 'PATCH', $contentType);
|
||
}
|
||
|
||
/**
|
||
* DELETE请求
|
||
*
|
||
* @param string $url 请求地址，如果为null则取url属性值
|
||
* @param string|array $requestBody 发送内容，可以是字符串、数组，如果为空则取content属性值
|
||
* @param string|null $contentType 内容类型，支持null/json，为null时不处理
|
||
*
|
||
* @return \Yurun\Util\YurunHttp\Http\Response|null
|
||
*/
|
||
public function delete($url = null, $requestBody = null, $contentType = null)
|
||
{
|
||
return $this->send($url, $requestBody, 'DELETE', $contentType);
|
||
}
|
||
|
||
/**
|
||
* 直接下载文件.
|
||
*
|
||
* @param string $fileName 保存路径，如果以 .* 结尾，则根据 Content-Type 自动决定扩展名
|
||
* @param string $url 下载文件地址
|
||
* @param string|array $requestBody 发送内容，可以是字符串、数组，如果为空则取content属性值
|
||
* @param string $method 请求方法，GET、POST等，一般用GET
|
||
*
|
||
* @return \Yurun\Util\YurunHttp\Http\Response|null
|
||
*/
|
||
public function download($fileName, $url = null, $requestBody = null, $method = 'GET')
|
||
{
|
||
$isAutoExt = self::checkDownloadIsAutoExt($fileName, $fileName);
|
||
$result = $this->saveFile($fileName)->send($url, $requestBody, $method);
|
||
if ($isAutoExt)
|
||
{
|
||
self::parseDownloadAutoExt($result, $fileName);
|
||
}
|
||
$this->saveFileOption = [];
|
||
|
||
return $result;
|
||
}
|
||
|
||
/**
|
||
* WebSocket.
|
||
*
|
||
* @param string $url
|
||
*
|
||
* @return \Yurun\Util\YurunHttp\WebSocket\IWebSocketClient
|
||
*/
|
||
public function websocket($url = null)
|
||
{
|
||
$request = $this->buildRequest($url);
|
||
|
||
return YurunHttp::websocket($request, $this->handler);
|
||
}
|
||
|
||
/**
|
||
* 检查下载文件名是否要自动扩展名.
|
||
*
|
||
* @param string $fileName
|
||
* @param string $tempFileName
|
||
*
|
||
* @return bool
|
||
*/
|
||
public static function checkDownloadIsAutoExt($fileName, &$tempFileName)
|
||
{
|
||
$flagLength = \strlen(self::AUTO_EXT_FLAG);
|
||
if (self::AUTO_EXT_FLAG !== substr($fileName, -$flagLength))
|
||
{
|
||
return false;
|
||
}
|
||
$tempFileName = substr($fileName, 0, -$flagLength) . self::AUTO_EXT_TEMP_EXT;
|
||
|
||
return true;
|
||
}
|
||
|
||
/**
|
||
* 处理下载的自动扩展名.
|
||
*
|
||
* @param \Yurun\Util\YurunHttp\Http\Response $response
|
||
* @param string $tempFileName
|
||
*
|
||
* @return void
|
||
*/
|
||
public static function parseDownloadAutoExt(&$response, $tempFileName)
|
||
{
|
||
$ext = MediaType::getExt($response->getHeaderLine('Content-Type'));
|
||
if (null === $ext)
|
||
{
|
||
$ext = 'file';
|
||
}
|
||
$savedFileName = substr($tempFileName, 0, -\strlen(self::AUTO_EXT_TEMP_EXT)) . '.' . $ext;
|
||
rename($tempFileName, $savedFileName);
|
||
$response = $response->withSavedFileName($savedFileName);
|
||
}
|
||
}
|
||
|
||
if (\extension_loaded('curl'))
|
||
{
|
||
// 代理认证方式
|
||
HttpRequest::$proxyAuths = [
|
||
'basic' => \CURLAUTH_BASIC,
|
||
'ntlm' => \CURLAUTH_NTLM,
|
||
];
|
||
|
||
// 代理类型
|
||
HttpRequest::$proxyType = [
|
||
'http' => \CURLPROXY_HTTP,
|
||
'socks4' => \CURLPROXY_SOCKS4,
|
||
'socks4a' => 6, // CURLPROXY_SOCKS4A
|
||
'socks5' => \CURLPROXY_SOCKS5,
|
||
];
|
||
}
|