#1 Easy way how to get occured errors +example

Author: Vitexus

Examples/ErrorHandling.php

@@ -0,0 +1,62 @@
+#!/usr/bin/php -f
+<?php
+/**
+ * php-flexibee - Example how to create Invoice
+ *
+ * @author     Vítězslav Dvořák <[email protected]>
+ * @copyright  (G) 2020 Vitex Software
+ */
+
+namespace Example\FlexiPeeHP;
+
+use \FlexiPeeHP\FakturaVydana;
+
+define('EASE_LOGGER', 'syslog|console');
+include_once './config.php';
+include_once '../vendor/autoload.php';
+
+$invoicer = new FakturaVydana(['typDokl'=>'FAKTURA']); // "code:" is missing
+
+if($invoicer->sync() === false){
+    $invoicer->lastResponseCode;  // (int) 400
+    $invoicer->lastCurlError;     // empty in this case
+    $invoicer->lastCurlResponse;  // {"winstrom":{"@version":"1.0","success":"false","stats":{"created":"0","updated":"0","deleted":"0","skipped":"0","failed":"1"},"results":[{"errors":[{"message":"Je očekáváno číselné ID, ale 'FAKTURA' není číslo","for":"typDokl","path":"faktura-vydana[temporary-id=null].typDokl","value":"FAKTURA","code":"PROP"}]}]}}
+    $invoicer->getErrors();       // array(1) (
+                                  //           [0] => array(5) (
+                                  //               [message] => (string) Je očekáváno číselné ID, ale 'FAKTURA' není číslo
+                                  //               [for] => (string) typDokl
+                                  //               [path] => (string) faktura-vydana[temporary-id=null].typDokl
+                                  //               [value] => (string) FAKTURA
+                                  //               [code] => (string) PROP
+                                  //          )
+                                  //         )
+}
+
+
+
+/* EASE_LOGGER: "console" print red/yellow lines: 
+ 
+php -f Examples/ErrorHandling.php
+03/21/20 03:29:47 ``  ☠ Je očekáváno číselné ID, ale 'FAKTURA' není číslo
+03/21/20 03:29:47 ``  ⚠ 400: https://vitexsoftware.flexibee.eu:5434/c/flexipeehp/faktura-vydana
+03/21/20 03:29:47 ``  ☠ : Je očekáváno číselné ID, ale 'FAKTURA' není číslo for: typDokl value:FAKTURA code:PROP
+03/21/20 03:29:47 ``  ⚙ {"for":"typDokl","path":"faktura-vydana[temporary-id=null].typDokl","value":"FAKTURA","code":"PROP"}
+03/21/20 03:29:47 ``  ⚠ Error 400: https://vitexsoftware.flexibee.eu:5434/c/flexipeehp/faktura-vydana
+Done.
+*/
+
+/* EASE_LOGGER "syslog" add this to /var/log/syslog
+ 
+Mar 21 03:29:47 exiv FlexiPeeHPtest: ` `  400: https://vitexsoftware.flexibee.eu:5434/c/flexipeehp/faktura-vydana
+Mar 21 03:29:47 exiv FlexiPeeHPtest: 
+Mar 21 03:29:47 exiv FlexiPeeHPtest: ` `  Je očekáváno číselné ID, ale 'FAKTURA' není číslo
+Mar 21 03:29:47 exiv FlexiPeeHPtest: 
+Mar 21 03:29:47 exiv FlexiPeeHPtest: ` ` @@ {"for":"typDokl","path":"faktura-vydana[temporary-id=null].typDokl","value":"FAKTURA","code":"PROP"}
+Mar 21 03:29:47 exiv FlexiPeeHPtest: 
+Mar 21 03:29:47 exiv FlexiPeeHPtest: ` `  Error 400: https://vitexsoftware.flexibee.eu:5434/c/flexipeehp/faktura-vydana
+Mar 21 03:29:47 exiv FlexiPeeHPtest: 
+Mar 21 03:29:47 exiv FlexiPeeHPtest: ` `  : Je očekáváno číselné ID, ale 'FAKTURA' není číslo for: typDokl value:FAKTURA code:PROP
+Mar 21 03:29:47 exiv FlexiPeeHPtest: 
+
+*/
+

src/FlexiPeeHP/FlexiBeeRO.php

@@ -402,7 +402,7 @@ class FlexiBeeRO extends \Ease\Sand
     /**
      * Class for read only interaction with FlexiBee.
      *
-     * @param mixed $init default record id or initial data
+     * @param mixed $init default record id or initial data. See processInit()
      * @param array $options Connection settings and other options override
      */
     public function __construct($init = null, $options = [])
@@ -930,6 +930,7 @@ public function performRequest($urlSuffix = null, $method = 'GET',
     {
         $this->rowCount      = null;
         $this->responseStats = [];
+        $this->errors        = [];
 
         if (preg_match('/^http/', $urlSuffix)) {
             $url = $urlSuffix;
@@ -2868,6 +2869,15 @@ public function getLastOperationType()
         return implode(',', array_keys(array_filter($this->responseStats)));
     }
 
+    /**
+     * Last operation errors 
+     * 
+     * @return array FlexiBee error meassages
+     */
+    public function getErrors() {
+        return $this->errors;
+    }
+    
     /**
      * Reconnect After unserialization
      */