PHPackages                             rakshazi/fping - 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. [Utility & Helpers](/categories/utility)
4. /
5. rakshazi/fping

ActiveLibrary[Utility & Helpers](/categories/utility)

rakshazi/fping
==============

Simple microservice / function to check target health

1.1.1(8y ago)058PHPPHP ^7.1

Since Dec 28Pushed 8y ago1 watchersCompare

[ Source](https://github.com/rakshazi/fping)[ Packagist](https://packagist.org/packages/rakshazi/fping)[ RSS](/packages/rakshazi-fping/feed)WikiDiscussions master Synced yesterday

READMEChangelog (3)DependenciesVersions (4)Used By (0)

fping
=====

[](#fping)

Simple microservice / [function](https://openfaas.com) to check target server, site, etc status.

Table of Contents
-----------------

[](#table-of-contents)

- [Usage](#usage)
    - [Docker](#docker)
    - [OpenFaaS](#openfaas)
    - [Composer (optional)](#composer-optional)
    - [API](#api)
        - [Request](#request)
        - [Response](#response)
- [Check types](#check-types)
    - [HTTP](#http)

Usage
-----

[](#usage)

### Docker

[](#docker)

```
docker run -d -p 8080:8080 rakshazi/fping

curl -X POST -d "type=HTTP&address=https://google.com" localhost:8080

#response
{"status_code":200,"time":0.448615,"should_contain":true,"should_not_contain":true,"status":true}
```

### OpenFaaS

[](#openfaas)

Coming soon...

### Composer (optional)

[](#composer-optional)

If you want to use fping "as-is", without docker, you can install it with composer:

```
composer require rakshazi/fping
```

### API

[](#api)

#### Request

[](#request)

fping built on top of [OpenFaaS Watchdog](https://openfaas.com) to provide simple API and integration with OpenFaaS.

To call fping, you should send **POST** request to fping address (in example above - localhost:8080) with following body structure:

**json**:

```
{
    "type": "Check type",
    "address": "Target server/site address",
    "timeout": 5, //integer timeout in seconds
    "optional": {} //optional params, specific for each check type
}
```

**raw form**:

```
type=Check type&address=Target address&timeout=5&optional[param1]=val1&optional[param2]=val2

```

#### Response

[](#response)

**json**:

```
{
    "status_code":200, //HTTP response status code
    "time":448, //response time in ms
    "should_contain":true, //optional for HTTP
    "should_not_contain":true, //optional for HTTP
    "status":true //check status - is target up or down
}
```

Check types
-----------

[](#check-types)

### HTTP

[](#http)

Check HTTP(-s) targets.

**optional params**:

- `should_contain` - Check response body for that string, check passed if string was found
- `should_not_contain` - Check response body for that string, check failed if string was found

Example:

```
curl -X POST -d "type=HTTP&address=https://example.com&timeout=5&optional[should_contain]=healthy&optional[should_not_contain]=error" localhost:8080
```

###  Health Score

26

—

LowBetter than 41% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community4

Small or concentrated contributor base

Maturity60

Established project with proven stability

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 ~52 days

Total

3

Last Release

3002d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/5d07cb59ba8a7317225b73c56424f74b590ac60f6991f958f58d31ab50bb70ef?d=identicon)[rakshazi](/maintainers/rakshazi)

### Embed Badge

![Health badge](/badges/rakshazi-fping/health.svg)

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

###  Alternatives

[lidongyooo/laravel-idempotent

laravel idempotent

122.2k](/packages/lidongyooo-laravel-idempotent)

PHPackages © 2026

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