PHP Classes

File: src/Jaxon.php

Recommend this page to a friend!
  Classes of Thierry Feuzeu   Jaxon   src/Jaxon.php   Download  
File: src/Jaxon.php
Role: Class source
Content type: text/plain
Description: Class source
Class: Jaxon
Call PHP classes from JavaScript using AJAX
Author: By
Last change: The upload plugin can be disabled.
The core.upload.enabled option can be set to true or false.
Updated the library version.
Date: 2 years ago
Size: 14,721 bytes
 

Contents

Class file image Download
<?php /** * Jaxon.php - Jaxon class * * The Jaxon class uses a modular plug-in system to facilitate the processing * of special Ajax requests made by a PHP page. * It generates Javascript that the page must include in order to make requests. * It handles the output of response commands (see <Jaxon\Response\Response>). * Many flags and settings can be adjusted to effect the behavior of the Jaxon class * as well as the client-side javascript. * * @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; use Jaxon\Plugin\Plugin; use Jaxon\Plugin\Package; use Jaxon\Utils\DI\Container; use Jaxon\Utils\Config\Reader as ConfigReader; use Psr\Log\LoggerInterface; use Psr\Log\NullLogger; use Psr\Log\LoggerAwareTrait; use Psr\Log\LoggerAwareInterface; class Jaxon implements LoggerAwareInterface { use Features\Config; use Features\Translator; use LoggerAwareTrait; /** * Package version number * * @var string */ private $sVersion = 'Jaxon 3.2.0'; /* * Plugin types */ // Response plugin const PLUGIN_RESPONSE = 'ResponsePlugin'; // Request plugin const PLUGIN_REQUEST = 'RequestPlugin'; // Package plugin const PLUGIN_PACKAGE = 'PackagePlugin'; /* * Request plugins */ const CALLABLE_CLASS = 'CallableClass'; const CALLABLE_DIR = 'CallableDir'; const CALLABLE_FUNCTION = 'CallableFunction'; // For uploaded files. const FILE_UPLOAD = 'FileUpload'; // For compatibility with previous versions const CALLABLE_OBJECT = 'CallableClass'; // Same as CALLABLE_CLASS const USER_FUNCTION = 'CallableFunction'; // Same as CALLABLE_FUNCTION /** * A static instance on this class * * @var Jaxon */ private static $xInstance = null; /** * The DI container * * @var Container */ private static $xContainer = null; /** * Get the static instance * * @return Jaxon */ public static function getInstance() { if(self::$xInstance == null) { self::$xInstance = new Jaxon(); } return self::$xInstance; } /** * The constructor */ public function __construct() { // Set the default logger $this->setLogger(new NullLogger()); if(self::$xContainer == null) { self::$xContainer = new Container($this->getDefaultOptions()); /* * Register the Jaxon request and response plugins */ $this->di()->getPluginManager()->registerRequestPlugins(); $this->di()->getPluginManager()->registerResponsePlugins(); } } /** * Get the DI container * * @return Container */ public function di() { return self::$xContainer; } /** * The current Jaxon version * * @return string */ public function getVersion() { return $this->sVersion; } /** * Get the logger * * @return LoggerInterface */ public function logger() { return $this->logger; } /** * Get the config reader * * @return ConfigReader */ public function config() { return $this->di()->get(ConfigReader::class); } /** * Get the default options of all components of the library * * @return array<string,string|boolean|integer> */ private function getDefaultOptions() { // The default configuration settings. return [ 'core.version' => $this->getVersion(), 'core.language' => 'en', 'core.encoding' => 'utf-8', 'core.decode_utf8' => false, 'core.prefix.function' => 'jaxon_', 'core.prefix.class' => 'Jaxon', // 'core.request.uri' => '', 'core.request.mode' => 'asynchronous', 'core.request.method' => 'POST', // W3C: Method is case sensitive 'core.response.send' => true, 'core.response.merge.ap' => true, 'core.response.merge.js' => true, 'core.debug.on' => false, 'core.debug.verbose' => false, 'core.process.exit' => true, 'core.process.clean' => false, 'core.process.timeout' => 6000, 'core.error.handle' => false, 'core.error.log_file' => '', 'core.jquery.no_conflict' => false, 'core.upload.enabled' => true, 'js.lib.output_id' => 0, 'js.lib.queue_size' => 0, 'js.lib.load_timeout' => 2000, 'js.lib.show_status' => false, 'js.lib.show_cursor' => true, 'js.app.dir' => '', 'js.app.minify' => true, 'js.app.options' => '', ]; } /** * Get the Global Response object * * @return \Jaxon\Response\Response */ public function getResponse() { return $this->di()->getResponse(); } /** * Create a new Jaxon response object * * @return \Jaxon\Response\Response */ public function newResponse() { return $this->di()->newResponse(); } /** * Register a plugin * * Below is a table for priorities and their description: * - 0 thru 999: Plugins that are part of or extensions to the jaxon core * - 1000 thru 8999: User created plugins, typically, these plugins don't care about order * - 9000 thru 9999: Plugins that generally need to be last or near the end of the plugin list * * @param Plugin $xPlugin An instance of a plugin * @param integer $nPriority The plugin priority, used to order the plugins * * @return void */ public function registerPlugin(Plugin $xPlugin, $nPriority = 1000) { $this->di()->getPluginManager()->registerPlugin($xPlugin, $nPriority); } /** * Register request handlers, including functions, callable classes and directories. * * @param string $sType The type of request handler being registered * Options include: * - Jaxon::CALLABLE_FUNCTION: a function declared at global scope * - Jaxon::CALLABLE_CLASS: a class who's methods are to be registered * - Jaxon::CALLABLE_DIR: a directory containing classes to be registered * - Jaxon::PACKAGE: a package * @param string $sName * When registering a function, this is the name of the function * When registering a callable class, this is the class name * When registering a callable directory, this is the full path to the directory * When registering a package or a plugin, this is the corresponding class name * @param array|string $xOptions The related options * * @return void */ public function register($sType, $sName, $xOptions = []) { if($sType == self::CALLABLE_DIR || $sType == self::CALLABLE_CLASS || $sType == self::CALLABLE_FUNCTION) { $this->di()->getPluginManager()->registerCallable($sType, $sName, $xOptions); return; } /* if($sType == self::PLUGIN_RESPONSE) { $this->di()->getPluginManager()->registerRequestPlugin($sName, $xOptions); return; } if($sType == self::PLUGIN_REQUEST) { $this->di()->getPluginManager()->registerResponsePlugin($sName, $xOptions); return; } */ if($sType == self::PLUGIN_PACKAGE && is_array($xOptions)) { $this->di()->getPluginManager()->registerPackage($sName, $xOptions); return; } // Todo: throw an error } /** * Get an instance of a registered class * * @param string $sClassName The class name * * @return mixed */ public function instance($sClassName) { $xCallable = $this->di()->getCallableRegistry()->getCallableObject($sClassName); return ($xCallable) ? $xCallable->getRegisteredObject() : null; } /** * Get a request to a registered class * * @param string $sClassName The class name * * @return \Jaxon\Request\Factory\CallableClass\Request */ public function request($sClassName) { $xInstance = $this->instance($sClassName); return ($xInstance) ? $xInstance->rq() : null; } /** * Returns the Jaxon Javascript header and wrapper code to be printed into the page * * The javascript code returned by this function is dependent on the plugins * that are included and the functions and classes that are registered. * * @param boolean $bIncludeJs Also get the JS files * @param boolean $bIncludeCss Also get the CSS files * * @return string */ public function getScript($bIncludeJs = false, $bIncludeCss = false) { return $this->di()->getCodeGenerator()->getScript($bIncludeJs, $bIncludeCss); } /** * Print the jaxon Javascript header and wrapper code into your page * * The javascript code returned by this function is dependent on the plugins * that are included and the functions and classes that are registered. * * @param boolean $bIncludeJs Also print the JS files * @param boolean $bIncludeCss Also print the CSS files * * @return void */ public function printScript($bIncludeJs = false, $bIncludeCss = false) { print $this->getScript($bIncludeJs, $bIncludeCss); } /** * Return the javascript header code and file includes * * @return string */ public function getJs() { return $this->di()->getCodeGenerator()->getJs(); } /** * Return the CSS header code and file includes * * @return string */ public function getCss() { return $this->di()->getCodeGenerator()->getCss(); } /** * Determine if a call is a jaxon request or a page load request * * @return boolean */ public function canProcessRequest() { return $this->di()->getRequestHandler()->canProcessRequest(); } /** * If this is a jaxon request, call the requested PHP function, build the response and send it back to the browser * * This is the main server side engine for Jaxon. * It handles all the incoming requests, including the firing of events and handling of the response. * If your RequestURI is the same as your web page, then this function should be called before ANY * headers or HTML is output from your script. * * This function may exit after the request is processed, if the 'core.process.exit' option is set to true. * * @return void * * @see <Jaxon\Jaxon->canProcessRequest> */ public function processRequest() { // Check to see if headers have already been sent out, in which case we can't do our job if(headers_sent($filename, $linenumber)) { echo $this->trans('errors.output.already-sent', [ 'location' => $filename . ':' . $linenumber ]), "\n", $this->trans('errors.output.advice'); exit(); } $this->di()->getRequestHandler()->processRequest(); if(($this->getOption('core.response.send'))) { $this->di()->getResponseManager()->sendOutput(); if(($this->getOption('core.process.exit'))) { exit(); } } } /** * Get a registered response plugin * * @param string $sName The name of the plugin * * @return \Jaxon\Plugin\Response */ public function plugin($sName) { return $this->di()->getPluginManager()->getResponsePlugin($sName); } /** * Get a package instance * * @param string $sClassName The package class name * * @return \Jaxon\Plugin\Package */ public function package($sClassName) { return $this->di()->getPluginManager()->getPackage($sClassName); } /** * Get the upload plugin * * @return \Jaxon\Request\Plugin\FileUpload */ public function upload() { return $this->di()->getPluginManager()->getRequestPlugin(self::FILE_UPLOAD); } /** * Get the request callback manager * * @return \Jaxon\Request\Handler\Callback */ public function callback() { return $this->di()->getRequestHandler()->getCallbackManager(); } /** * Get the dialog wrapper * * @return \Jaxon\Utils\Dialogs\Dialog */ public function dialog() { return $this->di()->getDialog(); } /** * Get the template engine * * @return \Jaxon\Utils\Template\Engine */ public function template() { return $this->di()->getTemplateEngine(); } /** * Get the App instance * * @return \Jaxon\App\App */ public function app() { return $this->di()->getApp(); } /** * Get the view renderer * * @return \Jaxon\Utils\View\Renderer */ public function view() { return $this->di()->getViewRenderer(); } /** * Get the session manager * * @return \Jaxon\Contracts\Session */ public function session() { return $this->di()->getSessionManager(); } }