PHPackages                             hanoivip/curl-helper - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. hanoivip/curl-helper

ActiveLibrary

hanoivip/curl-helper
====================

PHP Curl Helper 2.2

025PHP

Since Feb 15Pushed 2y ago1 watchersCompare

[ Source](https://github.com/hanoivip/curl-helper)[ Packagist](https://packagist.org/packages/hanoivip/curl-helper)[ RSS](/packages/hanoivip-curl-helper/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

CurlHelper
==========

[](#curlhelper)

Small useful helper for PHP Curl.
Require PHP >= 5.4

Installation
------------

[](#installation)

Install via `composer`:

```
composer require mervick/curl-helper
```

or download `CurlHelper.php` and include it in yours php files.

Usage
-----

[](#usage)

```
$url = 'http://example.com/path/script?get1=val1';

// Simple GET request
$response = Mervick\CurlHelper::factory($url)->exec();

var_dump($response);
// Will be output array with few keys:
// $response['status']      - http code, example "200' on success
// $response['type']        - `Content-Type` from headers, example "application/json; charset=utf-8"
// $response['headers']     - assoc array with all parsed headers
// $response['cookies']     - assoc array with cookies from `Set-Cookie` headers
// $response['headers_raw'] - headers raw
// $response['content']     - content
// $response['data']        - assoc array of json decoded content or false
// $response['xpath']       - array with parsed xpath values or null

// Add and/or modify some GET params
$response = Mervick\CurlHelper::factory($url)
    ->setGetParams(['get2' => 'val2'])
    ->exec();

// Follow location
$response = Mervick\CurlHelper::factory($url)
    ->follow(true)
    ->exec();

// Xpath
$response = Mervick\CurlHelper::factory($url)
    ->xpath([
        'title' => '//title',
        'token' => '*/meta[@name="csrf-token"]/@content'
    ])
    ->exec();

// Writes verbose information to STDERR
$response = Mervick\CurlHelper::factory($url)
    ->debug(true)
    ->exec();

// Writes verbose information to the file
$response = Mervick\CurlHelper::factory($url)
    ->debug('/path/to/file')
    ->exec();

// POST request with headers
$response = Mervick\CurlHelper::factory($url)
    // Content-Type: application/x-www-form-urlencoded
    // this one is default for POST, so you can skip it
    ->setHeaders(['Content-Type' => Mervick\CurlHelper::MIME_X_WWW_FORM])
    ->setHeaders([
        'Some-Header1' => 'SomeValue1',
        'Some-Header2' => 'SomeValue2',
    ])
    ->setPostFields([
        'somePostField' => 'somePostVal',
        'somePostArray' => [ // POST array
            'item1',
            'item2',
        ],
    ])
    ->exec();

// JSON POST request
$response = Mervick\CurlHelper::factory($url)
    // Content-Type: application/json
    ->setHeaders(['Content-Type' => Mervick\CurlHelper::MIME_JSON])
    ->setPostFields(['somePostField' => 'somePostVal'])
    ->exec();

// Set cookies
$response = Mervick\CurlHelper::factory($url)
    ->setCookies(['someField' => 'someVal'])
    ->exec();

// Send file
$response = Mervick\CurlHelper::factory($url)
    // Content-Type: multipart/form-data
    // this is default for sending files, so you can skip it
    ->setHeaders(['Content-Type' => Mervick\CurlHelper::MIME_FORM_DATA])
    ->putFile('fieldName', '/path/to/file')
    ->exec();

// Send multiple files
$response = Mervick\CurlHelper::factory($url)
    ->putFile('fieldName', '/path/to/file1')
    ->putFile('fieldNameArr[]', '/path/to/file2')
    ->putFile('fieldNameArr[]', '/path/to/file3')
    ->exec();

// Send raw file
$file_contents = file_get_contents('/file/to/path');
$response = Mervick\CurlHelper::factory($url)
    ->putFileRaw('fieldName', $file_contents, 'some.name', 'mime-type')
    ->exec();

// Send POST contents raw
$response = Mervick\CurlHelper::factory($url)
    ->setPostRaw($postRawContents)
    ->exec();

// Save and read cookies from/to the file
$response = Mervick\CurlHelper::factory($url)
    ->setCookieFile('/path/to/file')
    ->exec();

// Use proxy
$response = Mervick\CurlHelper::factory($url)
    ->useProxy('192.168.1.1:8080', 'login', 'password')
    ->exec();

// Set custom CURL options
$response = Mervick\CurlHelper::factory($url)
    ->setOptions([
        CURLOPT_CONNECTTIMEOUT => 60,
        CURLOPT_PROXYTYPE => CURLPROXY_SOCKS5,
    ])
    ->exec();
```

Error
-----

[](#error)

If the curl process get an error it will throw a RuntimeException. Example:

```
$url = 'htp://example.com/path/script?get1=val1';

// Simple GET request
$response = Mervick\CurlHelper::factory($url)->exec();

// PHP Fatal error:  Uncaught RuntimeException: Protocol "htp" not supported or disabled in libcurl in ***/CurlHelper.php:554
```

License
-------

[](#license)

MIT

curl-helper
===========

[](#curl-helper)

###  Health Score

13

—

LowBetter than 1% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community4

Small or concentrated contributor base

Maturity19

Early-stage or recently created project

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/a45208b20482235c83ed370f71c352d516693ace0dac53c7ed8244cace45682b?d=identicon)[hanoivip](/maintainers/hanoivip)

### Embed Badge

![Health badge](/badges/hanoivip-curl-helper/health.svg)

```
[![Health](https://phpackages.com/badges/hanoivip-curl-helper/health.svg)](https://phpackages.com/packages/hanoivip-curl-helper)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)