diff --git a/composer.lock b/composer.lock new file mode 100644 index 0000000..f671cc4 --- /dev/null +++ b/composer.lock @@ -0,0 +1,109 @@ +{ + "_readme": [ + "This file locks the dependencies of your project to a known state", + "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies", + "This file is @generated automatically" + ], + "content-hash": "d290fe8615d2fd09cfd976def6121adc", + "packages": [ + { + "name": "erusev/parsedown", + "version": "1.7.3", + "source": { + "type": "git", + "url": "https://github.com/erusev/parsedown.git", + "reference": "6d893938171a817f4e9bc9e86f2da1e370b7bcd7" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/erusev/parsedown/zipball/6d893938171a817f4e9bc9e86f2da1e370b7bcd7", + "reference": "6d893938171a817f4e9bc9e86f2da1e370b7bcd7", + "shasum": "" + }, + "require": { + "ext-mbstring": "*", + "php": ">=5.3.0" + }, + "require-dev": { + "phpunit/phpunit": "^4.8.35" + }, + "type": "library", + "autoload": { + "psr-0": { + "Parsedown": "" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Emanuil Rusev", + "email": "hello@erusev.com", + "homepage": "http://erusev.com" + } + ], + "description": "Parser for Markdown.", + "homepage": "http://parsedown.org", + "keywords": [ + "markdown", + "parser" + ], + "time": "2019-03-17T18:48:37+00:00" + }, + { + "name": "mikecao/flight", + "version": "v1.3.7", + "source": { + "type": "git", + "url": "https://github.com/mikecao/flight.git", + "reference": "7d5970f7617861c868a5c728764421d8950faaf0" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/mikecao/flight/zipball/7d5970f7617861c868a5c728764421d8950faaf0", + "reference": "7d5970f7617861c868a5c728764421d8950faaf0", + "shasum": "" + }, + "require": { + "php": ">=5.3.0" + }, + "require-dev": { + "phpunit/phpunit": "~4.6" + }, + "type": "library", + "autoload": { + "files": [ + "flight/autoload.php", + "flight/Flight.php" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Mike Cao", + "email": "mike@mikecao.com", + "homepage": "http://www.mikecao.com/", + "role": "Original Developer" + } + ], + "description": "Flight is a fast, simple, extensible framework for PHP. Flight enables you to quickly and easily build RESTful web applications.", + "homepage": "http://flightphp.com", + "time": "2018-11-23T23:05:33+00:00" + } + ], + "packages-dev": [], + "aliases": [], + "minimum-stability": "stable", + "stability-flags": [], + "prefer-stable": false, + "prefer-lowest": false, + "platform": { + "php": "^7.0" + }, + "platform-dev": [] +} diff --git a/vendor/autoload.php b/vendor/autoload.php new file mode 100644 index 0000000..6ae2e2b --- /dev/null +++ b/vendor/autoload.php @@ -0,0 +1,7 @@ + + * Jordi Boggiano + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Composer\Autoload; + +/** + * ClassLoader implements a PSR-0, PSR-4 and classmap class loader. + * + * $loader = new \Composer\Autoload\ClassLoader(); + * + * // register classes with namespaces + * $loader->add('Symfony\Component', __DIR__.'/component'); + * $loader->add('Symfony', __DIR__.'/framework'); + * + * // activate the autoloader + * $loader->register(); + * + * // to enable searching the include path (eg. for PEAR packages) + * $loader->setUseIncludePath(true); + * + * In this example, if you try to use a class in the Symfony\Component + * namespace or one of its children (Symfony\Component\Console for instance), + * the autoloader will first look for the class under the component/ + * directory, and it will then fallback to the framework/ directory if not + * found before giving up. + * + * This class is loosely based on the Symfony UniversalClassLoader. + * + * @author Fabien Potencier + * @author Jordi Boggiano + * @see http://www.php-fig.org/psr/psr-0/ + * @see http://www.php-fig.org/psr/psr-4/ + */ +class ClassLoader +{ + // PSR-4 + private $prefixLengthsPsr4 = array(); + private $prefixDirsPsr4 = array(); + private $fallbackDirsPsr4 = array(); + + // PSR-0 + private $prefixesPsr0 = array(); + private $fallbackDirsPsr0 = array(); + + private $useIncludePath = false; + private $classMap = array(); + private $classMapAuthoritative = false; + private $missingClasses = array(); + private $apcuPrefix; + + public function getPrefixes() + { + if (!empty($this->prefixesPsr0)) { + return call_user_func_array('array_merge', $this->prefixesPsr0); + } + + return array(); + } + + public function getPrefixesPsr4() + { + return $this->prefixDirsPsr4; + } + + public function getFallbackDirs() + { + return $this->fallbackDirsPsr0; + } + + public function getFallbackDirsPsr4() + { + return $this->fallbackDirsPsr4; + } + + public function getClassMap() + { + return $this->classMap; + } + + /** + * @param array $classMap Class to filename map + */ + public function addClassMap(array $classMap) + { + if ($this->classMap) { + $this->classMap = array_merge($this->classMap, $classMap); + } else { + $this->classMap = $classMap; + } + } + + /** + * Registers a set of PSR-0 directories for a given prefix, either + * appending or prepending to the ones previously set for this prefix. + * + * @param string $prefix The prefix + * @param array|string $paths The PSR-0 root directories + * @param bool $prepend Whether to prepend the directories + */ + public function add($prefix, $paths, $prepend = false) + { + if (!$prefix) { + if ($prepend) { + $this->fallbackDirsPsr0 = array_merge( + (array) $paths, + $this->fallbackDirsPsr0 + ); + } else { + $this->fallbackDirsPsr0 = array_merge( + $this->fallbackDirsPsr0, + (array) $paths + ); + } + + return; + } + + $first = $prefix[0]; + if (!isset($this->prefixesPsr0[$first][$prefix])) { + $this->prefixesPsr0[$first][$prefix] = (array) $paths; + + return; + } + if ($prepend) { + $this->prefixesPsr0[$first][$prefix] = array_merge( + (array) $paths, + $this->prefixesPsr0[$first][$prefix] + ); + } else { + $this->prefixesPsr0[$first][$prefix] = array_merge( + $this->prefixesPsr0[$first][$prefix], + (array) $paths + ); + } + } + + /** + * Registers a set of PSR-4 directories for a given namespace, either + * appending or prepending to the ones previously set for this namespace. + * + * @param string $prefix The prefix/namespace, with trailing '\\' + * @param array|string $paths The PSR-4 base directories + * @param bool $prepend Whether to prepend the directories + * + * @throws \InvalidArgumentException + */ + public function addPsr4($prefix, $paths, $prepend = false) + { + if (!$prefix) { + // Register directories for the root namespace. + if ($prepend) { + $this->fallbackDirsPsr4 = array_merge( + (array) $paths, + $this->fallbackDirsPsr4 + ); + } else { + $this->fallbackDirsPsr4 = array_merge( + $this->fallbackDirsPsr4, + (array) $paths + ); + } + } elseif (!isset($this->prefixDirsPsr4[$prefix])) { + // Register directories for a new namespace. + $length = strlen($prefix); + if ('\\' !== $prefix[$length - 1]) { + throw new \InvalidArgumentException("A non-empty PSR-4 prefix must end with a namespace separator."); + } + $this->prefixLengthsPsr4[$prefix[0]][$prefix] = $length; + $this->prefixDirsPsr4[$prefix] = (array) $paths; + } elseif ($prepend) { + // Prepend directories for an already registered namespace. + $this->prefixDirsPsr4[$prefix] = array_merge( + (array) $paths, + $this->prefixDirsPsr4[$prefix] + ); + } else { + // Append directories for an already registered namespace. + $this->prefixDirsPsr4[$prefix] = array_merge( + $this->prefixDirsPsr4[$prefix], + (array) $paths + ); + } + } + + /** + * Registers a set of PSR-0 directories for a given prefix, + * replacing any others previously set for this prefix. + * + * @param string $prefix The prefix + * @param array|string $paths The PSR-0 base directories + */ + public function set($prefix, $paths) + { + if (!$prefix) { + $this->fallbackDirsPsr0 = (array) $paths; + } else { + $this->prefixesPsr0[$prefix[0]][$prefix] = (array) $paths; + } + } + + /** + * Registers a set of PSR-4 directories for a given namespace, + * replacing any others previously set for this namespace. + * + * @param string $prefix The prefix/namespace, with trailing '\\' + * @param array|string $paths The PSR-4 base directories + * + * @throws \InvalidArgumentException + */ + public function setPsr4($prefix, $paths) + { + if (!$prefix) { + $this->fallbackDirsPsr4 = (array) $paths; + } else { + $length = strlen($prefix); + if ('\\' !== $prefix[$length - 1]) { + throw new \InvalidArgumentException("A non-empty PSR-4 prefix must end with a namespace separator."); + } + $this->prefixLengthsPsr4[$prefix[0]][$prefix] = $length; + $this->prefixDirsPsr4[$prefix] = (array) $paths; + } + } + + /** + * Turns on searching the include path for class files. + * + * @param bool $useIncludePath + */ + public function setUseIncludePath($useIncludePath) + { + $this->useIncludePath = $useIncludePath; + } + + /** + * Can be used to check if the autoloader uses the include path to check + * for classes. + * + * @return bool + */ + public function getUseIncludePath() + { + return $this->useIncludePath; + } + + /** + * Turns off searching the prefix and fallback directories for classes + * that have not been registered with the class map. + * + * @param bool $classMapAuthoritative + */ + public function setClassMapAuthoritative($classMapAuthoritative) + { + $this->classMapAuthoritative = $classMapAuthoritative; + } + + /** + * Should class lookup fail if not found in the current class map? + * + * @return bool + */ + public function isClassMapAuthoritative() + { + return $this->classMapAuthoritative; + } + + /** + * APCu prefix to use to cache found/not-found classes, if the extension is enabled. + * + * @param string|null $apcuPrefix + */ + public function setApcuPrefix($apcuPrefix) + { + $this->apcuPrefix = function_exists('apcu_fetch') && filter_var(ini_get('apc.enabled'), FILTER_VALIDATE_BOOLEAN) ? $apcuPrefix : null; + } + + /** + * The APCu prefix in use, or null if APCu caching is not enabled. + * + * @return string|null + */ + public function getApcuPrefix() + { + return $this->apcuPrefix; + } + + /** + * Registers this instance as an autoloader. + * + * @param bool $prepend Whether to prepend the autoloader or not + */ + public function register($prepend = false) + { + spl_autoload_register(array($this, 'loadClass'), true, $prepend); + } + + /** + * Unregisters this instance as an autoloader. + */ + public function unregister() + { + spl_autoload_unregister(array($this, 'loadClass')); + } + + /** + * Loads the given class or interface. + * + * @param string $class The name of the class + * @return bool|null True if loaded, null otherwise + */ + public function loadClass($class) + { + if ($file = $this->findFile($class)) { + includeFile($file); + + return true; + } + } + + /** + * Finds the path to the file where the class is defined. + * + * @param string $class The name of the class + * + * @return string|false The path if found, false otherwise + */ + public function findFile($class) + { + // class map lookup + if (isset($this->classMap[$class])) { + return $this->classMap[$class]; + } + if ($this->classMapAuthoritative || isset($this->missingClasses[$class])) { + return false; + } + if (null !== $this->apcuPrefix) { + $file = apcu_fetch($this->apcuPrefix.$class, $hit); + if ($hit) { + return $file; + } + } + + $file = $this->findFileWithExtension($class, '.php'); + + // Search for Hack files if we are running on HHVM + if (false === $file && defined('HHVM_VERSION')) { + $file = $this->findFileWithExtension($class, '.hh'); + } + + if (null !== $this->apcuPrefix) { + apcu_add($this->apcuPrefix.$class, $file); + } + + if (false === $file) { + // Remember that this class does not exist. + $this->missingClasses[$class] = true; + } + + return $file; + } + + private function findFileWithExtension($class, $ext) + { + // PSR-4 lookup + $logicalPathPsr4 = strtr($class, '\\', DIRECTORY_SEPARATOR) . $ext; + + $first = $class[0]; + if (isset($this->prefixLengthsPsr4[$first])) { + $subPath = $class; + while (false !== $lastPos = strrpos($subPath, '\\')) { + $subPath = substr($subPath, 0, $lastPos); + $search = $subPath . '\\'; + if (isset($this->prefixDirsPsr4[$search])) { + $pathEnd = DIRECTORY_SEPARATOR . substr($logicalPathPsr4, $lastPos + 1); + foreach ($this->prefixDirsPsr4[$search] as $dir) { + if (file_exists($file = $dir . $pathEnd)) { + return $file; + } + } + } + } + } + + // PSR-4 fallback dirs + foreach ($this->fallbackDirsPsr4 as $dir) { + if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr4)) { + return $file; + } + } + + // PSR-0 lookup + if (false !== $pos = strrpos($class, '\\')) { + // namespaced class name + $logicalPathPsr0 = substr($logicalPathPsr4, 0, $pos + 1) + . strtr(substr($logicalPathPsr4, $pos + 1), '_', DIRECTORY_SEPARATOR); + } else { + // PEAR-like class name + $logicalPathPsr0 = strtr($class, '_', DIRECTORY_SEPARATOR) . $ext; + } + + if (isset($this->prefixesPsr0[$first])) { + foreach ($this->prefixesPsr0[$first] as $prefix => $dirs) { + if (0 === strpos($class, $prefix)) { + foreach ($dirs as $dir) { + if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr0)) { + return $file; + } + } + } + } + } + + // PSR-0 fallback dirs + foreach ($this->fallbackDirsPsr0 as $dir) { + if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr0)) { + return $file; + } + } + + // PSR-0 include paths. + if ($this->useIncludePath && $file = stream_resolve_include_path($logicalPathPsr0)) { + return $file; + } + + return false; + } +} + +/** + * Scope isolated include. + * + * Prevents access to $this/self from included files. + */ +function includeFile($file) +{ + include $file; +} diff --git a/vendor/composer/LICENSE b/vendor/composer/LICENSE new file mode 100644 index 0000000..f27399a --- /dev/null +++ b/vendor/composer/LICENSE @@ -0,0 +1,21 @@ + +Copyright (c) Nils Adermann, Jordi Boggiano + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is furnished +to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. + diff --git a/vendor/composer/autoload_classmap.php b/vendor/composer/autoload_classmap.php new file mode 100644 index 0000000..7a91153 --- /dev/null +++ b/vendor/composer/autoload_classmap.php @@ -0,0 +1,9 @@ + $vendorDir . '/mikecao/flight/flight/autoload.php', + '5b7d984aab5ae919d3362ad9588977eb' => $vendorDir . '/mikecao/flight/flight/Flight.php', +); diff --git a/vendor/composer/autoload_namespaces.php b/vendor/composer/autoload_namespaces.php new file mode 100644 index 0000000..2357cf9 --- /dev/null +++ b/vendor/composer/autoload_namespaces.php @@ -0,0 +1,10 @@ + array($vendorDir . '/erusev/parsedown'), +); diff --git a/vendor/composer/autoload_psr4.php b/vendor/composer/autoload_psr4.php new file mode 100644 index 0000000..c44d67b --- /dev/null +++ b/vendor/composer/autoload_psr4.php @@ -0,0 +1,10 @@ + array($baseDir . '/src'), +); diff --git a/vendor/composer/autoload_real.php b/vendor/composer/autoload_real.php new file mode 100644 index 0000000..25006df --- /dev/null +++ b/vendor/composer/autoload_real.php @@ -0,0 +1,70 @@ += 50600 && !defined('HHVM_VERSION') && (!function_exists('zend_loader_file_encoded') || !zend_loader_file_encoded()); + if ($useStaticLoader) { + require_once __DIR__ . '/autoload_static.php'; + + call_user_func(\Composer\Autoload\ComposerStaticInit892ac0856207f5cf8e7277d97176f281::getInitializer($loader)); + } else { + $map = require __DIR__ . '/autoload_namespaces.php'; + foreach ($map as $namespace => $path) { + $loader->set($namespace, $path); + } + + $map = require __DIR__ . '/autoload_psr4.php'; + foreach ($map as $namespace => $path) { + $loader->setPsr4($namespace, $path); + } + + $classMap = require __DIR__ . '/autoload_classmap.php'; + if ($classMap) { + $loader->addClassMap($classMap); + } + } + + $loader->register(true); + + if ($useStaticLoader) { + $includeFiles = Composer\Autoload\ComposerStaticInit892ac0856207f5cf8e7277d97176f281::$files; + } else { + $includeFiles = require __DIR__ . '/autoload_files.php'; + } + foreach ($includeFiles as $fileIdentifier => $file) { + composerRequire892ac0856207f5cf8e7277d97176f281($fileIdentifier, $file); + } + + return $loader; + } +} + +function composerRequire892ac0856207f5cf8e7277d97176f281($fileIdentifier, $file) +{ + if (empty($GLOBALS['__composer_autoload_files'][$fileIdentifier])) { + require $file; + + $GLOBALS['__composer_autoload_files'][$fileIdentifier] = true; + } +} diff --git a/vendor/composer/autoload_static.php b/vendor/composer/autoload_static.php new file mode 100644 index 0000000..e709f03 --- /dev/null +++ b/vendor/composer/autoload_static.php @@ -0,0 +1,47 @@ + __DIR__ . '/..' . '/mikecao/flight/flight/autoload.php', + '5b7d984aab5ae919d3362ad9588977eb' => __DIR__ . '/..' . '/mikecao/flight/flight/Flight.php', + ); + + public static $prefixLengthsPsr4 = array ( + 'S' => + array ( + 'SuperGear\\' => 10, + ), + ); + + public static $prefixDirsPsr4 = array ( + 'SuperGear\\' => + array ( + 0 => __DIR__ . '/../..' . '/src', + ), + ); + + public static $prefixesPsr0 = array ( + 'P' => + array ( + 'Parsedown' => + array ( + 0 => __DIR__ . '/..' . '/erusev/parsedown', + ), + ), + ); + + public static function getInitializer(ClassLoader $loader) + { + return \Closure::bind(function () use ($loader) { + $loader->prefixLengthsPsr4 = ComposerStaticInit892ac0856207f5cf8e7277d97176f281::$prefixLengthsPsr4; + $loader->prefixDirsPsr4 = ComposerStaticInit892ac0856207f5cf8e7277d97176f281::$prefixDirsPsr4; + $loader->prefixesPsr0 = ComposerStaticInit892ac0856207f5cf8e7277d97176f281::$prefixesPsr0; + + }, null, ClassLoader::class); + } +} diff --git a/vendor/composer/installed.json b/vendor/composer/installed.json new file mode 100644 index 0000000..848e55b --- /dev/null +++ b/vendor/composer/installed.json @@ -0,0 +1,95 @@ +[ + { + "name": "erusev/parsedown", + "version": "1.7.3", + "version_normalized": "1.7.3.0", + "source": { + "type": "git", + "url": "https://github.com/erusev/parsedown.git", + "reference": "6d893938171a817f4e9bc9e86f2da1e370b7bcd7" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/erusev/parsedown/zipball/6d893938171a817f4e9bc9e86f2da1e370b7bcd7", + "reference": "6d893938171a817f4e9bc9e86f2da1e370b7bcd7", + "shasum": "" + }, + "require": { + "ext-mbstring": "*", + "php": ">=5.3.0" + }, + "require-dev": { + "phpunit/phpunit": "^4.8.35" + }, + "time": "2019-03-17T18:48:37+00:00", + "type": "library", + "installation-source": "dist", + "autoload": { + "psr-0": { + "Parsedown": "" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Emanuil Rusev", + "email": "hello@erusev.com", + "homepage": "http://erusev.com" + } + ], + "description": "Parser for Markdown.", + "homepage": "http://parsedown.org", + "keywords": [ + "markdown", + "parser" + ] + }, + { + "name": "mikecao/flight", + "version": "v1.3.7", + "version_normalized": "1.3.7.0", + "source": { + "type": "git", + "url": "https://github.com/mikecao/flight.git", + "reference": "7d5970f7617861c868a5c728764421d8950faaf0" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/mikecao/flight/zipball/7d5970f7617861c868a5c728764421d8950faaf0", + "reference": "7d5970f7617861c868a5c728764421d8950faaf0", + "shasum": "" + }, + "require": { + "php": ">=5.3.0" + }, + "require-dev": { + "phpunit/phpunit": "~4.6" + }, + "time": "2018-11-23T23:05:33+00:00", + "type": "library", + "installation-source": "dist", + "autoload": { + "files": [ + "flight/autoload.php", + "flight/Flight.php" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Mike Cao", + "email": "mike@mikecao.com", + "homepage": "http://www.mikecao.com/", + "role": "Original Developer" + } + ], + "description": "Flight is a fast, simple, extensible framework for PHP. Flight enables you to quickly and easily build RESTful web applications.", + "homepage": "http://flightphp.com" + } +] diff --git a/vendor/erusev/parsedown/LICENSE.txt b/vendor/erusev/parsedown/LICENSE.txt new file mode 100644 index 0000000..8e7c764 --- /dev/null +++ b/vendor/erusev/parsedown/LICENSE.txt @@ -0,0 +1,20 @@ +The MIT License (MIT) + +Copyright (c) 2013-2018 Emanuil Rusev, erusev.com + +Permission is hereby granted, free of charge, to any person obtaining a copy of +this software and associated documentation files (the "Software"), to deal in +the Software without restriction, including without limitation the rights to +use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of +the Software, and to permit persons to whom the Software is furnished to do so, +subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS +FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR +COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER +IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN +CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. diff --git a/vendor/erusev/parsedown/Parsedown.php b/vendor/erusev/parsedown/Parsedown.php new file mode 100644 index 0000000..a34b44f --- /dev/null +++ b/vendor/erusev/parsedown/Parsedown.php @@ -0,0 +1,1693 @@ +DefinitionData = array(); + + # standardize line breaks + $text = str_replace(array("\r\n", "\r"), "\n", $text); + + # remove surrounding line breaks + $text = trim($text, "\n"); + + # split text into lines + $lines = explode("\n", $text); + + # iterate through lines to identify blocks + $markup = $this->lines($lines); + + # trim line breaks + $markup = trim($markup, "\n"); + + return $markup; + } + + # + # Setters + # + + function setBreaksEnabled($breaksEnabled) + { + $this->breaksEnabled = $breaksEnabled; + + return $this; + } + + protected $breaksEnabled; + + function setMarkupEscaped($markupEscaped) + { + $this->markupEscaped = $markupEscaped; + + return $this; + } + + protected $markupEscaped; + + function setUrlsLinked($urlsLinked) + { + $this->urlsLinked = $urlsLinked; + + return $this; + } + + protected $urlsLinked = true; + + function setSafeMode($safeMode) + { + $this->safeMode = (bool) $safeMode; + + return $this; + } + + protected $safeMode; + + protected $safeLinksWhitelist = array( + 'http://', + 'https://', + 'ftp://', + 'ftps://', + 'mailto:', + 'data:image/png;base64,', + 'data:image/gif;base64,', + 'data:image/jpeg;base64,', + 'irc:', + 'ircs:', + 'git:', + 'ssh:', + 'news:', + 'steam:', + ); + + # + # Lines + # + + protected $BlockTypes = array( + '#' => array('Header'), + '*' => array('Rule', 'List'), + '+' => array('List'), + '-' => array('SetextHeader', 'Table', 'Rule', 'List'), + '0' => array('List'), + '1' => array('List'), + '2' => array('List'), + '3' => array('List'), + '4' => array('List'), + '5' => array('List'), + '6' => array('List'), + '7' => array('List'), + '8' => array('List'), + '9' => array('List'), + ':' => array('Table'), + '<' => array('Comment', 'Markup'), + '=' => array('SetextHeader'), + '>' => array('Quote'), + '[' => array('Reference'), + '_' => array('Rule'), + '`' => array('FencedCode'), + '|' => array('Table'), + '~' => array('FencedCode'), + ); + + # ~ + + protected $unmarkedBlockTypes = array( + 'Code', + ); + + # + # Blocks + # + + protected function lines(array $lines) + { + $CurrentBlock = null; + + foreach ($lines as $line) + { + if (chop($line) === '') + { + if (isset($CurrentBlock)) + { + $CurrentBlock['interrupted'] = true; + } + + continue; + } + + if (strpos($line, "\t") !== false) + { + $parts = explode("\t", $line); + + $line = $parts[0]; + + unset($parts[0]); + + foreach ($parts as $part) + { + $shortage = 4 - mb_strlen($line, 'utf-8') % 4; + + $line .= str_repeat(' ', $shortage); + $line .= $part; + } + } + + $indent = 0; + + while (isset($line[$indent]) and $line[$indent] === ' ') + { + $indent ++; + } + + $text = $indent > 0 ? substr($line, $indent) : $line; + + # ~ + + $Line = array('body' => $line, 'indent' => $indent, 'text' => $text); + + # ~ + + if (isset($CurrentBlock['continuable'])) + { + $Block = $this->{'block'.$CurrentBlock['type'].'Continue'}($Line, $CurrentBlock); + + if (isset($Block)) + { + $CurrentBlock = $Block; + + continue; + } + else + { + if ($this->isBlockCompletable($CurrentBlock['type'])) + { + $CurrentBlock = $this->{'block'.$CurrentBlock['type'].'Complete'}($CurrentBlock); + } + } + } + + # ~ + + $marker = $text[0]; + + # ~ + + $blockTypes = $this->unmarkedBlockTypes; + + if (isset($this->BlockTypes[$marker])) + { + foreach ($this->BlockTypes[$marker] as $blockType) + { + $blockTypes []= $blockType; + } + } + + # + # ~ + + foreach ($blockTypes as $blockType) + { + $Block = $this->{'block'.$blockType}($Line, $CurrentBlock); + + if (isset($Block)) + { + $Block['type'] = $blockType; + + if ( ! isset($Block['identified'])) + { + $Blocks []= $CurrentBlock; + + $Block['identified'] = true; + } + + if ($this->isBlockContinuable($blockType)) + { + $Block['continuable'] = true; + } + + $CurrentBlock = $Block; + + continue 2; + } + } + + # ~ + + if (isset($CurrentBlock) and ! isset($CurrentBlock['type']) and ! isset($CurrentBlock['interrupted'])) + { + $CurrentBlock['element']['text'] .= "\n".$text; + } + else + { + $Blocks []= $CurrentBlock; + + $CurrentBlock = $this->paragraph($Line); + + $CurrentBlock['identified'] = true; + } + } + + # ~ + + if (isset($CurrentBlock['continuable']) and $this->isBlockCompletable($CurrentBlock['type'])) + { + $CurrentBlock = $this->{'block'.$CurrentBlock['type'].'Complete'}($CurrentBlock); + } + + # ~ + + $Blocks []= $CurrentBlock; + + unset($Blocks[0]); + + # ~ + + $markup = ''; + + foreach ($Blocks as $Block) + { + if (isset($Block['hidden'])) + { + continue; + } + + $markup .= "\n"; + $markup .= isset($Block['markup']) ? $Block['markup'] : $this->element($Block['element']); + } + + $markup .= "\n"; + + # ~ + + return $markup; + } + + protected function isBlockContinuable($Type) + { + return method_exists($this, 'block'.$Type.'Continue'); + } + + protected function isBlockCompletable($Type) + { + return method_exists($this, 'block'.$Type.'Complete'); + } + + # + # Code + + protected function blockCode($Line, $Block = null) + { + if (isset($Block) and ! isset($Block['type']) and ! isset($Block['interrupted'])) + { + return; + } + + if ($Line['indent'] >= 4) + { + $text = substr($Line['body'], 4); + + $Block = array( + 'element' => array( + 'name' => 'pre', + 'handler' => 'element', + 'text' => array( + 'name' => 'code', + 'text' => $text, + ), + ), + ); + + return $Block; + } + } + + protected function blockCodeContinue($Line, $Block) + { + if ($Line['indent'] >= 4) + { + if (isset($Block['interrupted'])) + { + $Block['element']['text']['text'] .= "\n"; + + unset($Block['interrupted']); + } + + $Block['element']['text']['text'] .= "\n"; + + $text = substr($Line['body'], 4); + + $Block['element']['text']['text'] .= $text; + + return $Block; + } + } + + protected function blockCodeComplete($Block) + { + $text = $Block['element']['text']['text']; + + $Block['element']['text']['text'] = $text; + + return $Block; + } + + # + # Comment + + protected function blockComment($Line) + { + if ($this->markupEscaped or $this->safeMode) + { + return; + } + + if (isset($Line['text'][3]) and $Line['text'][3] === '-' and $Line['text'][2] === '-' and $Line['text'][1] === '!') + { + $Block = array( + 'markup' => $Line['body'], + ); + + if (preg_match('/-->$/', $Line['text'])) + { + $Block['closed'] = true; + } + + return $Block; + } + } + + protected function blockCommentContinue($Line, array $Block) + { + if (isset($Block['closed'])) + { + return; + } + + $Block['markup'] .= "\n" . $Line['body']; + + if (preg_match('/-->$/', $Line['text'])) + { + $Block['closed'] = true; + } + + return $Block; + } + + # + # Fenced Code + + protected function blockFencedCode($Line) + { + if (preg_match('/^['.$Line['text'][0].']{3,}[ ]*([^`]+)?[ ]*$/', $Line['text'], $matches)) + { + $Element = array( + 'name' => 'code', + 'text' => '', + ); + + if (isset($matches[1])) + { + /** + * https://www.w3.org/TR/2011/WD-html5-20110525/elements.html#classes + * Every HTML element may have a class attribute specified. + * The attribute, if specified, must have a value that is a set + * of space-separated tokens representing the various classes + * that the element belongs to. + * [...] + * The space characters, for the purposes of this specification, + * are U+0020 SPACE, U+0009 CHARACTER TABULATION (tab), + * U+000A LINE FEED (LF), U+000C FORM FEED (FF), and + * U+000D CARRIAGE RETURN (CR). + */ + $language = substr($matches[1], 0, strcspn($matches[1], " \t\n\f\r")); + + $class = 'language-'.$language; + + $Element['attributes'] = array( + 'class' => $class, + ); + } + + $Block = array( + 'char' => $Line['text'][0], + 'element' => array( + 'name' => 'pre', + 'handler' => 'element', + 'text' => $Element, + ), + ); + + return $Block; + } + } + + protected function blockFencedCodeContinue($Line, $Block) + { + if (isset($Block['complete'])) + { + return; + } + + if (isset($Block['interrupted'])) + { + $Block['element']['text']['text'] .= "\n"; + + unset($Block['interrupted']); + } + + if (preg_match('/^'.$Block['char'].'{3,}[ ]*$/', $Line['text'])) + { + $Block['element']['text']['text'] = substr($Block['element']['text']['text'], 1); + + $Block['complete'] = true; + + return $Block; + } + + $Block['element']['text']['text'] .= "\n".$Line['body']; + + return $Block; + } + + protected function blockFencedCodeComplete($Block) + { + $text = $Block['element']['text']['text']; + + $Block['element']['text']['text'] = $text; + + return $Block; + } + + # + # Header + + protected function blockHeader($Line) + { + if (isset($Line['text'][1])) + { + $level = 1; + + while (isset($Line['text'][$level]) and $Line['text'][$level] === '#') + { + $level ++; + } + + if ($level > 6) + { + return; + } + + $text = trim($Line['text'], '# '); + + $Block = array( + 'element' => array( + 'name' => 'h' . min(6, $level), + 'text' => $text, + 'handler' => 'line', + ), + ); + + return $Block; + } + } + + # + # List + + protected function blockList($Line) + { + list($name, $pattern) = $Line['text'][0] <= '-' ? array('ul', '[*+-]') : array('ol', '[0-9]+[.]'); + + if (preg_match('/^('.$pattern.'[ ]+)(.*)/', $Line['text'], $matches)) + { + $Block = array( + 'indent' => $Line['indent'], + 'pattern' => $pattern, + 'element' => array( + 'name' => $name, + 'handler' => 'elements', + ), + ); + + if($name === 'ol') + { + $listStart = stristr($matches[0], '.', true); + + if($listStart !== '1') + { + $Block['element']['attributes'] = array('start' => $listStart); + } + } + + $Block['li'] = array( + 'name' => 'li', + 'handler' => 'li', + 'text' => array( + $matches[2], + ), + ); + + $Block['element']['text'] []= & $Block['li']; + + return $Block; + } + } + + protected function blockListContinue($Line, array $Block) + { + if ($Block['indent'] === $Line['indent'] and preg_match('/^'.$Block['pattern'].'(?:[ ]+(.*)|$)/', $Line['text'], $matches)) + { + if (isset($Block['interrupted'])) + { + $Block['li']['text'] []= ''; + + $Block['loose'] = true; + + unset($Block['interrupted']); + } + + unset($Block['li']); + + $text = isset($matches[1]) ? $matches[1] : ''; + + $Block['li'] = array( + 'name' => 'li', + 'handler' => 'li', + 'text' => array( + $text, + ), + ); + + $Block['element']['text'] []= & $Block['li']; + + return $Block; + } + + if ($Line['text'][0] === '[' and $this->blockReference($Line)) + { + return $Block; + } + + if ( ! isset($Block['interrupted'])) + { + $text = preg_replace('/^[ ]{0,4}/', '', $Line['body']); + + $Block['li']['text'] []= $text; + + return $Block; + } + + if ($Line['indent'] > 0) + { + $Block['li']['text'] []= ''; + + $text = preg_replace('/^[ ]{0,4}/', '', $Line['body']); + + $Block['li']['text'] []= $text; + + unset($Block['interrupted']); + + return $Block; + } + } + + protected function blockListComplete(array $Block) + { + if (isset($Block['loose'])) + { + foreach ($Block['element']['text'] as &$li) + { + if (end($li['text']) !== '') + { + $li['text'] []= ''; + } + } + } + + return $Block; + } + + # + # Quote + + protected function blockQuote($Line) + { + if (preg_match('/^>[ ]?(.*)/', $Line['text'], $matches)) + { + $Block = array( + 'element' => array( + 'name' => 'blockquote', + 'handler' => 'lines', + 'text' => (array) $matches[1], + ), + ); + + return $Block; + } + } + + protected function blockQuoteContinue($Line, array $Block) + { + if ($Line['text'][0] === '>' and preg_match('/^>[ ]?(.*)/', $Line['text'], $matches)) + { + if (isset($Block['interrupted'])) + { + $Block['element']['text'] []= ''; + + unset($Block['interrupted']); + } + + $Block['element']['text'] []= $matches[1]; + + return $Block; + } + + if ( ! isset($Block['interrupted'])) + { + $Block['element']['text'] []= $Line['text']; + + return $Block; + } + } + + # + # Rule + + protected function blockRule($Line) + { + if (preg_match('/^(['.$Line['text'][0].'])([ ]*\1){2,}[ ]*$/', $Line['text'])) + { + $Block = array( + 'element' => array( + 'name' => 'hr' + ), + ); + + return $Block; + } + } + + # + # Setext + + protected function blockSetextHeader($Line, array $Block = null) + { + if ( ! isset($Block) or isset($Block['type']) or isset($Block['interrupted'])) + { + return; + } + + if (chop($Line['text'], $Line['text'][0]) === '') + { + $Block['element']['name'] = $Line['text'][0] === '=' ? 'h1' : 'h2'; + + return $Block; + } + } + + # + # Markup + + protected function blockMarkup($Line) + { + if ($this->markupEscaped or $this->safeMode) + { + return; + } + + if (preg_match('/^<(\w[\w-]*)(?:[ ]*'.$this->regexHtmlAttribute.')*[ ]*(\/)?>/', $Line['text'], $matches)) + { + $element = strtolower($matches[1]); + + if (in_array($element, $this->textLevelElements)) + { + return; + } + + $Block = array( + 'name' => $matches[1], + 'depth' => 0, + 'markup' => $Line['text'], + ); + + $length = strlen($matches[0]); + + $remainder = substr($Line['text'], $length); + + if (trim($remainder) === '') + { + if (isset($matches[2]) or in_array($matches[1], $this->voidElements)) + { + $Block['closed'] = true; + + $Block['void'] = true; + } + } + else + { + if (isset($matches[2]) or in_array($matches[1], $this->voidElements)) + { + return; + } + + if (preg_match('/<\/'.$matches[1].'>[ ]*$/i', $remainder)) + { + $Block['closed'] = true; + } + } + + return $Block; + } + } + + protected function blockMarkupContinue($Line, array $Block) + { + if (isset($Block['closed'])) + { + return; + } + + if (preg_match('/^<'.$Block['name'].'(?:[ ]*'.$this->regexHtmlAttribute.')*[ ]*>/i', $Line['text'])) # open + { + $Block['depth'] ++; + } + + if (preg_match('/(.*?)<\/'.$Block['name'].'>[ ]*$/i', $Line['text'], $matches)) # close + { + if ($Block['depth'] > 0) + { + $Block['depth'] --; + } + else + { + $Block['closed'] = true; + } + } + + if (isset($Block['interrupted'])) + { + $Block['markup'] .= "\n"; + + unset($Block['interrupted']); + } + + $Block['markup'] .= "\n".$Line['body']; + + return $Block; + } + + # + # Reference + + protected function blockReference($Line) + { + if (preg_match('/^\[(.+?)\]:[ ]*?(?:[ ]+["\'(](.+)["\')])?[ ]*$/', $Line['text'], $matches)) + { + $id = strtolower($matches[1]); + + $Data = array( + 'url' => $matches[2], + 'title' => null, + ); + + if (isset($matches[3])) + { + $Data['title'] = $matches[3]; + } + + $this->DefinitionData['Reference'][$id] = $Data; + + $Block = array( + 'hidden' => true, + ); + + return $Block; + } + } + + # + # Table + + protected function blockTable($Line, array $Block = null) + { + if ( ! isset($Block) or isset($Block['type']) or isset($Block['interrupted'])) + { + return; + } + + if (strpos($Block['element']['text'], '|') !== false and chop($Line['text'], ' -:|') === '') + { + $alignments = array(); + + $divider = $Line['text']; + + $divider = trim($divider); + $divider = trim($divider, '|'); + + $dividerCells = explode('|', $divider); + + foreach ($dividerCells as $dividerCell) + { + $dividerCell = trim($dividerCell); + + if ($dividerCell === '') + { + continue; + } + + $alignment = null; + + if ($dividerCell[0] === ':') + { + $alignment = 'left'; + } + + if (substr($dividerCell, - 1) === ':') + { + $alignment = $alignment === 'left' ? 'center' : 'right'; + } + + $alignments []= $alignment; + } + + # ~ + + $HeaderElements = array(); + + $header = $Block['element']['text']; + + $header = trim($header); + $header = trim($header, '|'); + + $headerCells = explode('|', $header); + + foreach ($headerCells as $index => $headerCell) + { + $headerCell = trim($headerCell); + + $HeaderElement = array( + 'name' => 'th', + 'text' => $headerCell, + 'handler' => 'line', + ); + + if (isset($alignments[$index])) + { + $alignment = $alignments[$index]; + + $HeaderElement['attributes'] = array( + 'style' => 'text-align: '.$alignment.';', + ); + } + + $HeaderElements []= $HeaderElement; + } + + # ~ + + $Block = array( + 'alignments' => $alignments, + 'identified' => true, + 'element' => array( + 'name' => 'table', + 'handler' => 'elements', + ), + ); + + $Block['element']['text'] []= array( + 'name' => 'thead', + 'handler' => 'elements', + ); + + $Block['element']['text'] []= array( + 'name' => 'tbody', + 'handler' => 'elements', + 'text' => array(), + ); + + $Block['element']['text'][0]['text'] []= array( + 'name' => 'tr', + 'handler' => 'elements', + 'text' => $HeaderElements, + ); + + return $Block; + } + } + + protected function blockTableContinue($Line, array $Block) + { + if (isset($Block['interrupted'])) + { + return; + } + + if ($Line['text'][0] === '|' or strpos($Line['text'], '|')) + { + $Elements = array(); + + $row = $Line['text']; + + $row = trim($row); + $row = trim($row, '|'); + + preg_match_all('/(?:(\\\\[|])|[^|`]|`[^`]+`|`)+/', $row, $matches); + + foreach ($matches[0] as $index => $cell) + { + $cell = trim($cell); + + $Element = array( + 'name' => 'td', + 'handler' => 'line', + 'text' => $cell, + ); + + if (isset($Block['alignments'][$index])) + { + $Element['attributes'] = array( + 'style' => 'text-align: '.$Block['alignments'][$index].';', + ); + } + + $Elements []= $Element; + } + + $Element = array( + 'name' => 'tr', + 'handler' => 'elements', + 'text' => $Elements, + ); + + $Block['element']['text'][1]['text'] []= $Element; + + return $Block; + } + } + + # + # ~ + # + + protected function paragraph($Line) + { + $Block = array( + 'element' => array( + 'name' => 'p', + 'text' => $Line['text'], + 'handler' => 'line', + ), + ); + + return $Block; + } + + # + # Inline Elements + # + + protected $InlineTypes = array( + '"' => array('SpecialCharacter'), + '!' => array('Image'), + '&' => array('SpecialCharacter'), + '*' => array('Emphasis'), + ':' => array('Url'), + '<' => array('UrlTag', 'EmailTag', 'Markup', 'SpecialCharacter'), + '>' => array('SpecialCharacter'), + '[' => array('Link'), + '_' => array('Emphasis'), + '`' => array('Code'), + '~' => array('Strikethrough'), + '\\' => array('EscapeSequence'), + ); + + # ~ + + protected $inlineMarkerList = '!"*_&[:<>`~\\'; + + # + # ~ + # + + public function line($text, $nonNestables=array()) + { + $markup = ''; + + # $excerpt is based on the first occurrence of a marker + + while ($excerpt = strpbrk($text, $this->inlineMarkerList)) + { + $marker = $excerpt[0]; + + $markerPosition = strpos($text, $marker); + + $Excerpt = array('text' => $excerpt, 'context' => $text); + + foreach ($this->InlineTypes[$marker] as $inlineType) + { + # check to see if the current inline type is nestable in the current context + + if ( ! empty($nonNestables) and in_array($inlineType, $nonNestables)) + { + continue; + } + + $Inline = $this->{'inline'.$inlineType}($Excerpt); + + if ( ! isset($Inline)) + { + continue; + } + + # makes sure that the inline belongs to "our" marker + + if (isset($Inline['position']) and $Inline['position'] > $markerPosition) + { + continue; + } + + # sets a default inline position + + if ( ! isset($Inline['position'])) + { + $Inline['position'] = $markerPosition; + } + + # cause the new element to 'inherit' our non nestables + + foreach ($nonNestables as $non_nestable) + { + $Inline['element']['nonNestables'][] = $non_nestable; + } + + # the text that comes before the inline + $unmarkedText = substr($text, 0, $Inline['position']); + + # compile the unmarked text + $markup .= $this->unmarkedText($unmarkedText); + + # compile the inline + $markup .= isset($Inline['markup']) ? $Inline['markup'] : $this->element($Inline['element']); + + # remove the examined text + $text = substr($text, $Inline['position'] + $Inline['extent']); + + continue 2; + } + + # the marker does not belong to an inline + + $unmarkedText = substr($text, 0, $markerPosition + 1); + + $markup .= $this->unmarkedText($unmarkedText); + + $text = substr($text, $markerPosition + 1); + } + + $markup .= $this->unmarkedText($text); + + return $markup; + } + + # + # ~ + # + + protected function inlineCode($Excerpt) + { + $marker = $Excerpt['text'][0]; + + if (preg_match('/^('.$marker.'+)[ ]*(.+?)[ ]*(? strlen($matches[0]), + 'element' => array( + 'name' => 'code', + 'text' => $text, + ), + ); + } + } + + protected function inlineEmailTag($Excerpt) + { + if (strpos($Excerpt['text'], '>') !== false and preg_match('/^<((mailto:)?\S+?@\S+?)>/i', $Excerpt['text'], $matches)) + { + $url = $matches[1]; + + if ( ! isset($matches[2])) + { + $url = 'mailto:' . $url; + } + + return array( + 'extent' => strlen($matches[0]), + 'element' => array( + 'name' => 'a', + 'text' => $matches[1], + 'attributes' => array( + 'href' => $url, + ), + ), + ); + } + } + + protected function inlineEmphasis($Excerpt) + { + if ( ! isset($Excerpt['text'][1])) + { + return; + } + + $marker = $Excerpt['text'][0]; + + if ($Excerpt['text'][1] === $marker and preg_match($this->StrongRegex[$marker], $Excerpt['text'], $matches)) + { + $emphasis = 'strong'; + } + elseif (preg_match($this->EmRegex[$marker], $Excerpt['text'], $matches)) + { + $emphasis = 'em'; + } + else + { + return; + } + + return array( + 'extent' => strlen($matches[0]), + 'element' => array( + 'name' => $emphasis, + 'handler' => 'line', + 'text' => $matches[1], + ), + ); + } + + protected function inlineEscapeSequence($Excerpt) + { + if (isset($Excerpt['text'][1]) and in_array($Excerpt['text'][1], $this->specialCharacters)) + { + return array( + 'markup' => $Excerpt['text'][1], + 'extent' => 2, + ); + } + } + + protected function inlineImage($Excerpt) + { + if ( ! isset($Excerpt['text'][1]) or $Excerpt['text'][1] !== '[') + { + return; + } + + $Excerpt['text']= substr($Excerpt['text'], 1); + + $Link = $this->inlineLink($Excerpt); + + if ($Link === null) + { + return; + } + + $Inline = array( + 'extent' => $Link['extent'] + 1, + 'element' => array( + 'name' => 'img', + 'attributes' => array( + 'src' => $Link['element']['attributes']['href'], + 'alt' => $Link['element']['text'], + ), + ), + ); + + $Inline['element']['attributes'] += $Link['element']['attributes']; + + unset($Inline['element']['attributes']['href']); + + return $Inline; + } + + protected function inlineLink($Excerpt) + { + $Element = array( + 'name' => 'a', + 'handler' => 'line', + 'nonNestables' => array('Url', 'Link'), + 'text' => null, + 'attributes' => array( + 'href' => null, + 'title' => null, + ), + ); + + $extent = 0; + + $remainder = $Excerpt['text']; + + if (preg_match('/\[((?:[^][]++|(?R))*+)\]/', $remainder, $matches)) + { + $Element['text'] = $matches[1]; + + $extent += strlen($matches[0]); + + $remainder = substr($remainder, $extent); + } + else + { + return; + } + + if (preg_match('/^[(]\s*+((?:[^ ()]++|[(][^ )]+[)])++)(?:[ ]+("[^"]*"|\'[^\']*\'))?\s*[)]/', $remainder, $matches)) + { + $Element['attributes']['href'] = $matches[1]; + + if (isset($matches[2])) + { + $Element['attributes']['title'] = substr($matches[2], 1, - 1); + } + + $extent += strlen($matches[0]); + } + else + { + if (preg_match('/^\s*\[(.*?)\]/', $remainder, $matches)) + { + $definition = strlen($matches[1]) ? $matches[1] : $Element['text']; + $definition = strtolower($definition); + + $extent += strlen($matches[0]); + } + else + { + $definition = strtolower($Element['text']); + } + + if ( ! isset($this->DefinitionData['Reference'][$definition])) + { + return; + } + + $Definition = $this->DefinitionData['Reference'][$definition]; + + $Element['attributes']['href'] = $Definition['url']; + $Element['attributes']['title'] = $Definition['title']; + } + + return array( + 'extent' => $extent, + 'element' => $Element, + ); + } + + protected function inlineMarkup($Excerpt) + { + if ($this->markupEscaped or $this->safeMode or strpos($Excerpt['text'], '>') === false) + { + return; + } + + if ($Excerpt['text'][1] === '/' and preg_match('/^<\/\w[\w-]*[ ]*>/s', $Excerpt['text'], $matches)) + { + return array( + 'markup' => $matches[0], + 'extent' => strlen($matches[0]), + ); + } + + if ($Excerpt['text'][1] === '!' and preg_match('/^/s', $Excerpt['text'], $matches)) + { + return array( + 'markup' => $matches[0], + 'extent' => strlen($matches[0]), + ); + } + + if ($Excerpt['text'][1] !== ' ' and preg_match('/^<\w[\w-]*(?:[ ]*'.$this->regexHtmlAttribute.')*[ ]*\/?>/s', $Excerpt['text'], $matches)) + { + return array( + 'markup' => $matches[0], + 'extent' => strlen($matches[0]), + ); + } + } + + protected function inlineSpecialCharacter($Excerpt) + { + if ($Excerpt['text'][0] === '&' and ! preg_match('/^&#?\w+;/', $Excerpt['text'])) + { + return array( + 'markup' => '&', + 'extent' => 1, + ); + } + + $SpecialCharacter = array('>' => 'gt', '<' => 'lt', '"' => 'quot'); + + if (isset($SpecialCharacter[$Excerpt['text'][0]])) + { + return array( + 'markup' => '&'.$SpecialCharacter[$Excerpt['text'][0]].';', + 'extent' => 1, + ); + } + } + + protected function inlineStrikethrough($Excerpt) + { + if ( ! isset($Excerpt['text'][1])) + { + return; + } + + if ($Excerpt['text'][1] === '~' and preg_match('/^~~(?=\S)(.+?)(?<=\S)~~/', $Excerpt['text'], $matches)) + { + return array( + 'extent' => strlen($matches[0]), + 'element' => array( + 'name' => 'del', + 'text' => $matches[1], + 'handler' => 'line', + ), + ); + } + } + + protected function inlineUrl($Excerpt) + { + if ($this->urlsLinked !== true or ! isset($Excerpt['text'][2]) or $Excerpt['text'][2] !== '/') + { + return; + } + + if (preg_match('/\bhttps?:[\/]{2}[^\s<]+\b\/*/ui', $Excerpt['context'], $matches, PREG_OFFSET_CAPTURE)) + { + $url = $matches[0][0]; + + $Inline = array( + 'extent' => strlen($matches[0][0]), + 'position' => $matches[0][1], + 'element' => array( + 'name' => 'a', + 'text' => $url, + 'attributes' => array( + 'href' => $url, + ), + ), + ); + + return $Inline; + } + } + + protected function inlineUrlTag($Excerpt) + { + if (strpos($Excerpt['text'], '>') !== false and preg_match('/^<(\w+:\/{2}[^ >]+)>/i', $Excerpt['text'], $matches)) + { + $url = $matches[1]; + + return array( + 'extent' => strlen($matches[0]), + 'element' => array( + 'name' => 'a', + 'text' => $url, + 'attributes' => array( + 'href' => $url, + ), + ), + ); + } + } + + # ~ + + protected function unmarkedText($text) + { + if ($this->breaksEnabled) + { + $text = preg_replace('/[ ]*\n/', "
\n", $text); + } + else + { + $text = preg_replace('/(?:[ ][ ]+|[ ]*\\\\)\n/', "
\n", $text); + $text = str_replace(" \n", "\n", $text); + } + + return $text; + } + + # + # Handlers + # + + protected function element(array $Element) + { + if ($this->safeMode) + { + $Element = $this->sanitiseElement($Element); + } + + $markup = '<'.$Element['name']; + + if (isset($Element['attributes'])) + { + foreach ($Element['attributes'] as $name => $value) + { + if ($value === null) + { + continue; + } + + $markup .= ' '.$name.'="'.self::escape($value).'"'; + } + } + + if (isset($Element['text'])) + { + $markup .= '>'; + + if (!isset($Element['nonNestables'])) + { + $Element['nonNestables'] = array(); + } + + if (isset($Element['handler'])) + { + $markup .= $this->{$Element['handler']}($Element['text'], $Element['nonNestables']); + } + else + { + $markup .= self::escape($Element['text'], true); + } + + $markup .= ''; + } + else + { + $markup .= ' />'; + } + + return $markup; + } + + protected function elements(array $Elements) + { + $markup = ''; + + foreach ($Elements as $Element) + { + $markup .= "\n" . $this->element($Element); + } + + $markup .= "\n"; + + return $markup; + } + + # ~ + + protected function li($lines) + { + $markup = $this->lines($lines); + + $trimmedMarkup = trim($markup); + + if ( ! in_array('', $lines) and substr($trimmedMarkup, 0, 3) === '

') + { + $markup = $trimmedMarkup; + $markup = substr($markup, 3); + + $position = strpos($markup, "

"); + + $markup = substr_replace($markup, '', $position, 4); + } + + return $markup; + } + + # + # Deprecated Methods + # + + function parse($text) + { + $markup = $this->text($text); + + return $markup; + } + + protected function sanitiseElement(array $Element) + { + static $goodAttribute = '/^[a-zA-Z0-9][a-zA-Z0-9-_]*+$/'; + static $safeUrlNameToAtt = array( + 'a' => 'href', + 'img' => 'src', + ); + + if (isset($safeUrlNameToAtt[$Element['name']])) + { + $Element = $this->filterUnsafeUrlInAttribute($Element, $safeUrlNameToAtt[$Element['name']]); + } + + if ( ! empty($Element['attributes'])) + { + foreach ($Element['attributes'] as $att => $val) + { + # filter out badly parsed attribute + if ( ! preg_match($goodAttribute, $att)) + { + unset($Element['attributes'][$att]); + } + # dump onevent attribute + elseif (self::striAtStart($att, 'on')) + { + unset($Element['attributes'][$att]); + } + } + } + + return $Element; + } + + protected function filterUnsafeUrlInAttribute(array $Element, $attribute) + { + foreach ($this->safeLinksWhitelist as $scheme) + { + if (self::striAtStart($Element['attributes'][$attribute], $scheme)) + { + return $Element; + } + } + + $Element['attributes'][$attribute] = str_replace(':', '%3A', $Element['attributes'][$attribute]); + + return $Element; + } + + # + # Static Methods + # + + protected static function escape($text, $allowQuotes = false) + { + return htmlspecialchars($text, $allowQuotes ? ENT_NOQUOTES : ENT_QUOTES, 'UTF-8'); + } + + protected static function striAtStart($string, $needle) + { + $len = strlen($needle); + + if ($len > strlen($string)) + { + return false; + } + else + { + return strtolower(substr($string, 0, $len)) === strtolower($needle); + } + } + + static function instance($name = 'default') + { + if (isset(self::$instances[$name])) + { + return self::$instances[$name]; + } + + $instance = new static(); + + self::$instances[$name] = $instance; + + return $instance; + } + + private static $instances = array(); + + # + # Fields + # + + protected $DefinitionData; + + # + # Read-Only + + protected $specialCharacters = array( + '\\', '`', '*', '_', '{', '}', '[', ']', '(', ')', '>', '#', '+', '-', '.', '!', '|', + ); + + protected $StrongRegex = array( + '*' => '/^[*]{2}((?:\\\\\*|[^*]|[*][^*]*[*])+?)[*]{2}(?![*])/s', + '_' => '/^__((?:\\\\_|[^_]|_[^_]*_)+?)__(?!_)/us', + ); + + protected $EmRegex = array( + '*' => '/^[*]((?:\\\\\*|[^*]|[*][*][^*]+?[*][*])+?)[*](?![*])/s', + '_' => '/^_((?:\\\\_|[^_]|__[^_]*__)+?)_(?!_)\b/us', + ); + + protected $regexHtmlAttribute = '[a-zA-Z_:][\w:.-]*(?:\s*=\s*(?:[^"\'=<>`\s]+|"[^"]*"|\'[^\']*\'))?'; + + protected $voidElements = array( + 'area', 'base', 'br', 'col', 'command', 'embed', 'hr', 'img', 'input', 'link', 'meta', 'param', 'source', + ); + + protected $textLevelElements = array( + 'a', 'br', 'bdo', 'abbr', 'blink', 'nextid', 'acronym', 'basefont', + 'b', 'em', 'big', 'cite', 'small', 'spacer', 'listing', + 'i', 'rp', 'del', 'code', 'strike', 'marquee', + 'q', 'rt', 'ins', 'font', 'strong', + 's', 'tt', 'kbd', 'mark', + 'u', 'xm', 'sub', 'nobr', + 'sup', 'ruby', + 'var', 'span', + 'wbr', 'time', + ); +} diff --git a/vendor/erusev/parsedown/README.md b/vendor/erusev/parsedown/README.md new file mode 100644 index 0000000..b5d9ed2 --- /dev/null +++ b/vendor/erusev/parsedown/README.md @@ -0,0 +1,86 @@ +> I also make [Caret](https://caret.io?ref=parsedown) - a Markdown editor for Mac and PC. + +## Parsedown + +[![Build Status](https://img.shields.io/travis/erusev/parsedown/master.svg?style=flat-square)](https://travis-ci.org/erusev/parsedown) + + +Better Markdown Parser in PHP + +[Demo](http://parsedown.org/demo) | +[Benchmarks](http://parsedown.org/speed) | +[Tests](http://parsedown.org/tests/) | +[Documentation](https://github.com/erusev/parsedown/wiki/) + +### Features + +* One File +* No Dependencies +* Super Fast +* Extensible +* [GitHub flavored](https://help.github.com/articles/github-flavored-markdown) +* Tested in 5.3 to 7.1 and in HHVM +* [Markdown Extra extension](https://github.com/erusev/parsedown-extra) + +### Installation + +Include `Parsedown.php` or install [the composer package](https://packagist.org/packages/erusev/parsedown). + +### Example + +``` php +$Parsedown = new Parsedown(); + +echo $Parsedown->text('Hello _Parsedown_!'); # prints:

Hello Parsedown!

+``` + +More examples in [the wiki](https://github.com/erusev/parsedown/wiki/) and in [this video tutorial](http://youtu.be/wYZBY8DEikI). + +### Security + +Parsedown is capable of escaping user-input within the HTML that it generates. Additionally Parsedown will apply sanitisation to additional scripting vectors (such as scripting link destinations) that are introduced by the markdown syntax itself. + +To tell Parsedown that it is processing untrusted user-input, use the following: +```php +$parsedown = new Parsedown; +$parsedown->setSafeMode(true); +``` + +If instead, you wish to allow HTML within untrusted user-input, but still want output to be free from XSS it is recommended that you make use of a HTML sanitiser that allows HTML tags to be whitelisted, like [HTML Purifier](http://htmlpurifier.org/). + +In both cases you should strongly consider employing defence-in-depth measures, like [deploying a Content-Security-Policy](https://scotthelme.co.uk/content-security-policy-an-introduction/) (a browser security feature) so that your page is likely to be safe even if an attacker finds a vulnerability in one of the first lines of defence above. + +#### Security of Parsedown Extensions + +Safe mode does not necessarily yield safe results when using extensions to Parsedown. Extensions should be evaluated on their own to determine their specific safety against XSS. + +### Escaping HTML +> ⚠️  **WARNING:** This method isn't safe from XSS! + +If you wish to escape HTML **in trusted input**, you can use the following: +```php +$parsedown = new Parsedown; +$parsedown->setMarkupEscaped(true); +``` + +Beware that this still allows users to insert unsafe scripting vectors, such as links like `[xss](javascript:alert%281%29)`. + +### Questions + +**How does Parsedown work?** + +It tries to read Markdown like a human. First, it looks at the lines. It’s interested in how the lines start. This helps it recognise blocks. It knows, for example, that if a line starts with a `-` then perhaps it belongs to a list. Once it recognises the blocks, it continues to the content. As it reads, it watches out for special characters. This helps it recognise inline elements (or inlines). + +We call this approach "line based". We believe that Parsedown is the first Markdown parser to use it. Since the release of Parsedown, other developers have used the same approach to develop other Markdown parsers in PHP and in other languages. + +**Is it compliant with CommonMark?** + +It passes most of the CommonMark tests. Most of the tests that don't pass deal with cases that are quite uncommon. Still, as CommonMark matures, compliance should improve. + +**Who uses it?** + +[Laravel Framework](https://laravel.com/), [Bolt CMS](http://bolt.cm/), [Grav CMS](http://getgrav.org/), [Herbie CMS](http://www.getherbie.org/), [Kirby CMS](http://getkirby.com/), [October CMS](http://octobercms.com/), [Pico CMS](http://picocms.org), [Statamic CMS](http://www.statamic.com/), [phpDocumentor](http://www.phpdoc.org/), [RaspberryPi.org](http://www.raspberrypi.org/), [Symfony demo](https://github.com/symfony/symfony-demo) and [more](https://packagist.org/packages/erusev/parsedown/dependents). + +**How can I help?** + +Use it, star it, share it and if you feel generous, [donate](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=528P3NZQMP8N2). diff --git a/vendor/erusev/parsedown/composer.json b/vendor/erusev/parsedown/composer.json new file mode 100644 index 0000000..f8b40f8 --- /dev/null +++ b/vendor/erusev/parsedown/composer.json @@ -0,0 +1,33 @@ +{ + "name": "erusev/parsedown", + "description": "Parser for Markdown.", + "keywords": ["markdown", "parser"], + "homepage": "http://parsedown.org", + "type": "library", + "license": "MIT", + "authors": [ + { + "name": "Emanuil Rusev", + "email": "hello@erusev.com", + "homepage": "http://erusev.com" + } + ], + "require": { + "php": ">=5.3.0", + "ext-mbstring": "*" + }, + "require-dev": { + "phpunit/phpunit": "^4.8.35" + }, + "autoload": { + "psr-0": {"Parsedown": ""} + }, + "autoload-dev": { + "psr-0": { + "TestParsedown": "test/", + "ParsedownTest": "test/", + "CommonMarkTest": "test/", + "CommonMarkTestWeak": "test/" + } + } +} diff --git a/vendor/mikecao/flight/.gitignore b/vendor/mikecao/flight/.gitignore new file mode 100644 index 0000000..a5ec20f --- /dev/null +++ b/vendor/mikecao/flight/.gitignore @@ -0,0 +1,4 @@ +.idea +vendor/ +composer.phar +composer.lock diff --git a/vendor/mikecao/flight/LICENSE b/vendor/mikecao/flight/LICENSE new file mode 100644 index 0000000..cfbe851 --- /dev/null +++ b/vendor/mikecao/flight/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2011 Mike Cao + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. diff --git a/vendor/mikecao/flight/README.md b/vendor/mikecao/flight/README.md new file mode 100644 index 0000000..1a68de5 --- /dev/null +++ b/vendor/mikecao/flight/README.md @@ -0,0 +1,917 @@ +# What is Flight? + +Flight is a fast, simple, extensible framework for PHP. Flight enables you to +quickly and easily build RESTful web applications. + +```php +require 'flight/Flight.php'; + +Flight::route('/', function(){ + echo 'hello world!'; +}); + +Flight::start(); +``` + +[Learn more](http://flightphp.com/learn) + +# Requirements + +Flight requires `PHP 5.3` or greater. + +# License + +Flight is released under the [MIT](http://flightphp.com/license) license. + +# Installation + +1\. Download the files. + +If you're using [Composer](https://getcomposer.org/), you can run the following command: + +``` +composer require mikecao/flight +``` + +OR you can [download](https://github.com/mikecao/flight/archive/master.zip) them directly +and extract them to your web directory. + +2\. Configure your webserver. + +For *Apache*, edit your `.htaccess` file with the following: + +``` +RewriteEngine On +RewriteCond %{REQUEST_FILENAME} !-f +RewriteCond %{REQUEST_FILENAME} !-d +RewriteRule ^(.*)$ index.php [QSA,L] +``` + +**Note**: If you need to use flight in a subdirectory add the line `RewriteBase /subdir/` just after `RewriteEngine On`. + +For *Nginx*, add the following to your server declaration: + +``` +server { + location / { + try_files $uri $uri/ /index.php; + } +} +``` +3\. Create your `index.php` file. + +First include the framework. + +```php +require 'flight/Flight.php'; +``` + +If you're using Composer, run the autoloader instead. + +```php +require 'vendor/autoload.php'; +``` + +Then define a route and assign a function to handle the request. + +```php +Flight::route('/', function(){ + echo 'hello world!'; +}); +``` + +Finally, start the framework. + +```php +Flight::start(); +``` + +# Routing + +Routing in Flight is done by matching a URL pattern with a callback function. + +```php +Flight::route('/', function(){ + echo 'hello world!'; +}); +``` + +The callback can be any object that is callable. So you can use a regular function: + +```php +function hello(){ + echo 'hello world!'; +} + +Flight::route('/', 'hello'); +``` + +Or a class method: + +```php +class Greeting { + public static function hello() { + echo 'hello world!'; + } +} + +Flight::route('/', array('Greeting', 'hello')); +``` + +Or an object method: + +```php +class Greeting +{ + public function __construct() { + $this->name = 'John Doe'; + } + + public function hello() { + echo "Hello, {$this->name}!"; + } +} + +$greeting = new Greeting(); + +Flight::route('/', array($greeting, 'hello')); +``` + +Routes are matched in the order they are defined. The first route to match a +request will be invoked. + +## Method Routing + +By default, route patterns are matched against all request methods. You can respond +to specific methods by placing an identifier before the URL. + +```php +Flight::route('GET /', function(){ + echo 'I received a GET request.'; +}); + +Flight::route('POST /', function(){ + echo 'I received a POST request.'; +}); +``` + +You can also map multiple methods to a single callback by using a `|` delimiter: + +```php +Flight::route('GET|POST /', function(){ + echo 'I received either a GET or a POST request.'; +}); +``` + +## Regular Expressions + +You can use regular expressions in your routes: + +```php +Flight::route('/user/[0-9]+', function(){ + // This will match /user/1234 +}); +``` + +## Named Parameters + +You can specify named parameters in your routes which will be passed along to +your callback function. + +```php +Flight::route('/@name/@id', function($name, $id){ + echo "hello, $name ($id)!"; +}); +``` + +You can also include regular expressions with your named parameters by using +the `:` delimiter: + +```php +Flight::route('/@name/@id:[0-9]{3}', function($name, $id){ + // This will match /bob/123 + // But will not match /bob/12345 +}); +``` + +## Optional Parameters + +You can specify named parameters that are optional for matching by wrapping +segments in parentheses. + +```php +Flight::route('/blog(/@year(/@month(/@day)))', function($year, $month, $day){ + // This will match the following URLS: + // /blog/2012/12/10 + // /blog/2012/12 + // /blog/2012 + // /blog +}); +``` + +Any optional parameters that are not matched will be passed in as NULL. + +## Wildcards + +Matching is only done on individual URL segments. If you want to match multiple +segments you can use the `*` wildcard. + +```php +Flight::route('/blog/*', function(){ + // This will match /blog/2000/02/01 +}); +``` + +To route all requests to a single callback, you can do: + +```php +Flight::route('*', function(){ + // Do something +}); +``` + +## Passing + +You can pass execution on to the next matching route by returning `true` from +your callback function. + +```php +Flight::route('/user/@name', function($name){ + // Check some condition + if ($name != "Bob") { + // Continue to next route + return true; + } +}); + +Flight::route('/user/*', function(){ + // This will get called +}); +``` + +## Route Info + +If you want to inspect the matching route information, you can request for the route +object to be passed to your callback by passing in `true` as the third parameter in +the route method. The route object will always be the last parameter passed to your +callback function. + +```php +Flight::route('/', function($route){ + // Array of HTTP methods matched against + $route->methods; + + // Array of named parameters + $route->params; + + // Matching regular expression + $route->regex; + + // Contains the contents of any '*' used in the URL pattern + $route->splat; +}, true); +``` + +# Extending + +Flight is designed to be an extensible framework. The framework comes with a set +of default methods and components, but it allows you to map your own methods, +register your own classes, or even override existing classes and methods. + +## Mapping Methods + +To map your own custom method, you use the `map` function: + +```php +// Map your method +Flight::map('hello', function($name){ + echo "hello $name!"; +}); + +// Call your custom method +Flight::hello('Bob'); +``` + +## Registering Classes + +To register your own class, you use the `register` function: + +```php +// Register your class +Flight::register('user', 'User'); + +// Get an instance of your class +$user = Flight::user(); +``` + +The register method also allows you to pass along parameters to your class +constructor. So when you load your custom class, it will come pre-initialized. +You can define the constructor parameters by passing in an additional array. +Here's an example of loading a database connection: + +```php +// Register class with constructor parameters +Flight::register('db', 'PDO', array('mysql:host=localhost;dbname=test','user','pass')); + +// Get an instance of your class +// This will create an object with the defined parameters +// +// new PDO('mysql:host=localhost;dbname=test','user','pass'); +// +$db = Flight::db(); +``` + +If you pass in an additional callback parameter, it will be executed immediately +after class construction. This allows you to perform any set up procedures for your +new object. The callback function takes one parameter, an instance of the new object. + +```php +// The callback will be passed the object that was constructed +Flight::register('db', 'PDO', array('mysql:host=localhost;dbname=test','user','pass'), function($db){ + $db->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION); +}); +``` + +By default, every time you load your class you will get a shared instance. +To get a new instance of a class, simply pass in `false` as a parameter: + +```php +// Shared instance of the class +$shared = Flight::db(); + +// New instance of the class +$new = Flight::db(false); +``` + +Keep in mind that mapped methods have precedence over registered classes. If you +declare both using the same name, only the mapped method will be invoked. + +# Overriding + +Flight allows you to override its default functionality to suit your own needs, +without having to modify any code. + +For example, when Flight cannot match a URL to a route, it invokes the `notFound` +method which sends a generic `HTTP 404` response. You can override this behavior +by using the `map` method: + +```php +Flight::map('notFound', function(){ + // Display custom 404 page + include 'errors/404.html'; +}); +``` + +Flight also allows you to replace core components of the framework. +For example you can replace the default Router class with your own custom class: + +```php +// Register your custom class +Flight::register('router', 'MyRouter'); + +// When Flight loads the Router instance, it will load your class +$myrouter = Flight::router(); +``` + +Framework methods like `map` and `register` however cannot be overridden. You will +get an error if you try to do so. + +# Filtering + +Flight allows you to filter methods before and after they are called. There are no +predefined hooks you need to memorize. You can filter any of the default framework +methods as well as any custom methods that you've mapped. + +A filter function looks like this: + +```php +function(&$params, &$output) { + // Filter code +} +``` + +Using the passed in variables you can manipulate the input parameters and/or the output. + +You can have a filter run before a method by doing: + +```php +Flight::before('start', function(&$params, &$output){ + // Do something +}); +``` + +You can have a filter run after a method by doing: + +```php +Flight::after('start', function(&$params, &$output){ + // Do something +}); +``` + +You can add as many filters as you want to any method. They will be called in the +order that they are declared. + +Here's an example of the filtering process: + +```php +// Map a custom method +Flight::map('hello', function($name){ + return "Hello, $name!"; +}); + +// Add a before filter +Flight::before('hello', function(&$params, &$output){ + // Manipulate the parameter + $params[0] = 'Fred'; +}); + +// Add an after filter +Flight::after('hello', function(&$params, &$output){ + // Manipulate the output + $output .= " Have a nice day!"; +}); + +// Invoke the custom method +echo Flight::hello('Bob'); +``` + +This should display: + + Hello Fred! Have a nice day! + +If you have defined multiple filters, you can break the chain by returning `false` +in any of your filter functions: + +```php +Flight::before('start', function(&$params, &$output){ + echo 'one'; +}); + +Flight::before('start', function(&$params, &$output){ + echo 'two'; + + // This will end the chain + return false; +}); + +// This will not get called +Flight::before('start', function(&$params, &$output){ + echo 'three'; +}); +``` + +Note, core methods such as `map` and `register` cannot be filtered because they +are called directly and not invoked dynamically. + +# Variables + +Flight allows you to save variables so that they can be used anywhere in your application. + +```php +// Save your variable +Flight::set('id', 123); + +// Elsewhere in your application +$id = Flight::get('id'); +``` +To see if a variable has been set you can do: + +```php +if (Flight::has('id')) { + // Do something +} +``` + +You can clear a variable by doing: + +```php +// Clears the id variable +Flight::clear('id'); + +// Clears all variables +Flight::clear(); +``` + +Flight also uses variables for configuration purposes. + +```php +Flight::set('flight.log_errors', true); +``` + +# Views + +Flight provides some basic templating functionality by default. To display a view +template call the `render` method with the name of the template file and optional +template data: + +```php +Flight::render('hello.php', array('name' => 'Bob')); +``` + +The template data you pass in is automatically injected into the template and can +be reference like a local variable. Template files are simply PHP files. If the +content of the `hello.php` template file is: + +```php +Hello, ''! +``` + +The output would be: + + Hello, Bob! + +You can also manually set view variables by using the set method: + +```php +Flight::view()->set('name', 'Bob'); +``` + +The variable `name` is now available across all your views. So you can simply do: + +```php +Flight::render('hello'); +``` + +Note that when specifying the name of the template in the render method, you can +leave out the `.php` extension. + +By default Flight will look for a `views` directory for template files. You can +set an alternate path for your templates by setting the following config: + +```php +Flight::set('flight.views.path', '/path/to/views'); +``` + +## Layouts + +It is common for websites to have a single layout template file with interchanging +content. To render content to be used in a layout, you can pass in an optional +parameter to the `render` method. + +```php +Flight::render('header', array('heading' => 'Hello'), 'header_content'); +Flight::render('body', array('body' => 'World'), 'body_content'); +``` + +Your view will then have saved variables called `header_content` and `body_content`. +You can then render your layout by doing: + +```php +Flight::render('layout', array('title' => 'Home Page')); +``` + +If the template files looks like this: + +`header.php`: + +```php +

+``` + +`body.php`: + +```php +
+``` + +`layout.php`: + +```php + + +<?php echo $title; ?> + + + + + + +``` + +The output would be: +```html + + +Home Page + + +

Hello

+
World
+ + +``` + +## Custom Views + +Flight allows you to swap out the default view engine simply by registering your +own view class. Here's how you would use the [Smarty](http://www.smarty.net/) +template engine for your views: + +```php +// Load Smarty library +require './Smarty/libs/Smarty.class.php'; + +// Register Smarty as the view class +// Also pass a callback function to configure Smarty on load +Flight::register('view', 'Smarty', array(), function($smarty){ + $smarty->template_dir = './templates/'; + $smarty->compile_dir = './templates_c/'; + $smarty->config_dir = './config/'; + $smarty->cache_dir = './cache/'; +}); + +// Assign template data +Flight::view()->assign('name', 'Bob'); + +// Display the template +Flight::view()->display('hello.tpl'); +``` + +For completeness, you should also override Flight's default render method: + +```php +Flight::map('render', function($template, $data){ + Flight::view()->assign($data); + Flight::view()->display($template); +}); +``` +# Error Handling + +## Errors and Exceptions + +All errors and exceptions are caught by Flight and passed to the `error` method. +The default behavior is to send a generic `HTTP 500 Internal Server Error` +response with some error information. + +You can override this behavior for your own needs: + +```php +Flight::map('error', function(Exception $ex){ + // Handle error + echo $ex->getTraceAsString(); +}); +``` + +By default errors are not logged to the web server. You can enable this by +changing the config: + +```php +Flight::set('flight.log_errors', true); +``` + +## Not Found + +When a URL can't be found, Flight calls the `notFound` method. The default +behavior is to send an `HTTP 404 Not Found` response with a simple message. + +You can override this behavior for your own needs: + +```php +Flight::map('notFound', function(){ + // Handle not found +}); +``` + +# Redirects + +You can redirect the current request by using the `redirect` method and passing +in a new URL: + +```php +Flight::redirect('/new/location'); +``` + +By default Flight sends a HTTP 303 status code. You can optionally set a +custom code: + +```php +Flight::redirect('/new/location', 401); +``` + +# Requests + +Flight encapsulates the HTTP request into a single object, which can be +accessed by doing: + +```php +$request = Flight::request(); +``` + +The request object provides the following properties: + +``` +url - The URL being requested +base - The parent subdirectory of the URL +method - The request method (GET, POST, PUT, DELETE) +referrer - The referrer URL +ip - IP address of the client +ajax - Whether the request is an AJAX request +scheme - The server protocol (http, https) +user_agent - Browser information +type - The content type +length - The content length +query - Query string parameters +data - Post data or JSON data +cookies - Cookie data +files - Uploaded files +secure - Whether the connection is secure +accept - HTTP accept parameters +proxy_ip - Proxy IP address of the client +``` + +You can access the `query`, `data`, `cookies`, and `files` properties +as arrays or objects. + +So, to get a query string parameter, you can do: + +```php +$id = Flight::request()->query['id']; +``` + +Or you can do: + +```php +$id = Flight::request()->query->id; +``` + +## RAW Request Body + +To get the raw HTTP request body, for example when dealing with PUT requests, you can do: + +```php +$body = Flight::request()->getBody(); +``` + +## JSON Input + +If you send a request with the type `application/json` and the data `{"id": 123}` it will be available +from the `data` property: + +```php +$id = Flight::request()->data->id; +``` + +# HTTP Caching + +Flight provides built-in support for HTTP level caching. If the caching condition +is met, Flight will return an HTTP `304 Not Modified` response. The next time the +client requests the same resource, they will be prompted to use their locally +cached version. + +## Last-Modified + +You can use the `lastModified` method and pass in a UNIX timestamp to set the date +and time a page was last modified. The client will continue to use their cache until +the last modified value is changed. + +```php +Flight::route('/news', function(){ + Flight::lastModified(1234567890); + echo 'This content will be cached.'; +}); +``` + +## ETag + +`ETag` caching is similar to `Last-Modified`, except you can specify any id you +want for the resource: + +```php +Flight::route('/news', function(){ + Flight::etag('my-unique-id'); + echo 'This content will be cached.'; +}); +``` + +Keep in mind that calling either `lastModified` or `etag` will both set and check the +cache value. If the cache value is the same between requests, Flight will immediately +send an `HTTP 304` response and stop processing. + +# Stopping + +You can stop the framework at any point by calling the `halt` method: + +```php +Flight::halt(); +``` + +You can also specify an optional `HTTP` status code and message: + +```php +Flight::halt(200, 'Be right back...'); +``` + +Calling `halt` will discard any response content up to that point. If you want to stop +the framework and output the current response, use the `stop` method: + +```php +Flight::stop(); +``` + +# JSON + +Flight provides support for sending JSON and JSONP responses. To send a JSON response you +pass some data to be JSON encoded: + +```php +Flight::json(array('id' => 123)); +``` + +For JSONP requests you, can optionally pass in the query parameter name you are +using to define your callback function: + +```php +Flight::jsonp(array('id' => 123), 'q'); +``` + +So, when making a GET request using `?q=my_func`, you should receive the output: + +``` +my_func({"id":123}); +``` + +If you don't pass in a query parameter name it will default to `jsonp`. + + +# Configuration + +You can customize certain behaviors of Flight by setting configuration values +through the `set` method. + +```php +Flight::set('flight.log_errors', true); +``` + +The following is a list of all the available configuration settings: + + flight.base_url - Override the base url of the request. (default: null) + flight.case_sensitive - Case sensitive matching for URLs. (default: false) + flight.handle_errors - Allow Flight to handle all errors internally. (default: true) + flight.log_errors - Log errors to the web server's error log file. (default: false) + flight.views.path - Directory containing view template files. (default: ./views) + flight.views.extension - View template file extension. (default: .php) + +# Framework Methods + +Flight is designed to be easy to use and understand. The following is the complete +set of methods for the framework. It consists of core methods, which are regular +static methods, and extensible methods, which are mapped methods that can be filtered +or overridden. + +## Core Methods + +```php +Flight::map($name, $callback) // Creates a custom framework method. +Flight::register($name, $class, [$params], [$callback]) // Registers a class to a framework method. +Flight::before($name, $callback) // Adds a filter before a framework method. +Flight::after($name, $callback) // Adds a filter after a framework method. +Flight::path($path) // Adds a path for autoloading classes. +Flight::get($key) // Gets a variable. +Flight::set($key, $value) // Sets a variable. +Flight::has($key) // Checks if a variable is set. +Flight::clear([$key]) // Clears a variable. +Flight::init() // Initializes the framework to its default settings. +Flight::app() // Gets the application object instance +``` + +## Extensible Methods + +```php +Flight::start() // Starts the framework. +Flight::stop() // Stops the framework and sends a response. +Flight::halt([$code], [$message]) // Stop the framework with an optional status code and message. +Flight::route($pattern, $callback) // Maps a URL pattern to a callback. +Flight::redirect($url, [$code]) // Redirects to another URL. +Flight::render($file, [$data], [$key]) // Renders a template file. +Flight::error($exception) // Sends an HTTP 500 response. +Flight::notFound() // Sends an HTTP 404 response. +Flight::etag($id, [$type]) // Performs ETag HTTP caching. +Flight::lastModified($time) // Performs last modified HTTP caching. +Flight::json($data, [$code], [$encode], [$charset], [$option]) // Sends a JSON response. +Flight::jsonp($data, [$param], [$code], [$encode], [$charset], [$option]) // Sends a JSONP response. +``` + +Any custom methods added with `map` and `register` can also be filtered. + + +# Framework Instance + +Instead of running Flight as a global static class, you can optionally run it +as an object instance. + +```php +require 'flight/autoload.php'; + +use flight\Engine; + +$app = new Engine(); + +$app->route('/', function(){ + echo 'hello world!'; +}); + +$app->start(); +``` + +So instead of calling the static method, you would call the instance method with +the same name on the Engine object. diff --git a/vendor/mikecao/flight/VERSION b/vendor/mikecao/flight/VERSION new file mode 100644 index 0000000..3336003 --- /dev/null +++ b/vendor/mikecao/flight/VERSION @@ -0,0 +1 @@ +1.3.7 diff --git a/vendor/mikecao/flight/composer.json b/vendor/mikecao/flight/composer.json new file mode 100644 index 0000000..89456e7 --- /dev/null +++ b/vendor/mikecao/flight/composer.json @@ -0,0 +1,23 @@ +{ + "name": "mikecao/flight", + "description": "Flight is a fast, simple, extensible framework for PHP. Flight enables you to quickly and easily build RESTful web applications.", + "homepage": "http://flightphp.com", + "license": "MIT", + "authors": [ + { + "name": "Mike Cao", + "email": "mike@mikecao.com", + "homepage": "http://www.mikecao.com/", + "role": "Original Developer" + } + ], + "require": { + "php": ">=5.3.0" + }, + "autoload": { + "files": [ "flight/autoload.php", "flight/Flight.php" ] + }, + "require-dev": { + "phpunit/phpunit": "~4.6" + } +} diff --git a/vendor/mikecao/flight/flight/Engine.php b/vendor/mikecao/flight/flight/Engine.php new file mode 100644 index 0000000..0fd9c50 --- /dev/null +++ b/vendor/mikecao/flight/flight/Engine.php @@ -0,0 +1,574 @@ + + * @license MIT, http://flightphp.com/license + */ + +namespace flight; + +use flight\core\Loader; +use flight\core\Dispatcher; + +/** + * The Engine class contains the core functionality of the framework. + * It is responsible for loading an HTTP request, running the assigned services, + * and generating an HTTP response. + * + * Core methods + * @method void start() Starts engine + * @method void stop() Stops framework and outputs current response + * @method void halt(int $code = 200, string $message = '') Stops processing and returns a given response. + * + * + * Routing + * @method void route(string $pattern, callable $callback, bool $pass_route = false) Routes a URL to a callback function. + * @method \flight\net\Router router() Gets router + * + * Views + * @method void render(string $file, array $data = null, string $key = null) Renders template + * @method \flight\template\View view() Gets current view + * + * Request-response + * @method \flight\net\Request request() Gets current request + * @method \flight\net\Response response() Gets current response + * @method void error(\Exception $e) Sends an HTTP 500 response for any errors. + * @method void notFound() Sends an HTTP 404 response when a URL is not found. + * @method void redirect(string $url, int $code = 303) Redirects the current request to another URL. + * @method void json(mixed $data, int $code = 200, bool $encode = true, string $charset = 'utf-8', int $option = 0) Sends a JSON response. + * @method void jsonp(mixed $data, string $param = 'jsonp', int $code = 200, bool $encode = true, string $charset = 'utf-8', int $option = 0) Sends a JSONP response. + * + * HTTP caching + * @method void etag($id, string $type = 'strong') Handles ETag HTTP caching. + * @method void lastModified(int $time) Handles last modified HTTP caching. + */ +class Engine { + /** + * Stored variables. + * + * @var array + */ + protected $vars; + + /** + * Class loader. + * + * @var Loader + */ + protected $loader; + + /** + * Event dispatcher. + * + * @var Dispatcher + */ + protected $dispatcher; + + /** + * Constructor. + */ + public function __construct() { + $this->vars = array(); + + $this->loader = new Loader(); + $this->dispatcher = new Dispatcher(); + + $this->init(); + } + + /** + * Handles calls to class methods. + * + * @param string $name Method name + * @param array $params Method parameters + * @return mixed Callback results + * @throws \Exception + */ + public function __call($name, $params) { + $callback = $this->dispatcher->get($name); + + if (is_callable($callback)) { + return $this->dispatcher->run($name, $params); + } + + if (!$this->loader->get($name)) { + throw new \Exception("{$name} must be a mapped method."); + } + + $shared = (!empty($params)) ? (bool)$params[0] : true; + + return $this->loader->load($name, $shared); + } + + /*** Core Methods ***/ + + /** + * Initializes the framework. + */ + public function init() { + static $initialized = false; + $self = $this; + + if ($initialized) { + $this->vars = array(); + $this->loader->reset(); + $this->dispatcher->reset(); + } + + // Register default components + $this->loader->register('request', '\flight\net\Request'); + $this->loader->register('response', '\flight\net\Response'); + $this->loader->register('router', '\flight\net\Router'); + $this->loader->register('view', '\flight\template\View', array(), function($view) use ($self) { + $view->path = $self->get('flight.views.path'); + $view->extension = $self->get('flight.views.extension'); + }); + + // Register framework methods + $methods = array( + 'start','stop','route','halt','error','notFound', + 'render','redirect','etag','lastModified','json','jsonp' + ); + foreach ($methods as $name) { + $this->dispatcher->set($name, array($this, '_'.$name)); + } + + // Default configuration settings + $this->set('flight.base_url', null); + $this->set('flight.case_sensitive', false); + $this->set('flight.handle_errors', true); + $this->set('flight.log_errors', false); + $this->set('flight.views.path', './views'); + $this->set('flight.views.extension', '.php'); + + // Startup configuration + $this->before('start', function() use ($self) { + // Enable error handling + if ($self->get('flight.handle_errors')) { + set_error_handler(array($self, 'handleError')); + set_exception_handler(array($self, 'handleException')); + } + + // Set case-sensitivity + $self->router()->case_sensitive = $self->get('flight.case_sensitive'); + }); + + $initialized = true; + } + + /** + * Custom error handler. Converts errors into exceptions. + * + * @param int $errno Error number + * @param int $errstr Error string + * @param int $errfile Error file name + * @param int $errline Error file line number + * @throws \ErrorException + */ + public function handleError($errno, $errstr, $errfile, $errline) { + if ($errno & error_reporting()) { + throw new \ErrorException($errstr, $errno, 0, $errfile, $errline); + } + } + + /** + * Custom exception handler. Logs exceptions. + * + * @param \Exception $e Thrown exception + */ + public function handleException($e) { + if ($this->get('flight.log_errors')) { + error_log($e->getMessage()); + } + + $this->error($e); + } + + /** + * Maps a callback to a framework method. + * + * @param string $name Method name + * @param callback $callback Callback function + * @throws \Exception If trying to map over a framework method + */ + public function map($name, $callback) { + if (method_exists($this, $name)) { + throw new \Exception('Cannot override an existing framework method.'); + } + + $this->dispatcher->set($name, $callback); + } + + /** + * Registers a class to a framework method. + * + * @param string $name Method name + * @param string $class Class name + * @param array $params Class initialization parameters + * @param callback $callback Function to call after object instantiation + * @throws \Exception If trying to map over a framework method + */ + public function register($name, $class, array $params = array(), $callback = null) { + if (method_exists($this, $name)) { + throw new \Exception('Cannot override an existing framework method.'); + } + + $this->loader->register($name, $class, $params, $callback); + } + + /** + * Adds a pre-filter to a method. + * + * @param string $name Method name + * @param callback $callback Callback function + */ + public function before($name, $callback) { + $this->dispatcher->hook($name, 'before', $callback); + } + + /** + * Adds a post-filter to a method. + * + * @param string $name Method name + * @param callback $callback Callback function + */ + public function after($name, $callback) { + $this->dispatcher->hook($name, 'after', $callback); + } + + /** + * Gets a variable. + * + * @param string $key Key + * @return mixed + */ + public function get($key = null) { + if ($key === null) return $this->vars; + + return isset($this->vars[$key]) ? $this->vars[$key] : null; + } + + /** + * Sets a variable. + * + * @param mixed $key Key + * @param string $value Value + */ + public function set($key, $value = null) { + if (is_array($key) || is_object($key)) { + foreach ($key as $k => $v) { + $this->vars[$k] = $v; + } + } + else { + $this->vars[$key] = $value; + } + } + + /** + * Checks if a variable has been set. + * + * @param string $key Key + * @return bool Variable status + */ + public function has($key) { + return isset($this->vars[$key]); + } + + /** + * Unsets a variable. If no key is passed in, clear all variables. + * + * @param string $key Key + */ + public function clear($key = null) { + if (is_null($key)) { + $this->vars = array(); + } + else { + unset($this->vars[$key]); + } + } + + /** + * Adds a path for class autoloading. + * + * @param string $dir Directory path + */ + public function path($dir) { + $this->loader->addDirectory($dir); + } + + /*** Extensible Methods ***/ + + /** + * Starts the framework. + * @throws \Exception + */ + public function _start() { + $dispatched = false; + $self = $this; + $request = $this->request(); + $response = $this->response(); + $router = $this->router(); + + // Allow filters to run + $this->after('start', function() use ($self) { + $self->stop(); + }); + + // Flush any existing output + if (ob_get_length() > 0) { + $response->write(ob_get_clean()); + } + + // Enable output buffering + ob_start(); + + // Route the request + while ($route = $router->route($request)) { + $params = array_values($route->params); + + // Add route info to the parameter list + if ($route->pass) { + $params[] = $route; + } + + // Call route handler + $continue = $this->dispatcher->execute( + $route->callback, + $params + ); + + $dispatched = true; + + if (!$continue) break; + + $router->next(); + + $dispatched = false; + } + + if (!$dispatched) { + $this->notFound(); + } + } + + /** + * Stops the framework and outputs the current response. + * + * @param int $code HTTP status code + * @throws \Exception + */ + public function _stop($code = null) { + $response = $this->response(); + + if (!$response->sent()) { + if ($code !== null) { + $response->status($code); + } + + $response->write(ob_get_clean()); + + $response->send(); + } + } + + /** + * Routes a URL to a callback function. + * + * @param string $pattern URL pattern to match + * @param callback $callback Callback function + * @param boolean $pass_route Pass the matching route object to the callback + */ + public function _route($pattern, $callback, $pass_route = false) { + $this->router()->map($pattern, $callback, $pass_route); + } + + /** + * Stops processing and returns a given response. + * + * @param int $code HTTP status code + * @param string $message Response message + */ + public function _halt($code = 200, $message = '') { + $this->response() + ->clear() + ->status($code) + ->write($message) + ->send(); + exit(); + } + + /** + * Sends an HTTP 500 response for any errors. + * + * @param \Exception|\Throwable $e Thrown exception + */ + public function _error($e) { + $msg = sprintf('

500 Internal Server Error

'. + '

%s (%s)

'. + '
%s
', + $e->getMessage(), + $e->getCode(), + $e->getTraceAsString() + ); + + try { + $this->response() + ->clear() + ->status(500) + ->write($msg) + ->send(); + } + catch (\Throwable $t) { // PHP 7.0+ + exit($msg); + } catch(\Exception $e) { // PHP < 7 + exit($msg); + } + } + + /** + * Sends an HTTP 404 response when a URL is not found. + */ + public function _notFound() { + $this->response() + ->clear() + ->status(404) + ->write( + '

404 Not Found

'. + '

The page you have requested could not be found.

'. + str_repeat(' ', 512) + ) + ->send(); + } + + /** + * Redirects the current request to another URL. + * + * @param string $url URL + * @param int $code HTTP status code + */ + public function _redirect($url, $code = 303) { + $base = $this->get('flight.base_url'); + + if ($base === null) { + $base = $this->request()->base; + } + + // Append base url to redirect url + if ($base != '/' && strpos($url, '://') === false) { + $url = $base . preg_replace('#/+#', '/', '/' . $url); + } + + $this->response() + ->clear() + ->status($code) + ->header('Location', $url) + ->send(); + } + + /** + * Renders a template. + * + * @param string $file Template file + * @param array $data Template data + * @param string $key View variable name + * @throws \Exception + */ + public function _render($file, $data = null, $key = null) { + if ($key !== null) { + $this->view()->set($key, $this->view()->fetch($file, $data)); + } + else { + $this->view()->render($file, $data); + } + } + + /** + * Sends a JSON response. + * + * @param mixed $data JSON data + * @param int $code HTTP status code + * @param bool $encode Whether to perform JSON encoding + * @param string $charset Charset + * @param int $option Bitmask Json constant such as JSON_HEX_QUOT + * @throws \Exception + */ + public function _json( + $data, + $code = 200, + $encode = true, + $charset = 'utf-8', + $option = 0 + ) { + $json = ($encode) ? json_encode($data, $option) : $data; + + $this->response() + ->status($code) + ->header('Content-Type', 'application/json; charset='.$charset) + ->write($json) + ->send(); + } + + /** + * Sends a JSONP response. + * + * @param mixed $data JSON data + * @param string $param Query parameter that specifies the callback name. + * @param int $code HTTP status code + * @param bool $encode Whether to perform JSON encoding + * @param string $charset Charset + * @param int $option Bitmask Json constant such as JSON_HEX_QUOT + * @throws \Exception + */ + public function _jsonp( + $data, + $param = 'jsonp', + $code = 200, + $encode = true, + $charset = 'utf-8', + $option = 0 + ) { + $json = ($encode) ? json_encode($data, $option) : $data; + + $callback = $this->request()->query[$param]; + + $this->response() + ->status($code) + ->header('Content-Type', 'application/javascript; charset='.$charset) + ->write($callback.'('.$json.');') + ->send(); + } + + /** + * Handles ETag HTTP caching. + * + * @param string $id ETag identifier + * @param string $type ETag type + */ + public function _etag($id, $type = 'strong') { + $id = (($type === 'weak') ? 'W/' : '').$id; + + $this->response()->header('ETag', $id); + + if (isset($_SERVER['HTTP_IF_NONE_MATCH']) && + $_SERVER['HTTP_IF_NONE_MATCH'] === $id) { + $this->halt(304); + } + } + + /** + * Handles last modified HTTP caching. + * + * @param int $time Unix timestamp + */ + public function _lastModified($time) { + $this->response()->header('Last-Modified', gmdate('D, d M Y H:i:s \G\M\T', $time)); + + if (isset($_SERVER['HTTP_IF_MODIFIED_SINCE']) && + strtotime($_SERVER['HTTP_IF_MODIFIED_SINCE']) === $time) { + $this->halt(304); + } + } +} diff --git a/vendor/mikecao/flight/flight/Flight.php b/vendor/mikecao/flight/flight/Flight.php new file mode 100644 index 0000000..1f75cde --- /dev/null +++ b/vendor/mikecao/flight/flight/Flight.php @@ -0,0 +1,96 @@ + + * @license MIT, http://flightphp.com/license + */ + +/** + * The Flight class is a static representation of the framework. + * + * Core. + * @method static void start() Starts the framework. + * @method static void path($path) Adds a path for autoloading classes. + * @method static void stop() Stops the framework and sends a response. + * @method static void halt($code = 200, $message = '') Stop the framework with an optional status code and message. + * + * Routing. + * @method static void route($pattern, $callback) Maps a URL pattern to a callback. + * @method static \flight\net\Router router() Returns Router instance. + * + * Extending & Overriding. + * @method static void map($name, $callback) Creates a custom framework method. + * @method static void register($name, $class, array $params = array(), $callback = null) Registers a class to a framework method. + * + * Filtering. + * @method static void before($name, $callback) Adds a filter before a framework method. + * @method static void after($name, $callback) Adds a filter after a framework method. + * + * Variables. + * @method static void set($key, $value) Sets a variable. + * @method static mixed get($key) Gets a variable. + * @method static bool has($key) Checks if a variable is set. + * @method static void clear($key = null) Clears a variable. + * + * Views. + * @method static void render($file, array $data = null, $key = null) Renders a template file. + * @method static \flight\template\View view() Returns View instance. + * + * Request & Response. + * @method static \flight\net\Request request() Returns Request instance. + * @method static \flight\net\Response response() Returns Response instance. + * @method static void redirect($url, $code = 303) Redirects to another URL. + * @method static void json($data, $code = 200, $encode = true, $charset = "utf8", $encodeOption = 0, $encodeDepth = 512) Sends a JSON response. + * @method static void jsonp($data, $param = 'jsonp', $code = 200, $encode = true, $charset = "utf8", $encodeOption = 0, $encodeDepth = 512) Sends a JSONP response. + * @method static void error($exception) Sends an HTTP 500 response. + * @method static void notFound() Sends an HTTP 404 response. + * + * HTTP Caching. + * @method static void etag($id, $type = 'strong') Performs ETag HTTP caching. + * @method static void lastModified($time) Performs last modified HTTP caching. + */ +class Flight { + /** + * Framework engine. + * + * @var \flight\Engine + */ + private static $engine; + + // Don't allow object instantiation + private function __construct() {} + private function __destruct() {} + private function __clone() {} + + /** + * Handles calls to static methods. + * + * @param string $name Method name + * @param array $params Method parameters + * @return mixed Callback results + * @throws \Exception + */ + public static function __callStatic($name, $params) { + $app = Flight::app(); + + return \flight\core\Dispatcher::invokeMethod(array($app, $name), $params); + } + + /** + * @return \flight\Engine Application instance + */ + public static function app() { + static $initialized = false; + + if (!$initialized) { + require_once __DIR__.'/autoload.php'; + + self::$engine = new \flight\Engine(); + + $initialized = true; + } + + return self::$engine; + } +} diff --git a/vendor/mikecao/flight/flight/autoload.php b/vendor/mikecao/flight/flight/autoload.php new file mode 100644 index 0000000..ec082f6 --- /dev/null +++ b/vendor/mikecao/flight/flight/autoload.php @@ -0,0 +1,11 @@ + + * @license MIT, http://flightphp.com/license + */ + +require_once __DIR__.'/core/Loader.php'; + +\flight\core\Loader::autoload(true, dirname(__DIR__)); diff --git a/vendor/mikecao/flight/flight/core/Dispatcher.php b/vendor/mikecao/flight/flight/core/Dispatcher.php new file mode 100644 index 0000000..b182641 --- /dev/null +++ b/vendor/mikecao/flight/flight/core/Dispatcher.php @@ -0,0 +1,232 @@ + + * @license MIT, http://flightphp.com/license + */ + +namespace flight\core; + +/** + * The Dispatcher class is responsible for dispatching events. Events + * are simply aliases for class methods or functions. The Dispatcher + * allows you to hook other functions to an event that can modify the + * input parameters and/or the output. + */ +class Dispatcher { + /** + * Mapped events. + * + * @var array + */ + protected $events = array(); + + /** + * Method filters. + * + * @var array + */ + protected $filters = array(); + + /** + * Dispatches an event. + * + * @param string $name Event name + * @param array $params Callback parameters + * @return string Output of callback + * @throws \Exception + */ + public function run($name, array $params = array()) { + $output = ''; + + // Run pre-filters + if (!empty($this->filters[$name]['before'])) { + $this->filter($this->filters[$name]['before'], $params, $output); + } + + // Run requested method + $output = $this->execute($this->get($name), $params); + + // Run post-filters + if (!empty($this->filters[$name]['after'])) { + $this->filter($this->filters[$name]['after'], $params, $output); + } + + return $output; + } + + /** + * Assigns a callback to an event. + * + * @param string $name Event name + * @param callback $callback Callback function + */ + public function set($name, $callback) { + $this->events[$name] = $callback; + } + + /** + * Gets an assigned callback. + * + * @param string $name Event name + * @return callback $callback Callback function + */ + public function get($name) { + return isset($this->events[$name]) ? $this->events[$name] : null; + } + + /** + * Checks if an event has been set. + * + * @param string $name Event name + * @return bool Event status + */ + public function has($name) { + return isset($this->events[$name]); + } + + /** + * Clears an event. If no name is given, + * all events are removed. + * + * @param string $name Event name + */ + public function clear($name = null) { + if ($name !== null) { + unset($this->events[$name]); + unset($this->filters[$name]); + } + else { + $this->events = array(); + $this->filters = array(); + } + } + + /** + * Hooks a callback to an event. + * + * @param string $name Event name + * @param string $type Filter type + * @param callback $callback Callback function + */ + public function hook($name, $type, $callback) { + $this->filters[$name][$type][] = $callback; + } + + /** + * Executes a chain of method filters. + * + * @param array $filters Chain of filters + * @param array $params Method parameters + * @param mixed $output Method output + * @throws \Exception + */ + public function filter($filters, &$params, &$output) { + $args = array(&$params, &$output); + foreach ($filters as $callback) { + $continue = $this->execute($callback, $args); + if ($continue === false) break; + } + } + + /** + * Executes a callback function. + * + * @param callback $callback Callback function + * @param array $params Function parameters + * @return mixed Function results + * @throws \Exception + */ + public static function execute($callback, array &$params = array()) { + if (is_callable($callback)) { + return is_array($callback) ? + self::invokeMethod($callback, $params) : + self::callFunction($callback, $params); + } + else { + throw new \Exception('Invalid callback specified.'); + } + } + + /** + * Calls a function. + * + * @param string $func Name of function to call + * @param array $params Function parameters + * @return mixed Function results + */ + public static function callFunction($func, array &$params = array()) { + // Call static method + if (is_string($func) && strpos($func, '::') !== false) { + return call_user_func_array($func, $params); + } + + switch (count($params)) { + case 0: + return $func(); + case 1: + return $func($params[0]); + case 2: + return $func($params[0], $params[1]); + case 3: + return $func($params[0], $params[1], $params[2]); + case 4: + return $func($params[0], $params[1], $params[2], $params[3]); + case 5: + return $func($params[0], $params[1], $params[2], $params[3], $params[4]); + default: + return call_user_func_array($func, $params); + } + } + + /** + * Invokes a method. + * + * @param mixed $func Class method + * @param array $params Class method parameters + * @return mixed Function results + */ + public static function invokeMethod($func, array &$params = array()) { + list($class, $method) = $func; + + $instance = is_object($class); + + switch (count($params)) { + case 0: + return ($instance) ? + $class->$method() : + $class::$method(); + case 1: + return ($instance) ? + $class->$method($params[0]) : + $class::$method($params[0]); + case 2: + return ($instance) ? + $class->$method($params[0], $params[1]) : + $class::$method($params[0], $params[1]); + case 3: + return ($instance) ? + $class->$method($params[0], $params[1], $params[2]) : + $class::$method($params[0], $params[1], $params[2]); + case 4: + return ($instance) ? + $class->$method($params[0], $params[1], $params[2], $params[3]) : + $class::$method($params[0], $params[1], $params[2], $params[3]); + case 5: + return ($instance) ? + $class->$method($params[0], $params[1], $params[2], $params[3], $params[4]) : + $class::$method($params[0], $params[1], $params[2], $params[3], $params[4]); + default: + return call_user_func_array($func, $params); + } + } + + /** + * Resets the object to the initial state. + */ + public function reset() { + $this->events = array(); + $this->filters = array(); + } +} diff --git a/vendor/mikecao/flight/flight/core/Loader.php b/vendor/mikecao/flight/flight/core/Loader.php new file mode 100644 index 0000000..76e3ea4 --- /dev/null +++ b/vendor/mikecao/flight/flight/core/Loader.php @@ -0,0 +1,215 @@ + + * @license MIT, http://flightphp.com/license + */ + +namespace flight\core; + +/** + * The Loader class is responsible for loading objects. It maintains + * a list of reusable class instances and can generate a new class + * instances with custom initialization parameters. It also performs + * class autoloading. + */ +class Loader { + /** + * Registered classes. + * + * @var array + */ + protected $classes = array(); + + /** + * Class instances. + * + * @var array + */ + protected $instances = array(); + + /** + * Autoload directories. + * + * @var array + */ + protected static $dirs = array(); + + /** + * Registers a class. + * + * @param string $name Registry name + * @param string|callable $class Class name or function to instantiate class + * @param array $params Class initialization parameters + * @param callback $callback Function to call after object instantiation + */ + public function register($name, $class, array $params = array(), $callback = null) { + unset($this->instances[$name]); + + $this->classes[$name] = array($class, $params, $callback); + } + + /** + * Unregisters a class. + * + * @param string $name Registry name + */ + public function unregister($name) { + unset($this->classes[$name]); + } + + /** + * Loads a registered class. + * + * @param string $name Method name + * @param bool $shared Shared instance + * @return object Class instance + * @throws \Exception + */ + public function load($name, $shared = true) { + $obj = null; + + if (isset($this->classes[$name])) { + list($class, $params, $callback) = $this->classes[$name]; + + $exists = isset($this->instances[$name]); + + if ($shared) { + $obj = ($exists) ? + $this->getInstance($name) : + $this->newInstance($class, $params); + + if (!$exists) { + $this->instances[$name] = $obj; + } + } + else { + $obj = $this->newInstance($class, $params); + } + + if ($callback && (!$shared || !$exists)) { + $ref = array(&$obj); + call_user_func_array($callback, $ref); + } + } + + return $obj; + } + + /** + * Gets a single instance of a class. + * + * @param string $name Instance name + * @return object Class instance + */ + public function getInstance($name) { + return isset($this->instances[$name]) ? $this->instances[$name] : null; + } + + /** + * Gets a new instance of a class. + * + * @param string|callable $class Class name or callback function to instantiate class + * @param array $params Class initialization parameters + * @return object Class instance + * @throws \Exception + */ + public function newInstance($class, array $params = array()) { + if (is_callable($class)) { + return call_user_func_array($class, $params); + } + + switch (count($params)) { + case 0: + return new $class(); + case 1: + return new $class($params[0]); + case 2: + return new $class($params[0], $params[1]); + case 3: + return new $class($params[0], $params[1], $params[2]); + case 4: + return new $class($params[0], $params[1], $params[2], $params[3]); + case 5: + return new $class($params[0], $params[1], $params[2], $params[3], $params[4]); + default: + try { + $refClass = new \ReflectionClass($class); + return $refClass->newInstanceArgs($params); + } catch (\ReflectionException $e) { + throw new \Exception("Cannot instantiate {$class}", 0, $e); + } + } + } + + /** + * @param string $name Registry name + * @return mixed Class information or null if not registered + */ + public function get($name) { + return isset($this->classes[$name]) ? $this->classes[$name] : null; + } + + /** + * Resets the object to the initial state. + */ + public function reset() { + $this->classes = array(); + $this->instances = array(); + } + + /*** Autoloading Functions ***/ + + /** + * Starts/stops autoloader. + * + * @param bool $enabled Enable/disable autoloading + * @param array $dirs Autoload directories + */ + public static function autoload($enabled = true, $dirs = array()) { + if ($enabled) { + spl_autoload_register(array(__CLASS__, 'loadClass')); + } + else { + spl_autoload_unregister(array(__CLASS__, 'loadClass')); + } + + if (!empty($dirs)) { + self::addDirectory($dirs); + } + } + + /** + * Autoloads classes. + * + * @param string $class Class name + */ + public static function loadClass($class) { + $class_file = str_replace(array('\\', '_'), '/', $class).'.php'; + + foreach (self::$dirs as $dir) { + $file = $dir.'/'.$class_file; + if (file_exists($file)) { + require $file; + return; + } + } + } + + /** + * Adds a directory for autoloading classes. + * + * @param mixed $dir Directory path + */ + public static function addDirectory($dir) { + if (is_array($dir) || is_object($dir)) { + foreach ($dir as $value) { + self::addDirectory($value); + } + } + else if (is_string($dir)) { + if (!in_array($dir, self::$dirs)) self::$dirs[] = $dir; + } + } +} diff --git a/vendor/mikecao/flight/flight/net/Request.php b/vendor/mikecao/flight/flight/net/Request.php new file mode 100644 index 0000000..8cae7c2 --- /dev/null +++ b/vendor/mikecao/flight/flight/net/Request.php @@ -0,0 +1,289 @@ + + * @license MIT, http://flightphp.com/license + */ + +namespace flight\net; + +use flight\util\Collection; + +/** + * The Request class represents an HTTP request. Data from + * all the super globals $_GET, $_POST, $_COOKIE, and $_FILES + * are stored and accessible via the Request object. + * + * The default request properties are: + * url - The URL being requested + * base - The parent subdirectory of the URL + * method - The request method (GET, POST, PUT, DELETE) + * referrer - The referrer URL + * ip - IP address of the client + * ajax - Whether the request is an AJAX request + * scheme - The server protocol (http, https) + * user_agent - Browser information + * type - The content type + * length - The content length + * query - Query string parameters + * data - Post parameters + * cookies - Cookie parameters + * files - Uploaded files + * secure - Connection is secure + * accept - HTTP accept parameters + * proxy_ip - Proxy IP address of the client + */ +class Request { + /** + * @var string URL being requested + */ + public $url; + + /** + * @var string Parent subdirectory of the URL + */ + public $base; + + /** + * @var string Request method (GET, POST, PUT, DELETE) + */ + public $method; + + /** + * @var string Referrer URL + */ + public $referrer; + + /** + * @var string IP address of the client + */ + public $ip; + + /** + * @var bool Whether the request is an AJAX request + */ + public $ajax; + + /** + * @var string Server protocol (http, https) + */ + public $scheme; + + /** + * @var string Browser information + */ + public $user_agent; + + /** + * @var string Content type + */ + public $type; + + /** + * @var int Content length + */ + public $length; + + /** + * @var \flight\util\Collection Query string parameters + */ + public $query; + + /** + * @var \flight\util\Collection Post parameters + */ + public $data; + + /** + * @var \flight\util\Collection Cookie parameters + */ + public $cookies; + + /** + * @var \flight\util\Collection Uploaded files + */ + public $files; + + /** + * @var bool Whether the connection is secure + */ + public $secure; + + /** + * @var string HTTP accept parameters + */ + public $accept; + + /** + * @var string Proxy IP address of the client + */ + public $proxy_ip; + + /** + * Constructor. + * + * @param array $config Request configuration + */ + public function __construct($config = array()) { + // Default properties + if (empty($config)) { + $config = array( + 'url' => str_replace('@', '%40', self::getVar('REQUEST_URI', '/')), + 'base' => str_replace(array('\\',' '), array('/','%20'), dirname(self::getVar('SCRIPT_NAME'))), + 'method' => self::getMethod(), + 'referrer' => self::getVar('HTTP_REFERER'), + 'ip' => self::getVar('REMOTE_ADDR'), + 'ajax' => self::getVar('HTTP_X_REQUESTED_WITH') == 'XMLHttpRequest', + 'scheme' => self::getVar('SERVER_PROTOCOL', 'HTTP/1.1'), + 'user_agent' => self::getVar('HTTP_USER_AGENT'), + 'type' => self::getVar('CONTENT_TYPE'), + 'length' => self::getVar('CONTENT_LENGTH', 0), + 'query' => new Collection($_GET), + 'data' => new Collection($_POST), + 'cookies' => new Collection($_COOKIE), + 'files' => new Collection($_FILES), + 'secure' => self::getVar('HTTPS', 'off') != 'off', + 'accept' => self::getVar('HTTP_ACCEPT'), + 'proxy_ip' => self::getProxyIpAddress() + ); + } + + $this->init($config); + } + + /** + * Initialize request properties. + * + * @param array $properties Array of request properties + */ + public function init($properties = array()) { + // Set all the defined properties + foreach ($properties as $name => $value) { + $this->$name = $value; + } + + // Get the requested URL without the base directory + if ($this->base != '/' && strlen($this->base) > 0 && strpos($this->url, $this->base) === 0) { + $this->url = substr($this->url, strlen($this->base)); + } + + // Default url + if (empty($this->url)) { + $this->url = '/'; + } + // Merge URL query parameters with $_GET + else { + $_GET += self::parseQuery($this->url); + + $this->query->setData($_GET); + } + + // Check for JSON input + if (strpos($this->type, 'application/json') === 0) { + $body = $this->getBody(); + if ($body != '') { + $data = json_decode($body, true); + if ($data != null) { + $this->data->setData($data); + } + } + } + } + + /** + * Gets the body of the request. + * + * @return string Raw HTTP request body + */ + public static function getBody() { + static $body; + + if (!is_null($body)) { + return $body; + } + + $method = self::getMethod(); + + if ($method == 'POST' || $method == 'PUT' || $method == 'PATCH') { + $body = file_get_contents('php://input'); + } + + return $body; + } + + /** + * Gets the request method. + * + * @return string + */ + public static function getMethod() { + $method = self::getVar('REQUEST_METHOD', 'GET'); + + if (isset($_SERVER['HTTP_X_HTTP_METHOD_OVERRIDE'])) { + $method = $_SERVER['HTTP_X_HTTP_METHOD_OVERRIDE']; + } + elseif (isset($_REQUEST['_method'])) { + $method = $_REQUEST['_method']; + } + + return strtoupper($method); + } + + /** + * Gets the real remote IP address. + * + * @return string IP address + */ + public static function getProxyIpAddress() { + static $forwarded = array( + 'HTTP_CLIENT_IP', + 'HTTP_X_FORWARDED_FOR', + 'HTTP_X_FORWARDED', + 'HTTP_X_CLUSTER_CLIENT_IP', + 'HTTP_FORWARDED_FOR', + 'HTTP_FORWARDED' + ); + + $flags = \FILTER_FLAG_NO_PRIV_RANGE | \FILTER_FLAG_NO_RES_RANGE; + + foreach ($forwarded as $key) { + if (array_key_exists($key, $_SERVER)) { + sscanf($_SERVER[$key], '%[^,]', $ip); + if (filter_var($ip, \FILTER_VALIDATE_IP, $flags) !== false) { + return $ip; + } + } + } + + return ''; + } + + /** + * Gets a variable from $_SERVER using $default if not provided. + * + * @param string $var Variable name + * @param string $default Default value to substitute + * @return string Server variable value + */ + public static function getVar($var, $default = '') { + return isset($_SERVER[$var]) ? $_SERVER[$var] : $default; + } + + /** + * Parse query parameters from a URL. + * + * @param string $url URL string + * @return array Query parameters + */ + public static function parseQuery($url) { + $params = array(); + + $args = parse_url($url); + if (isset($args['query'])) { + parse_str($args['query'], $params); + } + + return $params; + } +} diff --git a/vendor/mikecao/flight/flight/net/Response.php b/vendor/mikecao/flight/flight/net/Response.php new file mode 100644 index 0000000..c4f6ec7 --- /dev/null +++ b/vendor/mikecao/flight/flight/net/Response.php @@ -0,0 +1,299 @@ + + * @license MIT, http://flightphp.com/license + */ + +namespace flight\net; + +/** + * The Response class represents an HTTP response. The object + * contains the response headers, HTTP status code, and response + * body. + */ +class Response { + /** + * @var int HTTP status + */ + protected $status = 200; + + /** + * @var array HTTP headers + */ + protected $headers = array(); + + /** + * @var string HTTP response body + */ + protected $body; + + /** + * @var bool HTTP response sent + */ + protected $sent = false; + + /** + * @var array HTTP status codes + */ + public static $codes = array( + 100 => 'Continue', + 101 => 'Switching Protocols', + 102 => 'Processing', + + 200 => 'OK', + 201 => 'Created', + 202 => 'Accepted', + 203 => 'Non-Authoritative Information', + 204 => 'No Content', + 205 => 'Reset Content', + 206 => 'Partial Content', + 207 => 'Multi-Status', + 208 => 'Already Reported', + + 226 => 'IM Used', + + 300 => 'Multiple Choices', + 301 => 'Moved Permanently', + 302 => 'Found', + 303 => 'See Other', + 304 => 'Not Modified', + 305 => 'Use Proxy', + 306 => '(Unused)', + 307 => 'Temporary Redirect', + 308 => 'Permanent Redirect', + + 400 => 'Bad Request', + 401 => 'Unauthorized', + 402 => 'Payment Required', + 403 => 'Forbidden', + 404 => 'Not Found', + 405 => 'Method Not Allowed', + 406 => 'Not Acceptable', + 407 => 'Proxy Authentication Required', + 408 => 'Request Timeout', + 409 => 'Conflict', + 410 => 'Gone', + 411 => 'Length Required', + 412 => 'Precondition Failed', + 413 => 'Payload Too Large', + 414 => 'URI Too Long', + 415 => 'Unsupported Media Type', + 416 => 'Range Not Satisfiable', + 417 => 'Expectation Failed', + + 422 => 'Unprocessable Entity', + 423 => 'Locked', + 424 => 'Failed Dependency', + + 426 => 'Upgrade Required', + + 428 => 'Precondition Required', + 429 => 'Too Many Requests', + + 431 => 'Request Header Fields Too Large', + + 500 => 'Internal Server Error', + 501 => 'Not Implemented', + 502 => 'Bad Gateway', + 503 => 'Service Unavailable', + 504 => 'Gateway Timeout', + 505 => 'HTTP Version Not Supported', + 506 => 'Variant Also Negotiates', + 507 => 'Insufficient Storage', + 508 => 'Loop Detected', + + 510 => 'Not Extended', + 511 => 'Network Authentication Required' + ); + + /** + * Sets the HTTP status of the response. + * + * @param int $code HTTP status code. + * @return object|int Self reference + * @throws \Exception If invalid status code + */ + public function status($code = null) { + if ($code === null) { + return $this->status; + } + + if (array_key_exists($code, self::$codes)) { + $this->status = $code; + } + else { + throw new \Exception('Invalid status code.'); + } + + return $this; + } + + /** + * Adds a header to the response. + * + * @param string|array $name Header name or array of names and values + * @param string $value Header value + * @return object Self reference + */ + public function header($name, $value = null) { + if (is_array($name)) { + foreach ($name as $k => $v) { + $this->headers[$k] = $v; + } + } + else { + $this->headers[$name] = $value; + } + + return $this; + } + + /** + * Returns the headers from the response + * @return array + */ + public function headers() { + return $this->headers; + } + + /** + * Writes content to the response body. + * + * @param string $str Response content + * @return object Self reference + */ + public function write($str) { + $this->body .= $str; + + return $this; + } + + /** + * Clears the response. + * + * @return object Self reference + */ + public function clear() { + $this->status = 200; + $this->headers = array(); + $this->body = ''; + + return $this; + } + + /** + * Sets caching headers for the response. + * + * @param int|string $expires Expiration time + * @return object Self reference + */ + public function cache($expires) { + if ($expires === false) { + $this->headers['Expires'] = 'Mon, 26 Jul 1997 05:00:00 GMT'; + $this->headers['Cache-Control'] = array( + 'no-store, no-cache, must-revalidate', + 'post-check=0, pre-check=0', + 'max-age=0' + ); + $this->headers['Pragma'] = 'no-cache'; + } + else { + $expires = is_int($expires) ? $expires : strtotime($expires); + $this->headers['Expires'] = gmdate('D, d M Y H:i:s', $expires) . ' GMT'; + $this->headers['Cache-Control'] = 'max-age='.($expires - time()); + if (isset($this->headers['Pragma']) && $this->headers['Pragma'] == 'no-cache'){ + unset($this->headers['Pragma']); + } + } + return $this; + } + + /** + * Sends HTTP headers. + * + * @return object Self reference + */ + public function sendHeaders() { + // Send status code header + if (strpos(php_sapi_name(), 'cgi') !== false) { + header( + sprintf( + 'Status: %d %s', + $this->status, + self::$codes[$this->status] + ), + true + ); + } + else { + header( + sprintf( + '%s %d %s', + (isset($_SERVER['SERVER_PROTOCOL']) ? $_SERVER['SERVER_PROTOCOL'] : 'HTTP/1.1'), + $this->status, + self::$codes[$this->status]), + true, + $this->status + ); + } + + // Send other headers + foreach ($this->headers as $field => $value) { + if (is_array($value)) { + foreach ($value as $v) { + header($field.': '.$v, false); + } + } + else { + header($field.': '.$value); + } + } + + // Send content length + $length = $this->getContentLength(); + + if ($length > 0) { + header('Content-Length: '.$length); + } + + return $this; + } + + /** + * Gets the content length. + * + * @return string Content length + */ + public function getContentLength() { + return extension_loaded('mbstring') ? + mb_strlen($this->body, 'latin1') : + strlen($this->body); + } + + /** + * Gets whether response was sent. + */ + public function sent() { + return $this->sent; + } + + /** + * Sends a HTTP response. + */ + public function send() { + if (ob_get_length() > 0) { + ob_end_clean(); + } + + if (!headers_sent()) { + $this->sendHeaders(); + } + + echo $this->body; + + $this->sent = true; + } +} + diff --git a/vendor/mikecao/flight/flight/net/Route.php b/vendor/mikecao/flight/flight/net/Route.php new file mode 100644 index 0000000..a3c4457 --- /dev/null +++ b/vendor/mikecao/flight/flight/net/Route.php @@ -0,0 +1,144 @@ + + * @license MIT, http://flightphp.com/license + */ + +namespace flight\net; + +/** + * The Route class is responsible for routing an HTTP request to + * an assigned callback function. The Router tries to match the + * requested URL against a series of URL patterns. + */ +class Route { + /** + * @var string URL pattern + */ + public $pattern; + + /** + * @var mixed Callback function + */ + public $callback; + + /** + * @var array HTTP methods + */ + public $methods = array(); + + /** + * @var array Route parameters + */ + public $params = array(); + + /** + * @var string Matching regular expression + */ + public $regex; + + /** + * @var string URL splat content + */ + public $splat = ''; + + /** + * @var boolean Pass self in callback parameters + */ + public $pass = false; + + /** + * Constructor. + * + * @param string $pattern URL pattern + * @param mixed $callback Callback function + * @param array $methods HTTP methods + * @param boolean $pass Pass self in callback parameters + */ + public function __construct($pattern, $callback, $methods, $pass) { + $this->pattern = $pattern; + $this->callback = $callback; + $this->methods = $methods; + $this->pass = $pass; + } + + /** + * Checks if a URL matches the route pattern. Also parses named parameters in the URL. + * + * @param string $url Requested URL + * @param boolean $case_sensitive Case sensitive matching + * @return boolean Match status + */ + public function matchUrl($url, $case_sensitive = false) { + // Wildcard or exact match + if ($this->pattern === '*' || $this->pattern === $url) { + return true; + } + + $ids = array(); + $last_char = substr($this->pattern, -1); + + // Get splat + if ($last_char === '*') { + $n = 0; + $len = strlen($url); + $count = substr_count($this->pattern, '/'); + + for ($i = 0; $i < $len; $i++) { + if ($url[$i] == '/') $n++; + if ($n == $count) break; + } + + $this->splat = (string)substr($url, $i+1); + } + + // Build the regex for matching + $regex = str_replace(array(')','/*'), array(')?','(/?|/.*?)'), $this->pattern); + + $regex = preg_replace_callback( + '#@([\w]+)(:([^/\(\)]*))?#', + function($matches) use (&$ids) { + $ids[$matches[1]] = null; + if (isset($matches[3])) { + return '(?P<'.$matches[1].'>'.$matches[3].')'; + } + return '(?P<'.$matches[1].'>[^/\?]+)'; + }, + $regex + ); + + // Fix trailing slash + if ($last_char === '/') { + $regex .= '?'; + } + // Allow trailing slash + else { + $regex .= '/?'; + } + + // Attempt to match route and named parameters + if (preg_match('#^'.$regex.'(?:\?.*)?$#'.(($case_sensitive) ? '' : 'i'), $url, $matches)) { + foreach ($ids as $k => $v) { + $this->params[$k] = (array_key_exists($k, $matches)) ? urldecode($matches[$k]) : null; + } + + $this->regex = $regex; + + return true; + } + + return false; + } + + /** + * Checks if an HTTP method matches the route methods. + * + * @param string $method HTTP method + * @return bool Match status + */ + public function matchMethod($method) { + return count(array_intersect(array($method, '*'), $this->methods)) > 0; + } +} diff --git a/vendor/mikecao/flight/flight/net/Router.php b/vendor/mikecao/flight/flight/net/Router.php new file mode 100644 index 0000000..6a2f73b --- /dev/null +++ b/vendor/mikecao/flight/flight/net/Router.php @@ -0,0 +1,116 @@ + + * @license MIT, http://flightphp.com/license + */ + +namespace flight\net; + +/** + * The Router class is responsible for routing an HTTP request to + * an assigned callback function. The Router tries to match the + * requested URL against a series of URL patterns. + */ +class Router { + /** + * Mapped routes. + * + * @var array + */ + protected $routes = array(); + + /** + * Pointer to current route. + * + * @var int + */ + protected $index = 0; + + /** + * Case sensitive matching. + * + * @var boolean + */ + public $case_sensitive = false; + + /** + * Gets mapped routes. + * + * @return array Array of routes + */ + public function getRoutes() { + return $this->routes; + } + + /** + * Clears all routes in the router. + */ + public function clear() { + $this->routes = array(); + } + + /** + * Maps a URL pattern to a callback function. + * + * @param string $pattern URL pattern to match + * @param callback $callback Callback function + * @param boolean $pass_route Pass the matching route object to the callback + */ + public function map($pattern, $callback, $pass_route = false) { + $url = $pattern; + $methods = array('*'); + + if (strpos($pattern, ' ') !== false) { + list($method, $url) = explode(' ', trim($pattern), 2); + + $methods = explode('|', $method); + } + + $this->routes[] = new Route($url, $callback, $methods, $pass_route); + } + + /** + * Routes the current request. + * + * @param Request $request Request object + * @return Route|bool Matching route or false if no match + */ + public function route(Request $request) { + while ($route = $this->current()) { + if ($route !== false && $route->matchMethod($request->method) && $route->matchUrl($request->url, $this->case_sensitive)) { + return $route; + } + $this->next(); + } + + return false; + } + + /** + * Gets the current route. + * + * @return Route + */ + public function current() { + return isset($this->routes[$this->index]) ? $this->routes[$this->index] : false; + } + + /** + * Gets the next route. + * + * @return Route + */ + public function next() { + $this->index++; + } + + /** + * Reset to the first route. + */ + public function reset() { + $this->index = 0; + } +} + diff --git a/vendor/mikecao/flight/flight/template/View.php b/vendor/mikecao/flight/flight/template/View.php new file mode 100644 index 0000000..a0bc3c3 --- /dev/null +++ b/vendor/mikecao/flight/flight/template/View.php @@ -0,0 +1,184 @@ + + * @license MIT, http://flightphp.com/license + */ + +namespace flight\template; + +/** + * The View class represents output to be displayed. It provides + * methods for managing view data and inserts the data into + * view templates upon rendering. + */ +class View { + /** + * Location of view templates. + * + * @var string + */ + public $path; + + /** + * File extension. + * + * @var string + */ + public $extension = '.php'; + + /** + * View variables. + * + * @var array + */ + protected $vars = array(); + + /** + * Template file. + * + * @var string + */ + private $template; + + /** + * Constructor. + * + * @param string $path Path to templates directory + */ + public function __construct($path = '.') { + $this->path = $path; + } + + /** + * Gets a template variable. + * + * @param string $key Key + * @return mixed Value + */ + public function get($key) { + return isset($this->vars[$key]) ? $this->vars[$key] : null; + } + + /** + * Sets a template variable. + * + * @param mixed $key Key + * @param string $value Value + */ + public function set($key, $value = null) { + if (is_array($key) || is_object($key)) { + foreach ($key as $k => $v) { + $this->vars[$k] = $v; + } + } + else { + $this->vars[$key] = $value; + } + } + + /** + * Checks if a template variable is set. + * + * @param string $key Key + * @return boolean If key exists + */ + public function has($key) { + return isset($this->vars[$key]); + } + + /** + * Unsets a template variable. If no key is passed in, clear all variables. + * + * @param string $key Key + */ + public function clear($key = null) { + if (is_null($key)) { + $this->vars = array(); + } + else { + unset($this->vars[$key]); + } + } + + /** + * Renders a template. + * + * @param string $file Template file + * @param array $data Template data + * @throws \Exception If template not found + */ + public function render($file, $data = null) { + $this->template = $this->getTemplate($file); + + if (!file_exists($this->template)) { + throw new \Exception("Template file not found: {$this->template}."); + } + + if (is_array($data)) { + $this->vars = array_merge($this->vars, $data); + } + + extract($this->vars); + + include $this->template; + } + + /** + * Gets the output of a template. + * + * @param string $file Template file + * @param array $data Template data + * @return string Output of template + */ + public function fetch($file, $data = null) { + ob_start(); + + $this->render($file, $data); + $output = ob_get_clean(); + + return $output; + } + + /** + * Checks if a template file exists. + * + * @param string $file Template file + * @return bool Template file exists + */ + public function exists($file) { + return file_exists($this->getTemplate($file)); + } + + /** + * Gets the full path to a template file. + * + * @param string $file Template file + * @return string Template file location + */ + public function getTemplate($file) { + $ext = $this->extension; + + if (!empty($ext) && (substr($file, -1 * strlen($ext)) != $ext)) { + $file .= $ext; + } + + if ((substr($file, 0, 1) == '/')) { + return $file; + } + + return $this->path.'/'.$file; + } + + /** + * Displays escaped output. + * + * @param string $str String to escape + * @return string Escaped string + */ + public function e($str) { + echo htmlentities($str); + } +} + diff --git a/vendor/mikecao/flight/flight/util/Collection.php b/vendor/mikecao/flight/flight/util/Collection.php new file mode 100644 index 0000000..196ea66 --- /dev/null +++ b/vendor/mikecao/flight/flight/util/Collection.php @@ -0,0 +1,203 @@ + + * @license MIT, http://flightphp.com/license + */ + +namespace flight\util; + +/** + * The Collection class allows you to access a set of data + * using both array and object notation. + */ +class Collection implements \ArrayAccess, \Iterator, \Countable { + /** + * Collection data. + * + * @var array + */ + private $data; + + /** + * Constructor. + * + * @param array $data Initial data + */ + public function __construct(array $data = array()) { + $this->data = $data; + } + + /** + * Gets an item. + * + * @param string $key Key + * @return mixed Value + */ + public function __get($key) { + return isset($this->data[$key]) ? $this->data[$key] : null; + } + + /** + * Set an item. + * + * @param string $key Key + * @param mixed $value Value + */ + public function __set($key, $value) { + $this->data[$key] = $value; + } + + /** + * Checks if an item exists. + * + * @param string $key Key + * @return bool Item status + */ + public function __isset($key) { + return isset($this->data[$key]); + } + + /** + * Removes an item. + * + * @param string $key Key + */ + public function __unset($key) { + unset($this->data[$key]); + } + + /** + * Gets an item at the offset. + * + * @param string $offset Offset + * @return mixed Value + */ + public function offsetGet($offset) { + return isset($this->data[$offset]) ? $this->data[$offset] : null; + } + + /** + * Sets an item at the offset. + * + * @param string $offset Offset + * @param mixed $value Value + */ + public function offsetSet($offset, $value) { + if (is_null($offset)) { + $this->data[] = $value; + } + else { + $this->data[$offset] = $value; + } + } + + /** + * Checks if an item exists at the offset. + * + * @param string $offset Offset + * @return bool Item status + */ + public function offsetExists($offset) { + return isset($this->data[$offset]); + } + + /** + * Removes an item at the offset. + * + * @param string $offset Offset + */ + public function offsetUnset($offset) { + unset($this->data[$offset]); + } + + /** + * Resets the collection. + */ + public function rewind() { + reset($this->data); + } + + /** + * Gets current collection item. + * + * @return mixed Value + */ + public function current() { + return current($this->data); + } + + /** + * Gets current collection key. + * + * @return mixed Value + */ + public function key() { + return key($this->data); + } + + /** + * Gets the next collection value. + * + * @return mixed Value + */ + public function next() + { + return next($this->data); + } + + /** + * Checks if the current collection key is valid. + * + * @return bool Key status + */ + public function valid() + { + $key = key($this->data); + return ($key !== NULL && $key !== FALSE); + } + + /** + * Gets the size of the collection. + * + * @return int Collection size + */ + public function count() { + return sizeof($this->data); + } + + /** + * Gets the item keys. + * + * @return array Collection keys + */ + public function keys() { + return array_keys($this->data); + } + + /** + * Gets the collection data. + * + * @return array Collection data + */ + public function getData() { + return $this->data; + } + + /** + * Sets the collection data. + * + * @param array $data New collection data + */ + public function setData(array $data) { + $this->data = $data; + } + + /** + * Removes all items from the collection. + */ + public function clear() { + $this->data = array(); + } +} diff --git a/vendor/mikecao/flight/index.php b/vendor/mikecao/flight/index.php new file mode 100644 index 0000000..b774464 --- /dev/null +++ b/vendor/mikecao/flight/index.php @@ -0,0 +1,8 @@ + + * @license MIT, http://flightphp.com/license + */ + +require_once 'vendor/autoload.php'; +require_once __DIR__.'/../flight/autoload.php'; + +class AutoloadTest extends PHPUnit_Framework_TestCase +{ + /** + * @var \flight\Engine + */ + private $app; + + function setUp() { + $this->app = new \flight\Engine(); + $this->app->path(__DIR__.'/classes'); + } + + // Autoload a class + function testAutoload(){ + $this->app->register('user', 'User'); + + $loaders = spl_autoload_functions(); + + $user = $this->app->user(); + + $this->assertTrue(sizeof($loaders) > 0); + $this->assertTrue(is_object($user)); + $this->assertEquals('User', get_class($user)); + } + + // Check autoload failure + function testMissingClass(){ + $test = null; + $this->app->register('test', 'NonExistentClass'); + + if (class_exists('NonExistentClass')) { + $test = $this->app->test(); + } + + $this->assertEquals(null, $test); + } +} diff --git a/vendor/mikecao/flight/tests/DispatcherTest.php b/vendor/mikecao/flight/tests/DispatcherTest.php new file mode 100644 index 0000000..a29bd20 --- /dev/null +++ b/vendor/mikecao/flight/tests/DispatcherTest.php @@ -0,0 +1,92 @@ + + * @license MIT, http://flightphp.com/license + */ + +require_once 'vendor/autoload.php'; +require_once __DIR__.'/classes/Hello.php'; + +class DispatcherTest extends PHPUnit_Framework_TestCase +{ + /** + * @var \flight\core\Dispatcher + */ + private $dispatcher; + + function setUp(){ + $this->dispatcher = new \flight\core\Dispatcher(); + } + + // Map a closure + function testClosureMapping(){ + $this->dispatcher->set('map1', function(){ + return 'hello'; + }); + + $result = $this->dispatcher->run('map1'); + + $this->assertEquals('hello', $result); + } + + // Map a function + function testFunctionMapping(){ + $this->dispatcher->set('map2', function(){ + return 'hello'; + }); + + $result = $this->dispatcher->run('map2'); + + $this->assertEquals('hello', $result); + } + + // Map a class method + function testClassMethodMapping(){ + $h = new Hello(); + + $this->dispatcher->set('map3', array($h, 'sayHi')); + + $result = $this->dispatcher->run('map3'); + + $this->assertEquals('hello', $result); + } + + // Map a static class method + function testStaticClassMethodMapping(){ + $this->dispatcher->set('map4', array('Hello', 'sayBye')); + + $result = $this->dispatcher->run('map4'); + + $this->assertEquals('goodbye', $result); + } + + // Run before and after filters + function testBeforeAndAfter() { + $this->dispatcher->set('hello', function($name){ + return "Hello, $name!"; + }); + + $this->dispatcher->hook('hello', 'before', function(&$params, &$output){ + // Manipulate the parameter + $params[0] = 'Fred'; + }); + + $this->dispatcher->hook('hello', 'after', function(&$params, &$output){ + // Manipulate the output + $output .= " Have a nice day!"; + }); + + $result = $this->dispatcher->run('hello', array('Bob')); + + $this->assertEquals('Hello, Fred! Have a nice day!', $result); + } + + // Test an invalid callback + function testInvalidCallback() { + $this->setExpectedException('Exception', 'Invalid callback specified.'); + + $this->dispatcher->execute(array('NonExistentClass', 'nonExistentMethod')); + } +} diff --git a/vendor/mikecao/flight/tests/FilterTest.php b/vendor/mikecao/flight/tests/FilterTest.php new file mode 100644 index 0000000..6fef654 --- /dev/null +++ b/vendor/mikecao/flight/tests/FilterTest.php @@ -0,0 +1,65 @@ + + * @license MIT, http://flightphp.com/license + */ + +require_once 'vendor/autoload.php'; +require_once __DIR__.'/../flight/autoload.php'; + +class FilterTest extends PHPUnit_Framework_TestCase +{ + /** + * @var \flight\Engine + */ + private $app; + + function setUp() { + $this->app = new \flight\Engine(); + } + + // Run before and after filters + function testBeforeAndAfter() { + $this->app->map('hello', function($name){ + return "Hello, $name!"; + }); + + $this->app->before('hello', function(&$params, &$output){ + // Manipulate the parameter + $params[0] = 'Fred'; + }); + + $this->app->after('hello', function(&$params, &$output){ + // Manipulate the output + $output .= " Have a nice day!"; + }); + + $result = $this->app->hello('Bob'); + + $this->assertEquals('Hello, Fred! Have a nice day!', $result); + } + + // Break out of a filter chain by returning false + function testFilterChaining() { + $this->app->map('bye', function($name){ + return "Bye, $name!"; + }); + + $this->app->before('bye', function(&$params, &$output){ + $params[0] = 'Bob'; + }); + $this->app->before('bye', function(&$params, &$output){ + $params[0] = 'Fred'; + return false; + }); + $this->app->before('bye', function(&$params, &$output){ + $params[0] = 'Ted'; + }); + + $result = $this->app->bye('Joe'); + + $this->assertEquals('Bye, Fred!', $result); + } +} diff --git a/vendor/mikecao/flight/tests/FlightTest.php b/vendor/mikecao/flight/tests/FlightTest.php new file mode 100644 index 0000000..2a778c5 --- /dev/null +++ b/vendor/mikecao/flight/tests/FlightTest.php @@ -0,0 +1,83 @@ + + * @license MIT, http://flightphp.com/license + */ + +require_once 'vendor/autoload.php'; +require_once __DIR__.'/../flight/Flight.php'; + +class FlightTest extends PHPUnit_Framework_TestCase +{ + function setUp() { + Flight::init(); + } + + // Checks that default components are loaded + function testDefaultComponents(){ + $request = Flight::request(); + $response = Flight::response(); + $router = Flight::router(); + $view = Flight::view(); + + $this->assertEquals('flight\net\Request', get_class($request)); + $this->assertEquals('flight\net\Response', get_class($response)); + $this->assertEquals('flight\net\Router', get_class($router)); + $this->assertEquals('flight\template\View', get_class($view)); + } + + // Test get/set of variables + function testGetAndSet(){ + Flight::set('a', 1); + $var = Flight::get('a'); + + $this->assertEquals(1, $var); + + Flight::clear(); + $vars = Flight::get(); + + $this->assertEquals(0, count($vars)); + + Flight::set('a', 1); + Flight::set('b', 2); + $vars = Flight::get(); + + $this->assertEquals(2, count($vars)); + $this->assertEquals(1, $vars['a']); + $this->assertEquals(2, $vars['b']); + } + + // Register a class + function testRegister(){ + Flight::path(__DIR__.'/classes'); + + Flight::register('user', 'User'); + $user = Flight::user(); + + $loaders = spl_autoload_functions(); + + $this->assertTrue(sizeof($loaders) > 0); + $this->assertTrue(is_object($user)); + $this->assertEquals('User', get_class($user)); + } + + // Map a function + function testMap(){ + Flight::map('map1', function(){ + return 'hello'; + }); + + $result = Flight::map1(); + + $this->assertEquals('hello', $result); + } + + // Unmapped method + function testUnmapped() { + $this->setExpectedException('Exception', 'doesNotExist must be a mapped method.'); + + Flight::doesNotExist(); + } +} diff --git a/vendor/mikecao/flight/tests/LoaderTest.php b/vendor/mikecao/flight/tests/LoaderTest.php new file mode 100644 index 0000000..98de2bd --- /dev/null +++ b/vendor/mikecao/flight/tests/LoaderTest.php @@ -0,0 +1,114 @@ + + * @license MIT, http://flightphp.com/license + */ + +require_once 'vendor/autoload.php'; +require_once __DIR__.'/classes/User.php'; +require_once __DIR__.'/classes/Factory.php'; + +class LoaderTest extends PHPUnit_Framework_TestCase +{ + /** + * @var \flight\core\Loader + */ + private $loader; + + function setUp(){ + $this->loader = new \flight\core\Loader(); + $this->loader->autoload(true, __DIR__.'/classes'); + } + + // Autoload a class + function testAutoload(){ + $this->loader->register('tests', 'User'); + + $test = $this->loader->load('tests'); + + $this->assertTrue(is_object($test)); + $this->assertEquals('User', get_class($test)); + } + + // Register a class + function testRegister(){ + $this->loader->register('a', 'User'); + + $user = $this->loader->load('a'); + + $this->assertTrue(is_object($user)); + $this->assertEquals('User', get_class($user)); + $this->assertEquals('', $user->name); + } + + // Register a class with constructor parameters + function testRegisterWithConstructor(){ + $this->loader->register('b', 'User', array('Bob')); + + $user = $this->loader->load('b'); + + $this->assertTrue(is_object($user)); + $this->assertEquals('User', get_class($user)); + $this->assertEquals('Bob', $user->name); + } + + // Register a class with initialization + function testRegisterWithInitialization(){ + $this->loader->register('c', 'User', array('Bob'), function($user){ + $user->name = 'Fred'; + }); + + $user = $this->loader->load('c'); + + $this->assertTrue(is_object($user)); + $this->assertEquals('User', get_class($user)); + $this->assertEquals('Fred', $user->name); + } + + // Get a non-shared instance of a class + function testSharedInstance() { + $this->loader->register('d', 'User'); + + $user1 = $this->loader->load('d'); + $user2 = $this->loader->load('d'); + $user3 = $this->loader->load('d', false); + + $this->assertTrue($user1 === $user2); + $this->assertTrue($user1 !== $user3); + } + + // Gets an object from a factory method + function testRegisterUsingCallable(){ + $this->loader->register('e', array('Factory','create')); + + $obj = $this->loader->load('e'); + + $this->assertTrue(is_object($obj)); + $this->assertEquals('Factory', get_class($obj)); + + $obj2 = $this->loader->load('e'); + + $this->assertTrue(is_object($obj2)); + $this->assertEquals('Factory', get_class($obj2)); + $this->assertTrue($obj === $obj2); + + $obj3 = $this->loader->load('e', false); + $this->assertTrue(is_object($obj3)); + $this->assertEquals('Factory', get_class($obj3)); + $this->assertTrue($obj !== $obj3); + } + + // Gets an object from a callback function + function testRegisterUsingCallback(){ + $this->loader->register('f', function(){ + return Factory::create(); + }); + + $obj = $this->loader->load('f'); + + $this->assertTrue(is_object($obj)); + $this->assertEquals('Factory', get_class($obj)); + } +} diff --git a/vendor/mikecao/flight/tests/MapTest.php b/vendor/mikecao/flight/tests/MapTest.php new file mode 100644 index 0000000..8a6ea8b --- /dev/null +++ b/vendor/mikecao/flight/tests/MapTest.php @@ -0,0 +1,72 @@ + + * @license MIT, http://flightphp.com/license + */ + +require_once 'vendor/autoload.php'; +require_once __DIR__.'/../flight/autoload.php'; +require_once __DIR__.'/classes/Hello.php'; + +class MapTest extends PHPUnit_Framework_TestCase +{ + /** + * @var \flight\Engine + */ + private $app; + + function setUp() { + $this->app = new \flight\Engine(); + } + + // Map a closure + function testClosureMapping(){ + $this->app->map('map1', function(){ + return 'hello'; + }); + + $result = $this->app->map1(); + + $this->assertEquals('hello', $result); + } + + // Map a function + function testFunctionMapping(){ + $this->app->map('map2', function(){ + return 'hello'; + }); + + $result = $this->app->map2(); + + $this->assertEquals('hello', $result); + } + + // Map a class method + function testClassMethodMapping(){ + $h = new Hello(); + + $this->app->map('map3', array($h, 'sayHi')); + + $result = $this->app->map3(); + + $this->assertEquals('hello', $result); + } + + // Map a static class method + function testStaticClassMethodMapping(){ + $this->app->map('map4', array('Hello', 'sayBye')); + + $result = $this->app->map4(); + + $this->assertEquals('goodbye', $result); + } + + // Unmapped method + function testUnmapped() { + $this->setExpectedException('Exception', 'doesNotExist must be a mapped method.'); + + $this->app->doesNotExist(); + } +} diff --git a/vendor/mikecao/flight/tests/README.md b/vendor/mikecao/flight/tests/README.md new file mode 100644 index 0000000..35efc20 --- /dev/null +++ b/vendor/mikecao/flight/tests/README.md @@ -0,0 +1,10 @@ +## Flight Tests + +This directory contains unit tests for Flight. The tests were written for PHPUnit 3.7.10 + +To run the tests do: + + composer install + vendor/bin/phpunit tests + +Learn more about PHPUnit at [http://www.phpunit.de](http://www.phpunit.de/manual/current/en/index.html) diff --git a/vendor/mikecao/flight/tests/RedirectTest.php b/vendor/mikecao/flight/tests/RedirectTest.php new file mode 100644 index 0000000..9a5dae1 --- /dev/null +++ b/vendor/mikecao/flight/tests/RedirectTest.php @@ -0,0 +1,77 @@ + + * @license MIT, http://flightphp.com/license + */ + +require_once 'vendor/autoload.php'; +require_once __DIR__.'/../flight/autoload.php'; + +class RedirectTest extends PHPUnit_Framework_TestCase +{ + /** + * @var \flight\Engine + */ + private $app; + + function getBaseUrl($base, $url){ + if ($base != '/' && strpos($url, '://') === false) { + $url = preg_replace('#/+#', '/', $base.'/'.$url); + } + + return $url; + } + + function setUp() { + $_SERVER['SCRIPT_NAME'] = '/subdir/index.php'; + + $this->app = new \flight\Engine(); + $this->app->set('flight.base_url', '/testdir'); + } + + // The base should be the subdirectory + function testBase(){ + $base = $this->app->request()->base; + + $this->assertEquals('/subdir', $base); + } + + // Absolute URLs should include the base + function testAbsoluteUrl(){ + $url = '/login'; + $base = $this->app->request()->base; + + $this->assertEquals('/subdir/login', $this->getBaseUrl($base, $url)); + } + + // Relative URLs should include the base + function testRelativeUrl(){ + $url = 'login'; + $base = $this->app->request()->base; + + $this->assertEquals('/subdir/login', $this->getBaseUrl($base, $url)); + } + + // External URLs should ignore the base + function testHttpUrl(){ + $url = 'http://www.yahoo.com'; + $base = $this->app->request()->base; + + $this->assertEquals('http://www.yahoo.com', $this->getBaseUrl($base, $url)); + } + + // Configuration should override derived value + function testBaseOverride(){ + $url = 'login'; + if ($this->app->get('flight.base_url') !== null) { + $base = $this->app->get('flight.base_url'); + } + else { + $base = $this->app->request()->base; + } + + $this->assertEquals('/testdir/login', $this->getBaseUrl($base, $url)); + } +} diff --git a/vendor/mikecao/flight/tests/RegisterTest.php b/vendor/mikecao/flight/tests/RegisterTest.php new file mode 100644 index 0000000..37ec2b6 --- /dev/null +++ b/vendor/mikecao/flight/tests/RegisterTest.php @@ -0,0 +1,87 @@ + + * @license MIT, http://flightphp.com/license + */ + +require_once 'vendor/autoload.php'; +require_once __DIR__.'/../flight/autoload.php'; +require_once __DIR__.'/classes/User.php'; + +class RegisterTest extends PHPUnit_Framework_TestCase +{ + /** + * @var \flight\Engine + */ + private $app; + + function setUp() { + $this->app = new \flight\Engine(); + } + + // Register a class + function testRegister(){ + $this->app->register('reg1', 'User'); + + $user = $this->app->reg1(); + + $this->assertTrue(is_object($user)); + $this->assertEquals('User', get_class($user)); + $this->assertEquals('', $user->name); + } + + // Register a class with constructor parameters + function testRegisterWithConstructor(){ + $this->app->register('reg2', 'User', array('Bob')); + + $user = $this->app->reg2(); + + $this->assertTrue(is_object($user)); + $this->assertEquals('User', get_class($user)); + $this->assertEquals('Bob', $user->name); + } + + // Register a class with initialization + function testRegisterWithInitialization(){ + $this->app->register('reg3', 'User', array('Bob'), function($user){ + $user->name = 'Fred'; + }); + + $user = $this->app->reg3(); + + $this->assertTrue(is_object($user)); + $this->assertEquals('User', get_class($user)); + $this->assertEquals('Fred', $user->name); + } + + // Get a non-shared instance of a class + function testSharedInstance() { + $this->app->register('reg4', 'User'); + + $user1 = $this->app->reg4(); + $user2 = $this->app->reg4(); + $user3 = $this->app->reg4(false); + + $this->assertTrue($user1 === $user2); + $this->assertTrue($user1 !== $user3); + } + + // Map method takes precedence over register + function testMapOverridesRegister(){ + $this->app->register('reg5', 'User'); + + $user = $this->app->reg5(); + + $this->assertTrue(is_object($user)); + + $this->app->map('reg5', function(){ + return 123; + }); + + $user = $this->app->reg5(); + + $this->assertEquals(123, $user); + } +} diff --git a/vendor/mikecao/flight/tests/RenderTest.php b/vendor/mikecao/flight/tests/RenderTest.php new file mode 100644 index 0000000..7d20d1e --- /dev/null +++ b/vendor/mikecao/flight/tests/RenderTest.php @@ -0,0 +1,38 @@ + + * @license MIT, http://flightphp.com/license + */ + +require_once 'vendor/autoload.php'; +require_once __DIR__.'/../flight/Flight.php'; + +class RenderTest extends PHPUnit_Framework_TestCase +{ + /** + * @var \flight\Engine + */ + private $app; + + function setUp() { + $this->app = new \flight\Engine(); + $this->app->set('flight.views.path', __DIR__.'/views'); + } + + // Render a view + function testRenderView(){ + $this->app->render('hello', array('name' => 'Bob')); + + $this->expectOutputString('Hello, Bob!'); + } + + // Renders a view into a layout + function testRenderLayout(){ + $this->app->render('hello', array('name' => 'Bob'), 'content'); + $this->app->render('layouts/layout'); + + $this->expectOutputString('Hello, Bob!'); + } +} diff --git a/vendor/mikecao/flight/tests/RequestTest.php b/vendor/mikecao/flight/tests/RequestTest.php new file mode 100644 index 0000000..1c6d144 --- /dev/null +++ b/vendor/mikecao/flight/tests/RequestTest.php @@ -0,0 +1,99 @@ + + * @license MIT, http://flightphp.com/license + */ + +require_once 'vendor/autoload.php'; +require_once __DIR__.'/../flight/autoload.php'; + +class RequestTest extends PHPUnit_Framework_TestCase +{ + /** + * @var \flight\net\Request + */ + private $request; + + function setUp() { + $_SERVER['REQUEST_URI'] = '/'; + $_SERVER['SCRIPT_NAME'] = '/index.php'; + $_SERVER['REQUEST_METHOD'] = 'GET'; + $_SERVER['HTTP_X_REQUESTED_WITH'] = 'XMLHttpRequest'; + $_SERVER['REMOTE_ADDR'] = '8.8.8.8'; + $_SERVER['HTTPS'] = 'on'; + $_SERVER['HTTP_X_FORWARDED_FOR'] = '32.32.32.32'; + + $this->request = new \flight\net\Request(); + } + + function testDefaults() { + $this->assertEquals('/', $this->request->url); + $this->assertEquals('/', $this->request->base); + $this->assertEquals('GET', $this->request->method); + $this->assertEquals('', $this->request->referrer); + $this->assertEquals(true, $this->request->ajax); + $this->assertEquals('HTTP/1.1', $this->request->scheme); + $this->assertEquals('', $this->request->type); + $this->assertEquals(0, $this->request->length); + $this->assertEquals(true, $this->request->secure); + $this->assertEquals('', $this->request->accept); + } + + function testIpAddress() { + $this->assertEquals('8.8.8.8', $this->request->ip); + $this->assertEquals('32.32.32.32', $this->request->proxy_ip); + } + + function testSubdirectory() { + $_SERVER['SCRIPT_NAME'] = '/subdir/index.php'; + + $request = new \flight\net\Request(); + + $this->assertEquals('/subdir', $request->base); + } + + function testQueryParameters() { + $_SERVER['REQUEST_URI'] = '/page?id=1&name=bob'; + + $request = new \flight\net\Request(); + + $this->assertEquals('/page?id=1&name=bob', $request->url); + $this->assertEquals(1, $request->query->id); + $this->assertEquals('bob', $request->query->name); + } + + function testCollections() { + $_SERVER['REQUEST_URI'] = '/page?id=1'; + + $_GET['q'] = 1; + $_POST['q'] = 1; + $_COOKIE['q'] = 1; + $_FILES['q'] = 1; + + $request = new \flight\net\Request(); + + $this->assertEquals(1, $request->query->q); + $this->assertEquals(1, $request->query->id); + $this->assertEquals(1, $request->data->q); + $this->assertEquals(1, $request->cookies->q); + $this->assertEquals(1, $request->files->q); + } + + function testMethodOverrideWithHeader() { + $_SERVER['HTTP_X_HTTP_METHOD_OVERRIDE'] = 'PUT'; + + $request = new \flight\net\Request(); + + $this->assertEquals('PUT', $request->method); + } + + function testMethodOverrideWithPost() { + $_REQUEST['_method'] = 'PUT'; + + $request = new \flight\net\Request(); + + $this->assertEquals('PUT', $request->method); + } +} diff --git a/vendor/mikecao/flight/tests/RouterTest.php b/vendor/mikecao/flight/tests/RouterTest.php new file mode 100644 index 0000000..3f38aa1 --- /dev/null +++ b/vendor/mikecao/flight/tests/RouterTest.php @@ -0,0 +1,266 @@ + + * @license MIT, http://flightphp.com/license + */ + +require_once 'vendor/autoload.php'; +require_once __DIR__.'/../flight/autoload.php'; + +class RouterTest extends PHPUnit_Framework_TestCase +{ + /** + * @var \flight\net\Router + */ + private $router; + + /** + * @var \flight\net\Request + */ + private $request; + + /** + * @var \flight\core\Dispatcher + */ + private $dispatcher; + + function setUp(){ + $this->router = new \flight\net\Router(); + $this->request = new \flight\net\Request(); + $this->dispatcher = new \flight\core\Dispatcher(); + } + + // Simple output + function ok(){ + echo 'OK'; + } + + // Checks if a route was matched with a given output + function check($str = '') { + /* + $route = $this->router->route($this->request); + + $params = array_values($route->params); + + $this->assertTrue(is_callable($route->callback)); + + call_user_func_array($route->callback, $params); + */ + + $this->routeRequest(); + $this->expectOutputString($str); + } + + function routeRequest() { + $dispatched = false; + + while ($route = $this->router->route($this->request)) { + $params = array_values($route->params); + + if ($route->pass) { + $params[] = $route; + } + + $continue = $this->dispatcher->execute( + $route->callback, + $params + ); + + $dispatched = true; + + if (!$continue) break; + + $this->router->next(); + + $dispatched = false; + } + + if (!$dispatched) { + echo '404'; + } + } + + // Default route + function testDefaultRoute(){ + $this->router->map('/', array($this, 'ok')); + $this->request->url = '/'; + + $this->check('OK'); + } + + // Simple path + function testPathRoute(){ + $this->router->map('/path', array($this, 'ok')); + $this->request->url = '/path'; + + $this->check('OK'); + } + + // POST route + function testPostRoute(){ + $this->router->map('POST /', array($this, 'ok')); + $this->request->url = '/'; + $this->request->method = 'POST'; + + $this->check('OK'); + } + + // Either GET or POST route + function testGetPostRoute(){ + $this->router->map('GET|POST /', array($this, 'ok')); + $this->request->url = '/'; + $this->request->method = 'GET'; + + $this->check('OK'); + } + + // Test regular expression matching + function testRegEx(){ + $this->router->map('/num/[0-9]+', array($this, 'ok')); + $this->request->url = '/num/1234'; + + $this->check('OK'); + } + + // Passing URL parameters + function testUrlParameters(){ + $this->router->map('/user/@id', function($id){ + echo $id; + }); + $this->request->url = '/user/123'; + + $this->check('123'); + } + + // Passing URL parameters matched with regular expression + function testRegExParameters(){ + $this->router->map('/test/@name:[a-z]+', function($name){ + echo $name; + }); + $this->request->url = '/test/abc'; + + $this->check('abc'); + } + + // Optional parameters + function testOptionalParameters(){ + $this->router->map('/blog(/@year(/@month(/@day)))', function($year, $month, $day){ + echo "$year,$month,$day"; + }); + $this->request->url = '/blog/2000'; + + $this->check('2000,,'); + } + + // Regex in optional parameters + function testRegexOptionalParameters(){ + $this->router->map('/@controller/@method(/@id:[0-9]+)', function($controller, $method, $id){ + echo "$controller,$method,$id"; + }); + $this->request->url = '/user/delete/123'; + + $this->check('user,delete,123'); + } + + // Regex in optional parameters + function testRegexEmptyOptionalParameters(){ + $this->router->map('/@controller/@method(/@id:[0-9]+)', function($controller, $method, $id){ + echo "$controller,$method,$id"; + }); + $this->request->url = '/user/delete/'; + + $this->check('user,delete,'); + } + + // Wildcard matching + function testWildcard(){ + $this->router->map('/account/*', array($this, 'ok')); + $this->request->url = '/account/123/abc/xyz'; + + $this->check('OK'); + } + + // Check if route object was passed + function testRouteObjectPassing(){ + $this->router->map('/yes_route', function($route){ + $this->assertTrue(is_object($route)); + $this->assertTrue(is_array($route->methods)); + $this->assertTrue(is_array($route->params)); + $this->assertEquals(sizeof($route->params), 0); + $this->assertEquals($route->regex, null); + $this->assertEquals($route->splat, ''); + $this->assertTrue($route->pass); + }, true); + $this->request->url = '/yes_route'; + + $this->check(); + + $this->router->map('/no_route', function($route = null){ + $this->assertTrue(is_null($route)); + }, false); + $this->request->url = '/no_route'; + + $this->check(); + } + + function testRouteWithParameters() { + $this->router->map('/@one/@two', function($one, $two, $route){ + $this->assertEquals(sizeof($route->params), 2); + $this->assertEquals($route->params['one'], $one); + $this->assertEquals($route->params['two'], $two); + }, true); + $this->request->url = '/1/2'; + + $this->check(); + } + + // Test splat + function testSplatWildcard(){ + $this->router->map('/account/*', function($route){ + echo $route->splat; + }, true); + $this->request->url = '/account/456/def/xyz'; + + $this->check('456/def/xyz'); + } + + // Test splat without trailing slash + function testSplatWildcardTrailingSlash(){ + $this->router->map('/account/*', function($route){ + echo $route->splat; + }, true); + $this->request->url = '/account'; + + $this->check(); + } + + // Test splat with named parameters + function testSplatNamedPlusWildcard(){ + $this->router->map('/account/@name/*', function($name, $route){ + echo $route->splat; + $this->assertEquals('abc', $name); + }, true); + $this->request->url = '/account/abc/456/def/xyz'; + + $this->check('456/def/xyz'); + } + + // Test not found + function testNotFound() { + $this->router->map('/does_exist', array($this, 'ok')); + $this->request->url = '/does_not_exist'; + + $this->check('404'); + } + + // Test case sensitivity + function testCaseSensitivity() { + $this->router->map('/hello', array($this, 'ok')); + $this->request->url = '/HELLO'; + $this->router->case_sensitive = true; + + $this->check('404'); + } +} diff --git a/vendor/mikecao/flight/tests/VariableTest.php b/vendor/mikecao/flight/tests/VariableTest.php new file mode 100644 index 0000000..8c2fc0c --- /dev/null +++ b/vendor/mikecao/flight/tests/VariableTest.php @@ -0,0 +1,50 @@ + + * @license MIT, http://flightphp.com/license + */ + +require_once 'vendor/autoload.php'; +require_once __DIR__.'/../flight/autoload.php'; + +class VariableTest extends PHPUnit_Framework_TestCase +{ + /** + * @var \flight\Engine + */ + private $app; + + function setUp() { + $this->app = new \flight\Engine(); + } + // Set and get a variable + function testSetAndGet() { + $this->app->set('a', 1); + $var = $this->app->get('a'); + $this->assertEquals(1, $var); + } + + // Clear a specific variable + function testClear() { + $this->app->set('b', 1); + $this->app->clear('b'); + $var = $this->app->get('b'); + $this->assertEquals(null, $var); + } + + // Clear all variables + function testClearAll() { + $this->app->set('c', 1); + $this->app->clear(); + $var = $this->app->get('c'); + $this->assertEquals(null, $var); + } + + // Check if a variable exists + function testHas() { + $this->app->set('d', 1); + $this->assertTrue($this->app->has('d')); + } +} diff --git a/vendor/mikecao/flight/tests/ViewTest.php b/vendor/mikecao/flight/tests/ViewTest.php new file mode 100644 index 0000000..82572d4 --- /dev/null +++ b/vendor/mikecao/flight/tests/ViewTest.php @@ -0,0 +1,76 @@ + + * @license MIT, http://flightphp.com/license + */ + +require_once 'vendor/autoload.php'; +require_once __DIR__.'/../flight/autoload.php'; + +class ViewTest extends PHPUnit_Framework_TestCase +{ + /** + * @var \flight\template\View + */ + private $view; + + function setUp() { + $this->view = new \flight\template\View(); + $this->view->path = __DIR__.'/views'; + } + + // Set template variables + function testVariables() { + $this->view->set('test', 123); + + $this->assertEquals(123, $this->view->get('test')); + + $this->assertTrue($this->view->has('test')); + $this->assertTrue(!$this->view->has('unknown')); + + $this->view->clear('test'); + + $this->assertEquals(null, $this->view->get('test')); + } + + // Check if template files exist + function testTemplateExists() { + $this->assertTrue($this->view->exists('hello.php')); + $this->assertTrue(!$this->view->exists('unknown.php')); + } + + // Render a template + function testRender() { + $this->view->render('hello', array('name' => 'Bob')); + + $this->expectOutputString('Hello, Bob!'); + } + + // Fetch template output + function testFetch() { + $output = $this->view->fetch('hello', array('name' => 'Bob')); + + $this->assertEquals('Hello, Bob!', $output); + } + + // Default extension + function testTemplateWithExtension() { + $this->view->set('name', 'Bob'); + + $this->view->render('hello.php'); + + $this->expectOutputString('Hello, Bob!'); + } + + // Custom extension + function testTemplateWithCustomExtension() { + $this->view->set('name', 'Bob'); + $this->view->extension = '.html'; + + $this->view->render('world'); + + $this->expectOutputString('Hello world, Bob!'); + } +} diff --git a/vendor/mikecao/flight/tests/classes/Factory.php b/vendor/mikecao/flight/tests/classes/Factory.php new file mode 100644 index 0000000..1136d22 --- /dev/null +++ b/vendor/mikecao/flight/tests/classes/Factory.php @@ -0,0 +1,11 @@ +name = $name; + } +} \ No newline at end of file diff --git a/vendor/mikecao/flight/tests/views/hello.php b/vendor/mikecao/flight/tests/views/hello.php new file mode 100644 index 0000000..86a9b80 --- /dev/null +++ b/vendor/mikecao/flight/tests/views/hello.php @@ -0,0 +1 @@ +Hello, ! \ No newline at end of file diff --git a/vendor/mikecao/flight/tests/views/layouts/layout.php b/vendor/mikecao/flight/tests/views/layouts/layout.php new file mode 100644 index 0000000..f232bc5 --- /dev/null +++ b/vendor/mikecao/flight/tests/views/layouts/layout.php @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/vendor/mikecao/flight/tests/views/world.html b/vendor/mikecao/flight/tests/views/world.html new file mode 100644 index 0000000..05d95c0 --- /dev/null +++ b/vendor/mikecao/flight/tests/views/world.html @@ -0,0 +1 @@ +Hello world, ! \ No newline at end of file