Skip to content
Official PHP client library to interact with residue seamlessly.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Residue PHP Client

A very simple, secure PHP library to interact with residue seamlessly.

This library provides interface for connecting and interacting with residue server seamlessly, means, once you are connected this module takes care of expired clients and keep itself updated with latest parameters and ping server when needed to stay alive.

Version GitHub license



This library currently depends on following binaries

  • ripe
  • nc (netcat)

Please check out sample configuration to find out more


This library does not currently support following features:

  • Unknown clients
  • Plain log request
  • Custom key size


Config Type Description
url String Combination of URI and port of residue server
application_id String Application ID for %app format specifier
rsa_key_size Number RSA key size (generated randomly) for unknown clients
time_offset Number Log time offset (in seconds)
client_id String Client ID that server knows this client as
client_private_key String Full path of RSA private key
client_key_secret String Secret (passphrase) for encrypted private key (if any)
server_public_key String Full path to server public key (if any)
ripe_bin String Command to successfully run ripe binary using user that will run your PHP script

Problems occur if the user running the script cannot run ripe or nc binaries. You may also be interested in following issues on stackexchange network
* how to set crontab PATH variable
* How to get CRON to call in the correct PATHs
* How to set cron PATH globally (i.e. for all users) permanently?
nc_bin String Command to successfully run nc binary using user that will run your PHP script
session_dir String Full path to an empty directory for storing temporary objects by library (e.g, connection params etc). This directory must not contain anything and it may be cleared at times by this library.
reset_conn Number Forcefully resets the connection after this time (in seconds)
internal_log_file_limit Number Maximum limit (in KB) for internal logging file (stored in <session_dir>/internal.log). Defaults to 2048 KB

Sample Config

    "url": "localhost:8777",
    "application_id": "org.zuhd.residue.php.sampleapp",
    "rsa_key_size": 2048,
    "time_offset": 0,
    "client_id": "muflihun00102030",
    "client_private_key": "keys/muflihun00102030.pem",
    "client_key_secret": "",
    "server_public_key": "keys/",
    "ripe_bin": "ripe",
    "nc_bin": "nc",
    "session_dir": "/tmp/resphp/",
    "reset_conn": 120,
    "internal_log_file_limit": 2048


// initialize only once in the beginning of the script

$logger = new \residue\Logger("sample-app");

// we're all set! (if everything was good in client.conf.json file)


// array
$logger->info([1, 2]);

// object
$logger->info("blah %s this", $myCar);

// number

// formatted (see
$logger->info("test %s %s", 1, 2);

// verbose log
$logger->verbose(9, "this is msg %d ---", 123);


Copyright 2017-present Zuhd Web Services
Copyright 2017-present @abumusamq

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
See the License for the specific language governing permissions and
limitations under the License.
You can’t perform that action at this time.