#1 Initial support for optional throwing of Exception based on FlexiBee error response

Author: Vitexus

Examples/ErrorHandling.php

@@ -15,48 +15,56 @@
 include_once './config.php';
 include_once '../vendor/autoload.php';
 
-$invoicer = new FakturaVydana(['typDokl'=>'FAKTURA']); // "code:" is missing
+$invoicer = new FakturaVydana(['typDokl' => 'FAKTURA']); // "code:" is missing
 
-if($invoicer->sync() === false){
+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
-                                  //          )
-                                  //         )
+    //           [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.
-*/
+
+  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: 
-
-*/
 
+  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:
+
+ */
+
+$invoicer = new FakturaVydana(['typDokl' => 'FAKTURA'], ['throwException' => true]); // "code:" is missing
+//Or define('FLEXIBEE_EXCEPTIONS',true); 
+
+try {
+    $invoicer->sync();
+} catch (\Ease\Exception $exc) {
+    echo $exc->getCode() . ': ' . $exc->getMessage();
+}

README.md

@@ -99,6 +99,10 @@ Konfigurace se provádí nastavením následujících konstant:
     * Pomalý server, velká databáze a přes modem k tomu
     */
     define('FLEXIBEE_TIMEOUT', 60); //Volitelné
+   /*
+    * Pomalý server, velká databáze a přes modem k tomu
+    */
+    define('FLEXIBEE_EXCEPTIONS', true); //Vracet PHP vyjímku v případě že FlexiBee vrátí chybu
 ```
 
 nebo je možné přihlašovací údaje zadávat při vytváření instance třídy.