PHP Classes

File: src/Request/Support/CallableFunction.php

Recommend this page to a friend!
  Classes of Thierry Feuzeu   Jaxon   src/Request/Support/CallableFunction.php   Download  
File: src/Request/Support/CallableFunction.php
Role: Class source
Content type: text/plain
Description: Class source
Class: Jaxon
Call PHP classes from JavaScript using AJAX
Author: By
Last change:
Date: 4 years ago
Size: 3,976 bytes
 

Contents

Class file image Download
<?php

/**
 * CallableFunction.php - Jaxon user function
 *
 * This class stores a reference to a user defined function which can be called from the client via an Jaxon request
 *
 * @package jaxon-core
 * @author Jared White
 * @author J. Max Wilson
 * @author Joseph Woolley
 * @author Steffen Konerow
 * @author Thierry Feuzeu <thierry.feuzeu@gmail.com>
 * @copyright Copyright (c) 2005-2007 by Jared White & J. Max Wilson
 * @copyright Copyright (c) 2008-2010 by Joseph Woolley, Steffen Konerow, Jared White & J. Max Wilson
 * @copyright 2016 Thierry Feuzeu <thierry.feuzeu@gmail.com>
 * @license https://opensource.org/licenses/BSD-3-Clause BSD 3-Clause License
 * @link https://github.com/jaxon-php/jaxon-core
 */

namespace Jaxon\Request\Support;

class
CallableFunction
{
    use \
Jaxon\Features\Config;
    use \
Jaxon\Features\Template;

   
/**
     * The name of the corresponding javascript function
     *
     * @var string
     */
   
private $sJsFunction;

   
/**
     * A string or an array which defines the function to be registered
     *
     * @var string|array
     */
   
private $xCallableFunction;

   
/**
     * The path and file name of the include file where the function is defined
     *
     * @var string
     */
   
private $sInclude;

   
/**
     * An associative array containing call options that will be sent
     * to the browser curing client script generation
     *
     * @var array
     */
   
private $aConfiguration;

    public function
__construct($sCallableFunction)
    {
       
$this->aConfiguration = [];
       
$this->sJsFunction = $sCallableFunction;
       
$this->xCallableFunction = $sCallableFunction;
    }

   
/**
     * Get the name of the function being referenced
     *
     * @return string
     */
   
public function getName()
    {
        return
$this->sJsFunction;
    }

   
/**
     * Set call options for this instance
     *
     * @param string $sName The name of the configuration option
     * @param string $sValue The value of the configuration option
     *
     * @return void
     */
   
public function configure($sName, $sValue)
    {
        switch(
$sName)
        {
        case
'class': // The user function is a method in the given class
           
$this->xCallableFunction = [$sValue, $this->xCallableFunction];
            break;
        case
'alias':
           
$this->sJsFunction = $sValue;
            break;
        case
'include':
           
$this->sInclude = $sValue;
            break;
        default:
           
$this->aConfiguration[$sName] = $sValue;
            break;
        }
    }

   
/**
     * Generate the javascript function stub that is sent to the browser on initial page load
     *
     * @return string
     */
   
public function getScript()
    {
       
$sPrefix = $this->getOption('core.prefix.function');
       
$sJsFunction = $this->getName();

        return
$this->render('jaxon::support/function.js', [
           
'sPrefix' => $sPrefix,
           
'sAlias' => $sJsFunction,
           
'sFunction' => $sJsFunction, // sAlias is the same as sFunction
           
'aConfig' => $this->aConfiguration,
        ]);
    }

   
/**
     * Call the registered user function, including an external file if needed
     * and passing along the specified arguments
     *
     * @param array $aArgs The function arguments
     *
     * @return void
     */
   
public function call($aArgs = [])
    {
        if((
$this->sInclude))
        {
            require_once
$this->sInclude;
        }

       
// If the function is an alias for a class method, then instanciate the class
       
if(is_array($this->xCallableFunction) && is_string($this->xCallableFunction[0]))
        {
           
$sClassName = $this->xCallableFunction[0];
           
$this->xCallableFunction[0] = new $sClassName;
        }

        return
call_user_func_array($this->xCallableFunction, $aArgs);
    }
}