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:
- The locale (e.g. 'en_US', 'de_DE')
- 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.
For any issues or questions please get in touch with our support.
+49 (0)6221/6471-100
@devHeidelpay