heidelpay/php-message-code-mapper

A library to convert heidelpay message codes into customer friendly messages.

v1.0.1 2018-03-01 07:22 UTC

README

Codacy Badge Codacy Badge Build Status Latest Stable on Packagist PHP 5.6 PHP 7.0 PHP 7.1 PHP 7.2

Logo

heidelpay message code mapper

This library provides user-friendly output of (error)-messages coming from the heidelpay API.

1. Installation

Composer

composer require heidelpay/php-message-code-mapper

manual Installation

Download the latest release from github and unpack it into a folder of your choice inside your project.

2. Implementation

Composer

require_once 'path/to/autoload.php;
use Heidelpay\MessageCodeMapper\MessageCodeMapper;

manual Installation

require_once 'path/to/php-message-code-mapper/lib/MessageCodeMapper.php';

Of course, the path needs to match the path from step 1.

3. Usage

Assuming you have received an error code from one of our modules or the heidelpay PHP API and stored it in a variable called $errorcode. To get a message from that code, create a MessageCodeMapper instance:

$instance = new \Heidelpay\MessageCodeMapper\MessageCodeMapper('de_DE');

The constructor takes two (optional) arguments:

  1. The locale (e.g. 'en_US', 'de_DE')
  2. The path to the locales path (for example you want to use your own locale files) containing the .csv files with the codes and messages.

We provide 'de_DE' and 'en_US' locale files with this package. You can find them in the lib/locales folder. If you want to use one of these, the path doesn't need to be provided in the constructor.

By default, 'en_US' is used as the locale.

Now you can return or print out the message by calling the getMessage() method:

return $instance->getMessage($errorcode); echo $instance->getMessage($errorcode);

Error codes are accepted in either the 'XXX.XXX.XXX' or 'HP-Error-XXX.XXX.XXX' format.