emLoggerTrait.php

<?php
namespace Stanford\AppointmentScheduler;
/** @var \Stanford\LanguageEditor\LanguageEditor $this */


/**
 * This trait can be use with External Modules to enable the Stanford emLogger module
 *
 * To use this on your project:
 * 1) simply add this trait to your EM project root
 * 2) change the NAMESPACE of this file to match that of your EM
 * 3) Before you declare your EM class, insert the command:  include "emLoggerTrait.php";
 * 4) Inside your class, before your first function, insert: use emLoggerTrait;
 * 5) (optional) Modify your config.json to include these two optional debug settings

  (OPTIONAL) INSERT THESE OPTIONS INTO THE CONFIG.JSON

  "system-settings": [

    {
      "key": "enable-system-debug-logging",
      "name": "<b>Enable Debug Logging (system-wide)</b>",
      "required": false,
      "type": "checkbox"
    },

  ],

  "project-settings": [

    {
      "key": "enable-project-debug-logging",
      "name": "<b>Enable Debug Logging</b>",
      "required": false,
      "type": "checkbox"
    },

   ],

 */

trait emLoggerTrait
{

    // Determine if emLogger is enabled on this server
    private $emLoggerEnabled    = null;
    private $emLoggerDebugMode  = null;

    /**
     * Obtain an instance of emLogger or false if not installed / active
     * @return bool|mixed
     */
    function emLoggerInstance() {

        // This is the first time used, see if it is enabled on server
        if (is_null($this->emLoggerEnabled)) {
            $versions = \ExternalModules\ExternalModules::getEnabledModules();
            $this->emLoggerEnabled = isset($versions['em_logger']);
        }

        // Return instance if enabled
        if ($this->emLoggerEnabled) {

            // Set if debug mode once on the first log call
            if (is_null($this->emLoggerDebugMode)) {
                $this->emLoggerDebugMode = $this->emLoggerGetDebugMode();
            }

            // Try to return the instance of emLogger (which is cached by the EM framework)
            try {
                return \ExternalModules\ExternalModules::getModuleInstance('em_logger');
            } catch (\Exception $e) {
                // Unable to initialize em_logger
                error_log("Exception caught - unable to initialize emLogger in " . __NAMESPACE__ . "/" . __FILE__ . "!");
                $this->emLoggerEnabled = false;
                return false;
            }
        } else {
            return false;
        }
    }


    /**
     * Determine if we are in debug mode either on system or project level
     * @return bool
     */
    function emLoggerGetDebugMode() {
        $systemDebug  = $this->getSystemSetting('enable-system-debug-logging');
        $projectDebug = !empty($_GET['pid']) && $this->getProjectSetting('enable-project-debug-logging');
        return $systemDebug || $projectDebug;
    }


    /**
     * Do the logging
     * The reason we broke it into three functions was to reduce complexity with backtrace and the calling function
     */
    function emLog() {
        if ($emLogger = $this->emLoggerInstance()) $emLogger->emLog($this->PREFIX, func_get_args(), "INFO");
    }


    /**
     * Wrapper for logging an error
     */
    function emError() {
        if ($emLogger = $this->emLoggerInstance()) $emLogger->emLog($this->PREFIX, func_get_args(), "ERROR");
    }


    /**
     * Wrapper for logging debug statements
     */
    function emDebug() {
       if ( $this->emLoggerDebugMode && ($emLogger = $this->emLoggerInstance()) ) $emLogger->emLog($this->PREFIX, func_get_args(), "DEBUG");
    }

}