Help me \Rhonda

Rhonda is a composer installable package that provides solutions to common PHP tasks.

Install

  composer require peledies/rhonda:~1
  composer install

Require in your project

Add the folowing to your composer.json file

  "require": {
    "peledies/rhonda": "~1"
  }

Classes and Methods

\Rhonda\Autoload

Recursivly load all .php files in the provided path, excludes any index.php files.

Method Description
path(string) Path to load all php files recursively 
  \Rhonda\Autoload::path(__DIR__."/path/to/load/");

OR

  $load = new \Rhonda\Autoload();
  $load->path(__DIR__."/path/to/load/");

\Rhonda\Arrays

Handle Array verification and modification tasks

Method Description
empty_property_check(array) Checks if there is an empty property in an array or object 
  \Rhonda\Arrays::empty_property_check(array());

OR

  $check_array = new \Rhonda\Arrays();
  $check_array->empty_property_check(array());

\Rhonda\UUID

Method Description
create() Create a new UUID 
  \Rhonda\UUID::create();

OR

  $uuid = new \Rhonda\UUID();
  $uuid->create();

\Rhonda\Request

Package all incomming request data into a singleton that can be accessed by your application. ALL data that goes through packager is automatically mysql_real_eacaped even array's and objects recursively.

Method Description
get('param') Get the provided query string parameter, mysql escaped
post() Get the provided request body, mysql escaped

In order to use this class you need to first run the packager right after Rhonda is included in your project

  \Rhonda\Request::packager();
  # GET parameters
  $thing = \Rhonda\Request::get();
  # GET specific query string value
  $thing = \Rhonda\Request::get('string');
  # POST body
  $thing = \Rhonda\Request::post();

\Rhonda\RequestBody

use \Rhonda\Request for a mysql escaped request body

Method Description
get(boolean) Get the provided request body, exception can be bypassed by putting TRUE as an argument 
  \Rhonda\RequestBody::get();

OR

  $request_body = new \Rhonda\RequestBody();
  $request_body->get();

OR Bypass exception

  $request_body = new \Rhonda\RequestBody();
  $request_body->get(TRUE);

\Rhonda\Response

Method Description
package(STRING/ARRAY/OBJECT) Package the data in an object with possible errors 
  \Rhonda\Response::package($data);

OR

  $response_package = new \Rhonda\Response();
  $response_package->package($data);

\Rhonda\Success

Method Description
create() create a uniform success message 
  echo \Rhonda\Success:: create();

OR

  $msg = new \Rhonda\Success();
  echo $msg->create();

\Rhonda\Error

Method Description
handle() Fromat an exception for return. Also writes a pretty stack trace to the error log
deprecation_warning(message, alternate route) Adds a Warning header and changes the status code to 299
add_summary_item(**Object**) Adds any object to the error summary singleton
summary() Retrieves the error summary data **Array** 
  try{
    throw new Exception("Demo Error Exception");
  }catch(\Exception $e){
    echo \Rhonda\Error::handle($e);
  }

OR

  try{
    throw new Exception("Demo Error Exception");
  }catch(\Exception $e){
    $error = new \Rhonda\Error();
    echo $error->handle($e);
  }

\Rhonda\Config

Method Description
load_file() Load a JSON file into memory as an object for later retrieval
load_object() Load an object into memory for later retrieval
get() Retrieve a configuration object from memory

Load Object to memory

  $object = new stdClass();
  $object->thing_1 = 'something one';
  $object->thing_2 = 'something two';
  \Rhonda\Config::load_object('test_one', $object);

Load JSON file to memory

  // File path is relative to your project root
  $config->load_file('test_two', 'path/to/file.json');

Retrieve a configuration object from memory

\Rhonda\Config::get('test_one');

\Rhonda\APIGateway

Method Description
run(boolean) Run a request to an external URL. optional parameter for exception throw (Default=true)

Make a request to an external address with custom headers and a request body

try{
  $headers = array("Domain"=>"domain_1", "Authorization"=>"sometoken");
  $data = (object) array("handle"=>"demo_1", "password"=>"asdf");
  $api = new \Rhonda\APIGateway('POST','http://elguapo.eventlink.local/authenticateasdf/',$data, $headers);
  $data = $api->run();
}catch(\Exception $e){
  $error = new \Rhonda\Error();
  echo $error->handle($e);
}

\Rhonda\Strings

Method Description
validate( type_string, test_string ) Return True/False
validate_or_error( type_string, test_string ) Return True/False or throws exception
normalize( string ) Returns normalized string

String Normalization

Validation Types

Type Description
'email' Verifies proper email structure
'username' Tests that string only includes a-z 0-9 . - or _

Test that a string is a valid email (without exception)

try{
  // PASS
  $string = 'test@test.com';
  \Rhonda\Strings:: validate('email',$string);

  // FAIL
  $string = 'test@test';
  \Rhonda\Strings:: validate('email',$string);

  // Catch will not be invoked
}catch(\Exception $e){
  echo \Rhonda\Error:: handle($e);
}

Test that a string is a valid email (with exception)

try{
  // PASS
  $string = 'test@test.com';
  \Rhonda\Strings:: validate_or_error('email',$string);

  // FAIL
  $string = 'test@test';
  \Rhonda\Strings:: validate_or_error('email',$string);

  // Catch will be invoked
}catch(\Exception $e){
  echo \Rhonda\Error:: handle($e);
}

Normalize a string

  $input = 'Some TEST-@#string-#$-!@';
  \Rhonda\Strings:: normalize($input);

  // Returns
  some_test_string

\Rhonda\Headers

Method Description
getallheaders() Return an Array of all request headers, works for Apache, PHP, and Nginx servers
set_response_code(integer) Set the response code and text to a specific value (accepts: 200, 209, 400, 404)

Retrieve All request headers as an Array

  $headers = \Rhonda\Headers:: getallheaders();

OR

  $headers = new \Rhonda\Headers();
  $headers->getallheaders();

\Rhonda\Mysql

Method Description
real_escape(String, Array, Object) Escape the thing being passed in by utilizing mysqli and real_escape_string. These methods require a mysql connection so you will need to load a config file into the variable DB. real_escape uses utf-8 as the charset. When escaping an Array or Object, recursion is used and it will drill through the object/array and escape everything.
bool_to_string(STRING) Convert ANY truthy or falsy thing into a '1' or a '0' for mysql query building

Escape a String

$string = "that's all folks";
$string = \Rhonda\Mysql::real_escape($string);

Escape an Object

$object = new \stdClass();
$object->thing = "it's for real";
$object = \Rhonda\Mysql::real_escape($object);

Escape an Array

$array = array(
   "ray"=>"it's escaping arrays"
 , "ray2"=>"escape's this one too"
);
$array = \Rhonda\Mysql::real_escape($ray);

Convert to Mysql boolean

  $value = \Rhonda\Mysql:: bool_to_string('true');
  OR
  $mysql = new \Rhonda\Mysql();
  $value = $mysql->bool_to_string('true');

\Rhonda\ServiceChain

Method Description
register(optional) Register this application or micro service to the service chain.
report(Boolean) Return a string (default) or an Array of the service chain if parameter is set to TRUE

If you are using ServiceChain, register() should be one of the first things you do in your application, preferably immediately after the composer autoload.

The default behavior of register is to use your config object named system for a property named host. \Rhonda\ServiceChain:: register() will automatically use that value for the service name.

(Prefered) Register this micro service to the service chain using a config file

  require_once __DIR__ . '/../vendor/autoload.php';

  // Load your configuration file to memory
  \Rhonda\Config:: load_file('system', 'path/to/file.json');

  // Register your service name
  \Rhonda\ServiceChain:: register();

Register this micro service to the service chain using a parameter

  require_once __DIR__ . '/../vendor/autoload.php';

  // Register your service name
  \Rhonda\ServiceChain:: register('Service-Name');

Get the current service chain state

  // "Returns: service1 => service2 => etc"
  \Rhonda\ServiceChain:: report();

  // "Returns: array("service1", "service2", "etc")
  \Rhonda\ServiceChain:: report(TRUE);

\Rhonda\CORS

Method Description
allow_headers() Set headers to allow CORS request 
  \Rhonda\CORS::allow_headers();

OR

  $cors = new \Rhonda\CORS();
  $cors->allow_headers();

\Rhonda\Boolean

Method Description
evaluate(STRING) Read a string to change to a boolean TRUE/FALSE 
  \Rhonda\Boolean::evaluate('yes');

OR

  $boolean = new \Rhonda\Boolean();
  $boolean->evaluate('false');

\Rhonda\Google

Method Description
geo_code(STRING, ARRAY) Load and address with Google api key and Array of address parameters
prepare_query_string(ARRAY) Prepare a Google Array of address parameters

Get the geo code information for an address

  \Rhonda\Google::geo_code('google_api_key', array('1600 Amphitheatre Parkway', 'Mountain View', 'CA 94043', 'USA'));

OR

  $google = new \Rhonda\Google();
  $google->geo_code('google_api_key', array('1600 Amphitheatre Parkway', 'Mountain View', 'CA 94043', 'USA') );

Prepare an array of data for a Google Query String

  \Rhonda\Google::prepare_query_string(array('1600 Amphitheatre Parkway', 'Mountain View', 'CA 94043', 'USA'));

OR

  $google = new \Rhonda\Google();
  $google->prepare_query_string(array('1600 Amphitheatre Parkway', 'Mountain View', 'CA 94043', 'USA') );