PHPackages                             sirmonti/shttp - 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. [HTTP &amp; Networking](/categories/http)
4. /
5. sirmonti/shttp

ActiveLibrary[HTTP &amp; Networking](/categories/http)

sirmonti/shttp
==============

Wrapper class around file\_get\_contents function to simplify http and https requests

8.2.0(1y ago)073↓100%MITPHPPHP &gt;=7.4

Since Jan 31Pushed 1y ago1 watchersCompare

[ Source](https://github.com/sirmonti/SHTTP)[ Packagist](https://packagist.org/packages/sirmonti/shttp)[ Docs](https://github.com/sirmonti/SHTTP)[ RSS](/packages/sirmonti-shttp/feed)WikiDiscussions main Synced today

READMEChangelog (3)Dependencies (2)Versions (4)Used By (0)

SHTTP - Simple HTTP client library
==================================

[](#shttp---simple-http-client-library)

Static version rapper around file\_get\_contents function to simplify HTTP and HTTPS connections

Description
-----------

[](#description)

Wrapper class around file\_get\_contents function. This class is not intended to compete with full featured network frameworks, as Guzzle or Swoole, but to provide a simple and convenient solution to use web services or access web resources.

This class is the static version of [simpleHTTP](https://github.com/sirmonti/simpleHTTP/)which means there is no need to create an object, methods can be called directly.

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

[](#installation)

Via composer

```
composer require sirmonti/shttp
```

This class does not have any external dependency, which means you don't need to do a full installation, you can simply download and drop [SHTTP.php](https://github.com/sirmonti/SHTTP/blob/main/src/SHTTP.php)file in your project folder.

Features
--------

[](#features)

- Lightweigth
- Very simple interface
- You can disable certificate verification, to allow sites with self-signed or expired certificates
- In HTTPS connections, the certificate chain for the remote is retrieved
- Certificate authentication supported. You can provide your certificate to authenticate agains remote site
- Configurable exception level. You can disable exceptions, fire exceptions only on network errors, or fire exceptions on HTTP errors too
- Responses in PSR7 format. This feature requires an external package installed

Basic usage
-----------

[](#basic-usage)

This is only a brief explanation, the file [SHTTP.md](SHTTP.md) provide a more extensive method reference.

Complete documentation can be found [Here](https://sirmonti.github.io/SHTTP/classes/SHTTP.html).

There are four global parameters: exception level, certificate validation flag, extra HTTP headers and Certificate Authentication.

Certificate validation flag is set via "verifCERT" boolean property, exception level via setExceptionLevel() method, extra HTTP headers via setExtraHeaders() method and Certificate Authentication via setAuthCert() method.

The certificate validation is a boolean flag that enable or disable the validation of the remote certificate on https connections. If the validation is enabled, if the remote site has a faulty certificate (expired, autosigned or for another domain) the connection will be aborted and an error will be fired. In disabled, the error will be ignored and the connection will be executed normally.

There are three exception levels:

- 0: Exceptions are disabled. Errors only set status code responses.
- 1: Exception only on network errors. HTTP errors will be reported as status codes.
- 2: Exception will be fired on any error.

Default values is exception level 1 and certificate validation enabled.

Supported methods are: **GET**, **POST**, **PUT**, **HEAD**, **DELETE**and **OPTIONS**. The request call return the request body and the other data, like response headers, are stored internally and can be retrieved.

Here, the most basic example of using this class

```
  SHTTP::get('https://www.example.com/');
  printf("Response data:\n%s\n",$resp);
```

Here, we modify certificate validation and exception level

```
  // Disable certificate validation
  SHTTP::verifCERT=false;
  // Set exception level to 2
  SHTTP::setExceptionLevel(2);
  // All subsequent requests will operate with this parameters
  $resp=SHTTP::get('https://www.examples.com/');
```

This library can return responses in PSR7 format, but is neccesary to have a third party library installed. Currently, [HttpSoft](https://github.com/httpsoft/http-message), [Nyholm](https://github.com/nyholm/psr7), [Guzzle](https://github.com/guzzle/psr7/), [Laminas-diactoros](https://github.com/laminas/laminas-diactoros) and [Slim](https://github.com/slimphp/Slim-Psr7) are supported. SHTTP detects which one is installed and will fire an error if none is installed.

PSR7 responses are useful because the main PHP frameworks use this format.

Example getting a PSR7 response

```
  SHTTP::get('https://www.example.com/');
  $resp=SHTTP::PSRResponse();
```

Examples
--------

[](#examples)

There are more examples in [examples](examples) folder.

The most simple usage is to call requests directly

```
  $resp1=SHTTP::get('https://www.example.com/data1.txt');
  $resp2=SHTTP::get('https://www.example.com/data2.json');
```

As you see, the object execute direct requests providing the URL.

Here, and example configuring exceptions and certificate acceptance

```
  // Exception level 2 (exception on network or HTTP errors)
  SHTTP::setExceptionLeve(2);
  // Certificate validation disabled (Will accept any certificate)
  SHTTP::verifCERT=false;
  $data=[
    'field1'=>'Data to send in field1',
    'field2'=>'Data to send in field2'
  ];
  // Execute a POST request sending the content of the $data variable
  $resp=SHTTP::post('https://www.example.com/sendpoint',$data);
```

Here, a POST with a JSON encoded body

```
  // Default exception level is 1, which means exceptions will be fired
  // only on network errors
  $data=[
    'field1'=>'Data to send in field1',
    'field2'=>'Data to send in field2'
  ];
  $resp=SHTTP::postJSON('https://www.example.com/jsonentrypoint',$data);
```

And here, a POST with an image as data body

```
  $data=file_get_contents('exampleimage.jpg');
  SHTTP::postRAW('https://www.example.com/imagenentrypoint','image/jpeg',$data);
```

But, What if you need to add an authentication header?

```
  // Create the authentication header
  $headers=[
    'Authorization: Bearer AuthenticationToken'
  ];
  // Configure the default headers to send
  SHTTP::setExtraHeaders($headers);
  $data=[
    'field1'=>'Data to send in field1',
    'field2'=>'Data to send in field2'
  ];
  $resp=SHTTP::post('https://www.example.com/sendpoint',$data);
```

But, If we need an extra header only in a specific request?

```
  $headers=[
    'Authorization: Bearer AuthenticationToken'
  ];
  // This header will be used by all subsequent requests
  SHTTP::setExtraHeaders($headers);
  $data=[
    'field1'=>'Data to send in field1',
    'field2'=>'Data to send in field2'
  ];
  // Add an extra header to this request
  $resp=SHTTP::post('https://www.example.com/sendpoint',$data,['X-Extra-Header: Data']);
```

The requests from this class use "SHTTP/7.0" as user agent. You can set your own one

```
  $headers=[
    'Authorization: Bearer AuthenticationToken',
    'User-Agent: MyOwnUserAgent/1.0'
  ];
  SHTTP::setExtraHeaders($headers);
  $data=[
    'field1'=>'Data to send in field1',
    'field2'=>'Data to send in field2'
  ];
  $resp=SHTTP::post('https://www.example.com/sendpoint',$data);
```

Here, a *PUT* request example

```
  $headers=[
    'Authorization: Bearer AuthenticationToken',
    'User-Agent: MyOwnUserAgent/1.0'
  ];
  SHTTP::setExtraHeaders($headers);
  $data=[
    'field1'=>'Data to send in field1',
    'field2'=>'Data to send in field2'
  ];
  // Example PUT with body in JSON format
  $resp=SHTTP::putJSON('https://www.example.com/sendpoint',$data);
```

But, How I can get the response headers and result status?

```
  $resp=SHTTP::get('https://www.example.com/');
  printf("HTTP/%s %d %s\n",$http->protocolVersion(),$http->respCode(),$http->respStatus());
  printf("Response mime type: %s\n",$http->respMIME());
```

This code will produce this output

```
HTTP/1.1 200 OK
Response mime type: text/html; charset=UTF-8

```

LICENSE
-------

[](#license)

This library is licensed under [MIT LICENSE](LICENSE)

###  Health Score

25

—

LowBetter than 39% of packages

Maintenance34

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community4

Small or concentrated contributor base

Maturity43

Maturing project, gaining track record

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.

###  Release Activity

Cadence

Every ~72 days

Total

3

Last Release

638d ago

Major Versions

7.0.0 → 8.0.02024-04-27

### Community

Maintainers

![](https://www.gravatar.com/avatar/0e6e5c1adbb57005dac92a328cebad6681217e99be229a35a24c500cf54f3dac?d=identicon)[sirmonti](/maintainers/sirmonti)

---

Tags

httppsr-7clientresthttp clientweb service

###  Code Quality

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/sirmonti-shttp/health.svg)

```
[![Health](https://phpackages.com/badges/sirmonti-shttp/health.svg)](https://phpackages.com/packages/sirmonti-shttp)
```

###  Alternatives

[guzzlehttp/guzzle

Guzzle is a PHP HTTP client library

23.5k974.9M28.1k](/packages/guzzlehttp-guzzle)[zoonman/pixabay-php-api

PixabayClient is a PHP HTTP client library to access Pixabay's API

3354.0k](/packages/zoonman-pixabay-php-api)[e-moe/guzzle6-bundle

Integrates Guzzle 6 into your Symfony application

11259.2k](/packages/e-moe-guzzle6-bundle)

PHPackages © 2026

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