enishant / magiccurl

MagicCurl PHP 库

1.0.0 2022-06-03 21:37 UTC

This package is auto-updated.

Last update: 2024-09-23 12:01:44 UTC


README

Stable PHP Version Require License Downloads

先决条件

  • PHP 7.x 至 8.1 的最小版本
  • PHP cURL 扩展

安装

  • 如果你的项目使用 composer,请运行以下命令
composer require enishant/magiccurl:1.0
  • 如果你没有使用 composer,请从发布部分下载最新版本。 你应该下载 magiccurl.zip 文件。之后,将 MagicCurl.php 包含在你的应用程序中,并通过创建其实例来使用 MagicCurl 方法。

注意:此 PHP 库遵循以下实践

  • Enishant\MagicCurl 命名空间下
  • 尽可能使用数组传递选项而不是多个参数
  • 所有请求和响应都使用 PHP CURL 扩展进行通信

基本用法

使用/不使用选项实例化 MagicCurl PHP 实例。

use Enishant\MagicCurl\MagicCurl;

$client = new MagicCurl;

选项

  • create_log - 为用户代理、头部、请求和响应创建日志。
  • log_path - 提供日志文件路径。
  • debug - 显示所有 PHP 错误。
  • user_agent - 自定义 用户代理 名称。

创建日志文件,更新所有权和权限

sudo touch /path/to/magiccurl.log

sudo chown www-data:www-data /path/to/magiccurl.log

sudo chmod 644 /path/to/magiccurl.log

use Enishant\MagicCurl\MagicCurl;

$options = [
	'create_log' => true,
	'log_path'   => '/path/to/magiccurl.log',
	'debug'      => true,
	'user_agent' => 'MagicCurl/1.0'
];

$client = new MagicCurl( $options );

资源可以通过 $client 对象访问。所有方法调用遵循以下模式

    // $client->function() to access the methods
    
    //Example - Request with GET method
    $client->get($url);
    $client->get($url, $payload, $headers);

    //Example - Request with POST method
    $headers = [
      'Accept: application/json',
      'Content-Type: application/json',
    ];
    $payload = ['data'=>'in array'];
    $client->post($url, $payload, $headers);

贡献

所有增强和修复的贡献将通过拉取请求接受,您也可以通过报告问题来贡献,点击此处 报告问题。

许可

MagicCurl PHP 库在 MIT 许可证下发布。有关详细信息,请参阅LICENSE 文件。