Merge pull request #218 from mesilov/issue#217

add onApiCallMethod

Author: camaxtly

src/bitrix24.php

@@ -143,6 +143,11 @@ class Bitrix24 implements iBitrix24
      */
     protected $_onExpiredToken;
 
+    /**
+     * @var callable callback after api method called
+     */
+    protected $_onCallApiMethod;
+
     /**
      * @var bool ssl verify for checking CURLOPT_SSL_VERIFYPEER and CURLOPT_SSL_VERIFYHOST
      */
@@ -204,6 +209,16 @@ public function setOnExpiredToken(callable $callback)
         $this->_onExpiredToken = $callback;
     }
 
+    /**
+     * Set function called after api method executed. Callback receives instance as first parameter, method name as second.
+     *
+     * @param callable $callback
+     */
+    public function setOnCallApiMethod(callable $callback)
+    {
+        $this->_onCallApiMothod = $callback;
+    }
+
     /**
      * Get a random string to sign protected api-call. Use salt for argument "state" in secure api-call
      * random string is a result of mt_rand function
@@ -1114,8 +1129,13 @@ public function processBatchCalls($halt = 0, $delay = self::BATCH_DELAY)
     public function call($methodName, array $additionalParameters = array())
     {
         try {
-                $result = $this->getWebhookUsage()  ? $this->_call_webhook($methodName, $additionalParameters)
-                                                    : $this->_call($methodName, $additionalParameters);
+            $result = $this->getWebhookUsage()  ? $this->_call_webhook($methodName, $additionalParameters)
+                : $this->_call($methodName, $additionalParameters);
+
+            if (is_callable($this->_onCallApiMothod)) {
+                call_user_func($this->_onCallApiMothod, $this, $methodName);
+            }
+
         } catch (Bitrix24TokenIsExpiredException $e) {
             if (!is_callable($this->_onExpiredToken)) {
                 throw $e;