otifsolutions/curl-handler

此软件包通过简单地提供方法、URL和参数,使得项目中对API数据的访问变得简单。

V1.0.7 2024-06-12 13:22 UTC

This package is auto-updated.

Last update: 2024-09-12 14:52:09 UTC


README

一个易于使用的Curl类。允许单行简单的API调用。

需求

PHP 7 > PHP 8.1

如何使用库

通过Composer Composer 安装(推荐)

使用Composer(推荐)

composer require otifsolutions/curl-handler

包类的命名空间

use OTIFSolutions\CurlHandler\Curl

使用包的curl类的方法

url('')

header([])

params([])

body([])

referer('')

agent('')

execute()

getCurlErrors();    // used to display errors if any

支持的请求方法

GET

POST

PUT

DELETE

如何使用此软件包

use OTIFSolutions\CurlHandler\Curl;
use OTIFSolutions\CurlHandler\Exceptions\CurlException;

try{

    Curl::Make()
        ->GET // this could be, get, post, put, delete
        ->url('REQUEST_URL_GOES_HERE')
        ->header(['AUTHENTICATION_ARRAY_GOES_HERE'])
        ->body(['BODY_ARRAY_GOES_HERE'])
        ->referer('https://www.google.com')
        ->agent('Mozilla/5.0 (Windows NT 6.1; WOW64; rv:7.0.1) Gecko/20100101 Firefox/7.0.12011-10-16 20:23:00')
        ->params(['PARAMETERS_ARRAY_GOES_HERE'])
        ->execute();
}

catch(CurlException $ce){
    return ($ce->getCurlErrors());
}

软件包中所有方法/请求的方法签名

`url('STRING') : Object`,
`header(['ARRAY']) : Object`,
`body(['ARRAY']) : Object`,
`params(['ARRAY]) : Object`,
`referer('STRING') : Object`,
`agent('STRING') : Object`,
`execute() : array`,
`getCurlErrors() : array`,
`isJson('string'): bool`,
`isDomDocument('string'): bool`,
`domToArray($node): mixed`

如果你使用的是 PhpStorm IDE,则无需每次都检查方法签名,只需转到方法,单击它,然后在该方法上按 CTRL + Q,属于此方法的所有内容都将显示出来。

API调用的GET请求

use OTIFSolutions\CurlHandler\Curl;

Curl::Make()
    ->GET
    ->url('URL_GOES_HERE')
    ->header(['AUTHENTICATION_ARRAY_GOES_HERE'])
    ->params(['PARAMS_ARRAY_GOES_HERE'])
    ->execute();

POST请求

use OTIFSolutions\CurlHandler\Curl;

Curl::Make()
    ->POST
    ->url('URL_GOES_HERE')
    ->header(['AUTHENTICATION_ARRAY_GOES_HERE'])
    ->body(['BODY_ARRAY_GOES_HERE'])
    ->params(['PARAMS_ARRAY_GOES_HERE'])
    ->execute();

PUT请求

use OTIFSolutions\CurlHandler\Curl;

Curl::Make()
    ->PUT
    ->url('URL_GOES_HERE')
    ->header(['AUTHENTICATION_ARRAY_GOES_HERE'])
    ->body(['BODY_ARRAY_GOES_HERE'])
    ->params(['PARAMS_ARRAY_GOES_HERE'])
    ->execute();

DELETE请求

use OTIFSolutions\CurlHandler\Curl;

Curl::Make()
    ->DELETE
    ->url('URL_GOES_HERE')
    ->header(['AUTHENTICATION_ARRAY_GOES_HERE'])
    ->params(['PARAMS_ARRAY_GOES_HERE'])
    ->execute();

注意(预防)

如果你调用不属于 OTIFSolutions\CurlHandler\Curl::class 的任何方法或提供它不理解任何参数,那么你将看到错误消息。

你可以检查的实时示例

此示例演示了使用 curl-handleerget 方法,请参阅

laravel-currency-layer/Commands/FetchCurrencyRates