Michael Vogel
7 years ago
483 changed files with 23205 additions and 10887 deletions
@ -0,0 +1,209 @@
|
||||
Autoloader |
||||
========== |
||||
|
||||
* [Home](help) |
||||
|
||||
There is some initial support to class autoloading in Friendica core. |
||||
|
||||
The autoloader code is in `include/autoloader.php`. |
||||
It's derived from composer autoloader code. |
||||
|
||||
Namespaces and Classes are mapped to folders and files in `library/`, |
||||
and the map must be updated by hand, because we don't use composer yet. |
||||
The mapping is defined by files in `include/autoloader/` folder. |
||||
|
||||
Currently, only HTMLPurifier library is loaded using autoloader. |
||||
|
||||
|
||||
## A quick introdution to class autoloading |
||||
|
||||
The autoloader it's a way for php to automagically include the file that define a class when the class is first used, without the need to use "require_once" every time. |
||||
|
||||
Once is setup you don't have to use it in any way. You need a class? you use the class. |
||||
|
||||
At his basic is a function passed to the "spl_autoload_register()" function, which receive as argument the class name the script want and is it job to include the correct php file where that class is defined. |
||||
The best source for documentation is [php site](http://php.net/manual/en/language.oop5.autoload.php). |
||||
|
||||
One example, based on fictional friendica code. |
||||
|
||||
Let's say you have a php file in "include/" that define a very useful class: |
||||
|
||||
``` |
||||
file: include/ItemsManager.php |
||||
<?php |
||||
namespace \Friendica; |
||||
|
||||
class ItemsManager { |
||||
public function getAll() { ... } |
||||
public function getByID($id) { ... } |
||||
} |
||||
``` |
||||
|
||||
The class "ItemsManager" has been declared in "Friendica" namespace. |
||||
Namespaces are useful to keep things separated and avoid names clash (could be that a library you want to use defines a class named "ItemsManager", but as long as is in another namespace, you don't have any problem) |
||||
|
||||
If we were using composer, we had configured it with path where to find the classes of "Friendica" namespace, and then the composer script will generate the autoloader machinery for us. |
||||
As we don't use composer, we need check that the autoloader knows the Friendica namespace. |
||||
So in "include/autoloader/autoload_psr4.php" there should be something like |
||||
|
||||
``` |
||||
$vendorDir = dirname(dirname(dirname(__FILE__)))."/library"; |
||||
$baseDir = dirname($vendorDir); |
||||
return array( |
||||
"Friendica" => array($baseDir."/include"); |
||||
); |
||||
``` |
||||
|
||||
|
||||
That tells the autoloader code to look for files that defines classes in "Friendica" namespace under "include/" folder. (And btw, that's why the file has the same name as the class it defines.) |
||||
|
||||
*note*: The structure of files in "include/autoloader/" has been copied from the code generated by composer, to ease the work of enable autoloader for external libraries under "library/" |
||||
|
||||
Let's say now that you need to load some items in a view, maybe in a fictional "mod/network.php". |
||||
Somewere at the start of the scripts, the autoloader was initialized. In Friendica is done at the top of "boot.php", with "require_once('include/autoloader.php');". |
||||
|
||||
The code will be something like: |
||||
|
||||
``` |
||||
file: mod/network.php |
||||
<?php |
||||
|
||||
function network_content(&$a) { |
||||
$itemsmanager = new \Friendica\ItemsManager(); |
||||
$items = $itemsmanager->getAll(); |
||||
|
||||
// pass $items to template |
||||
// return result |
||||
} |
||||
``` |
||||
|
||||
That's a quite simple example, but look: no "require()"! |
||||
You need to use a class, you use the class and you don't need to do anything more. |
||||
|
||||
Going further: now we have a bunch of "*Manager" classes that cause some code duplication, let's define a BaseManager class, where to move all code in common between all managers: |
||||
|
||||
``` |
||||
file: include/BaseManager.php |
||||
<?php |
||||
namespace \Friendica; |
||||
|
||||
class BaseManager { |
||||
public function thatFunctionEveryManagerUses() { ... } |
||||
} |
||||
``` |
||||
|
||||
and then let's change the ItemsManager class to use this code |
||||
|
||||
``` |
||||
file: include/ItemsManager.php |
||||
<?php |
||||
namespace \Friendica; |
||||
|
||||
class ItemsManager extends BaseManager { |
||||
public function getAll() { ... } |
||||
public function getByID($id) { ... } |
||||
} |
||||
``` |
||||
|
||||
The autoloader don't mind what you need the class for. You need a class, you get the class. |
||||
It works with the "BaseManager" example here, it works when we need to call static methods on a class: |
||||
|
||||
``` |
||||
file: include/dfrn.php |
||||
<?php |
||||
namespace \Friendica; |
||||
|
||||
class dfrn { |
||||
public static function mail($item, $owner) { ... } |
||||
} |
||||
``` |
||||
|
||||
``` |
||||
file: mod/mail.php |
||||
<?php |
||||
|
||||
mail_post($a){ |
||||
... |
||||
\Friendica\dfrn::mail($item, $owner); |
||||
... |
||||
} |
||||
``` |
||||
|
||||
If your code is in same namespace as the class you need, you don't need to prepend it: |
||||
|
||||
``` |
||||
file: include/delivery.php |
||||
<?php |
||||
|
||||
namespace \Friendica; |
||||
|
||||
// this is the same content of current include/delivery.php, |
||||
// but has been declared to be in "Friendica" namespace |
||||
|
||||
[...] |
||||
switch($contact['network']) { |
||||
|
||||
case NETWORK_DFRN: |
||||
if ($mail) { |
||||
$item['body'] = ... |
||||
$atom = dfrn::mail($item, $owner); |
||||
} elseif ($fsuggest) { |
||||
$atom = dfrn::fsuggest($item, $owner); |
||||
q("DELETE FROM `fsuggest` WHERE `id` = %d LIMIT 1", intval($item['id'])); |
||||
} elseif ($relocate) |
||||
$atom = dfrn::relocate($owner, $uid); |
||||
[...] |
||||
``` |
||||
|
||||
This is real "include/delivery.php" unchanged, but as the code is declared to be in "Friendica" namespace, you don't need to write it when you need to use the "dfrn" class. |
||||
But if you want to use classes from another library, you need to use the full namespace, e.g. |
||||
|
||||
``` |
||||
<?php |
||||
namespace \Frienidca; |
||||
|
||||
class Diaspora { |
||||
public function md2bbcode() { |
||||
$html = \Michelf\MarkdownExtra::defaultTransform($text); |
||||
} |
||||
} |
||||
``` |
||||
|
||||
if you use that class in many places of the code and you don't want to write the full path to the class everytime, you can use the "use" php keyword |
||||
|
||||
``` |
||||
<?php |
||||
namespace \Frienidca; |
||||
|
||||
use \Michelf\MarkdownExtra; |
||||
|
||||
class Diaspora { |
||||
public function md2bbcode() { |
||||
$html = MarkdownExtra::defaultTransform($text); |
||||
} |
||||
} |
||||
``` |
||||
|
||||
Note that namespaces are like paths in filesystem, separated by "\", with the first "\" being the global scope. |
||||
You can go more deep if you want to, like: |
||||
|
||||
``` |
||||
<?php |
||||
namespace \Friendica\Network; |
||||
|
||||
class DFRN { |
||||
} |
||||
``` |
||||
|
||||
or |
||||
|
||||
``` |
||||
<?php |
||||
namespace \Friendica\DBA; |
||||
|
||||
class MySQL { |
||||
} |
||||
``` |
||||
|
||||
So you can think of namespaces as folders in a unix filesystem, with global scope as the root ("\"). |
||||
|
||||
@ -0,0 +1,69 @@
|
||||
<?php |
||||
/** |
||||
* @file include/autoloader.php |
||||
*/ |
||||
|
||||
/** |
||||
* @brief composer-derived autoloader init |
||||
**/ |
||||
class FriendicaAutoloaderInit |
||||
{ |
||||
private static $loader; |
||||
|
||||
public static function loadClassLoader($class) |
||||
{ |
||||
if ('Composer\Autoload\ClassLoader' === $class) { |
||||
require __DIR__ . '/autoloader/ClassLoader.php'; |
||||
} |
||||
} |
||||
|
||||
public static function getLoader() |
||||
{ |
||||
if (null !== self::$loader) { |
||||
return self::$loader; |
||||
} |
||||
|
||||
spl_autoload_register(array('FriendicaAutoloaderInit', 'loadClassLoader'), true, true); |
||||
self::$loader = $loader = new \Composer\Autoload\ClassLoader(); |
||||
spl_autoload_unregister(array('FriendicaAutoloaderInit', 'loadClassLoader')); |
||||
|
||||
// library |
||||
$map = require __DIR__ . '/autoloader/autoload_namespaces.php'; |
||||
foreach ($map as $namespace => $path) { |
||||
$loader->set($namespace, $path); |
||||
} |
||||
|
||||
$map = require __DIR__ . '/autoloader/autoload_psr4.php'; |
||||
foreach ($map as $namespace => $path) { |
||||
$loader->setPsr4($namespace, $path); |
||||
} |
||||
|
||||
$classMap = require __DIR__ . '/autoloader/autoload_classmap.php'; |
||||
if ($classMap) { |
||||
$loader->addClassMap($classMap); |
||||
} |
||||
|
||||
$loader->register(true); |
||||
|
||||
$includeFiles = require __DIR__ . '/autoloader/autoload_files.php'; |
||||
foreach ($includeFiles as $fileIdentifier => $file) { |
||||
friendicaRequire($fileIdentifier, $file); |
||||
} |
||||
|
||||
|
||||
return $loader; |
||||
} |
||||
} |
||||
|
||||
function friendicaRequire($fileIdentifier, $file) |
||||
{ |
||||
if (empty($GLOBALS['__composer_autoload_files'][$fileIdentifier])) { |
||||
require $file; |
||||
|
||||
$GLOBALS['__composer_autoload_files'][$fileIdentifier] = true; |
||||
} |
||||
} |
||||
|
||||
|
||||
|
||||
return FriendicaAutoloaderInit::getLoader(); |
||||
@ -0,0 +1,413 @@
|
||||
<?php |
||||
|
||||
/* |
||||
* This file is part of Composer. |
||||
* |
||||
* (c) Nils Adermann <naderman@naderman.de> |
||||
* Jordi Boggiano <j.boggiano@seld.be> |
||||
* |
||||
* For the full copyright and license information, please view the LICENSE.composer |
||||
* file that was distributed with this source code. |
||||
*/ |
||||
|
||||
namespace Composer\Autoload; |
||||
|
||||
/** |
||||
* ClassLoader implements a PSR-0 class loader |
||||
* |
||||
* See https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-0.md |
||||
* |
||||
* $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 <fabien@symfony.com> |
||||
* @author Jordi Boggiano <j.boggiano@seld.be> |
||||
*/ |
||||
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; |
||||
|
||||
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-0 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; |
||||
} |
||||
|
||||
/** |
||||
* 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) |
||||
{ |
||||
// work around for PHP 5.3.0 - 5.3.2 https://bugs.php.net/50731 |
||||
if ('\\' == $class[0]) { |
||||
$class = substr($class, 1); |
||||
} |
||||
|
||||
// class map lookup |
||||
if (isset($this->classMap[$class])) { |
||||
return $this->classMap[$class]; |
||||
} |
||||
if ($this->classMapAuthoritative) { |
||||
return false; |
||||
} |
||||
|
||||
$file = $this->findFileWithExtension($class, '.php'); |
||||
|
||||
// Search for Hack files if we are running on HHVM |
||||
if ($file === null && defined('HHVM_VERSION')) { |
||||
$file = $this->findFileWithExtension($class, '.hh'); |
||||
} |
||||
|
||||
if ($file === null) { |
||||
// Remember that this class does not exist. |
||||
return $this->classMap[$class] = false; |
||||
} |
||||
|
||||
return $file; |
||||
} |
||||
|
||||
private function findFileWithExtension($class, $ext) |
||||
{ |
||||
// PSR-4 lookup |
||||
$logicalPathPsr4 = strtr($class, '\\', DIRECTORY_SEPARATOR) . $ext; |
||||
|
||||
$first = $class[0]; |
||||
if (isset($this->prefixLengthsPsr4[$first])) { |
||||
foreach ($this->prefixLengthsPsr4[$first] as $prefix => $length) { |
||||
if (0 === strpos($class, $prefix)) { |
||||
foreach ($this->prefixDirsPsr4[$prefix] as $dir) { |
||||
if (is_file($file = $dir . DIRECTORY_SEPARATOR . substr($logicalPathPsr4, $length))) { |
||||
return $file; |
||||
} |
||||
} |
||||
} |
||||
} |
||||
} |
||||
|
||||
// PSR-4 fallback dirs |
||||
foreach ($this->fallbackDirsPsr4 as $dir) { |
||||
if (is_file($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 (is_file($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr0)) { |
||||
return $file; |
||||
} |
||||
} |
||||
} |
||||
} |
||||
} |
||||
|
||||
// PSR-0 fallback dirs |
||||
foreach ($this->fallbackDirsPsr0 as $dir) { |
||||
if (is_file($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr0)) { |
||||
return $file; |
||||
} |
||||
} |
||||
|
||||
// PSR-0 include paths. |
||||
if ($this->useIncludePath && $file = stream_resolve_include_path($logicalPathPsr0)) { |
||||
return $file; |
||||
} |
||||
} |
||||
} |
||||
|
||||
/** |
||||
* Scope isolated include. |
||||
* |
||||
* Prevents access to $this/self from included files. |
||||
*/ |
||||
function includeFile($file) |
||||
{ |
||||
include $file; |
||||
} |
||||
@ -0,0 +1,19 @@
|
||||
Copyright (c) 2015 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, andor 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. |
||||
@ -0,0 +1,9 @@
|
||||
<?php |
||||
|
||||
// autoload_classmap.php @generated by Composer |
||||
|
||||
$vendorDir = dirname(dirname(dirname(__FILE__)))."/library"; |
||||
$baseDir = dirname($vendorDir); |
||||
|
||||
return array( |
||||
); |
||||
@ -0,0 +1,10 @@
|
||||
<?php |
||||
|
||||
// autoload_files.php @generated by Composer |
||||
|
||||
$vendorDir = dirname(dirname(dirname(__FILE__)))."/library"; |
||||
$baseDir = dirname($vendorDir); |
||||
|
||||
return array( |
||||
'2cffec82183ee1cea088009cef9a6fc3' => $vendorDir . '/ezyang/htmlpurifier/library/HTMLPurifier.composer.php', |
||||
); |
||||
@ -0,0 +1,10 @@
|
||||
<?php |
||||
|
||||
// autoload_namespaces.php @generated by Composer |
||||
|
||||
$vendorDir = dirname(dirname(dirname(__FILE__)))."/library"; |
||||
$baseDir = dirname($vendorDir); |
||||
|
||||
return array( |
||||
'HTMLPurifier' => array($vendorDir . '/ezyang/htmlpurifier/library'), |
||||
); |
||||
@ -0,0 +1,9 @@
|
||||
<?php |
||||
|
||||
// autoload_psr4.php @generated by Composer |
||||
|
||||
$vendorDir = dirname(dirname(dirname(__FILE__)))."/library"; |
||||
$baseDir = dirname($vendorDir); |
||||
|
||||
return array( |
||||
); |
||||
@ -1,21 +0,0 @@
|
||||
<?php |
||||
|
||||
class HTMLPurifier_AttrDef_CSS_AlphaValue extends HTMLPurifier_AttrDef_CSS_Number |
||||
{ |
||||
|
||||
public function __construct() { |
||||
parent::__construct(false); // opacity is non-negative, but we will clamp it |
||||
} |
||||
|
||||
public function validate($number, $config, $context) { |
||||
$result = parent::validate($number, $config, $context); |
||||
if ($result === false) return $result; |
||||
$float = (float) $result; |
||||
if ($float < 0.0) $result = '0'; |
||||
if ($float > 1.0) $result = '1'; |
||||
return $result; |
||||
} |
||||
|
||||
} |
||||
|
||||
// vim: et sw=4 sts=4 |
||||
@ -1,28 +0,0 @@
|
||||
<?php |
||||
|
||||
/** |
||||
* Decorator which enables CSS properties to be disabled for specific elements. |
||||
*/ |
||||
class HTMLPurifier_AttrDef_CSS_DenyElementDecorator extends HTMLPurifier_AttrDef |
||||
{ |
||||
public $def, $element; |
||||
|
||||
/** |
||||
* @param $def Definition to wrap |
||||
* @param $element Element to deny |
||||
*/ |
||||
public function __construct($def, $element) { |
||||
$this->def = $def; |
||||
$this->element = $element; |
||||
} |
||||
/** |
||||
* Checks if CurrentToken is set and equal to $this->element |
||||
*/ |
||||
public function validate($string, $config, $context) { |
||||
$token = $context->get('CurrentToken', true); |
||||
if ($token && $token->name == $this->element) return false; |
||||
return $this->def->validate($string, $config, $context); |
||||
} |
||||
} |
||||
|
||||
// vim: et sw=4 sts=4 |
||||
@ -1,72 +0,0 @@
|
||||
<?php |
||||
|
||||
/** |
||||
* Validates a font family list according to CSS spec |
||||
* @todo whitelisting allowed fonts would be nice |
||||
*/ |
||||
class HTMLPurifier_AttrDef_CSS_FontFamily extends HTMLPurifier_AttrDef |
||||
{ |
||||
|
||||
public function validate($string, $config, $context) { |
||||
static $generic_names = array( |
||||
'serif' => true, |
||||
'sans-serif' => true, |
||||
'monospace' => true, |
||||
'fantasy' => true, |
||||
'cursive' => true |
||||
); |
||||
|
||||
// assume that no font names contain commas in them |
||||
$fonts = explode(',', $string); |
||||
$final = ''; |
||||
foreach($fonts as $font) { |
||||
$font = trim($font); |
||||
if ($font === '') continue; |
||||
// match a generic name |
||||
if (isset($generic_names[$font])) { |
||||
$final .= $font . ', '; |
||||
continue; |
||||
} |
||||
// match a quoted name |
||||
if ($font[0] === '"' || $font[0] === "'") { |
||||
$length = strlen($font); |
||||
if ($length <= 2) continue; |
||||
$quote = $font[0]; |
||||
if ($font[$length - 1] !== $quote) continue; |
||||
$font = substr($font, 1, $length - 2); |
||||
} |
||||
|
||||
$font = $this->expandCSSEscape($font); |
||||
|
||||
// $font is a pure representation of the font name |
||||
|
||||
if (ctype_alnum($font) && $font !== '') { |
||||
// very simple font, allow it in unharmed |
||||
$final .= $font . ', '; |
||||
continue; |
||||
} |
||||
|
||||
// bugger out on whitespace. form feed (0C) really |
||||
// shouldn't show up regardless |
||||
$font = str_replace(array("\n", "\t", "\r", "\x0C"), ' ', $font); |
||||
|
||||
// These ugly transforms don't pose a security |
||||
// risk (as \\ and \" might). We could try to be clever and |
||||
// use single-quote wrapping when there is a double quote |
||||
// present, but I have choosen not to implement that. |
||||
// (warning: this code relies on the selection of quotation |
||||
// mark below) |
||||
$font = str_replace('\\', '\\5C ', $font); |
||||
$font = str_replace('"', '\\22 ', $font); |
||||
|
||||
// complicated font, requires quoting |
||||
$final .= "\"$font\", "; // note that this will later get turned into " |
||||
} |
||||
$final = rtrim($final, ', '); |
||||
if ($final === '') return false; |
||||
return $final; |
||||
} |
||||
|
||||
} |
||||
|
||||
// vim: et sw=4 sts=4 |
||||
@ -1,47 +0,0 @@
|
||||
<?php |
||||
|
||||
/** |
||||
* Represents a Length as defined by CSS. |
||||
*/ |
||||
class HTMLPurifier_AttrDef_CSS_Length extends HTMLPurifier_AttrDef |
||||
{ |
||||
|
||||
protected $min, $max; |
||||
|
||||
/** |
||||
* @param HTMLPurifier_Length $max Minimum length, or null for no bound. String is also acceptable. |
||||
* @param HTMLPurifier_Length $max Maximum length, or null for no bound. String is also acceptable. |
||||
*/ |
||||
public function __construct($min = null, $max = null) { |
||||
$this->min = $min !== null ? HTMLPurifier_Length::make($min) : null; |
||||
$this->max = $max !== null ? HTMLPurifier_Length::make($max) : null; |
||||
} |
||||
|
||||
public function validate($string, $config, $context) { |
||||
$string = $this->parseCDATA($string); |
||||
|
||||
// Optimizations |
||||
if ($string === '') return false; |
||||
if ($string === '0') return '0'; |
||||
if (strlen($string) === 1) return false; |
||||
|
||||
$length = HTMLPurifier_Length::make($string); |
||||
if (!$length->isValid()) return false; |
||||
|
||||
if ($this->min) { |
||||
$c = $length->compareTo($this->min); |
||||
if ($c === false) return false; |
||||
if ($c < 0) return false; |
||||
} |
||||
if ($this->max) { |
||||
$c = $length->compareTo($this->max); |
||||
if ($c === false) return false; |
||||
if ($c > 0) return false; |
||||
} |
||||
|
||||
return $length->toString(); |
||||
} |
||||
|
||||
} |
||||
|
||||
// vim: et sw=4 sts=4 |
||||
@ -1,78 +0,0 @@
|
||||
<?php |
||||
|
||||
/** |
||||
* Validates shorthand CSS property list-style. |
||||
* @warning Does not support url tokens that have internal spaces. |
||||
*/ |
||||
class HTMLPurifier_AttrDef_CSS_ListStyle extends HTMLPurifier_AttrDef |
||||
{ |
||||
|
||||
/** |
||||
* Local copy of component validators. |
||||
* @note See HTMLPurifier_AttrDef_CSS_Font::$info for a similar impl. |
||||
*/ |
||||
protected $info; |
||||
|
||||
public function __construct($config) { |
||||
$def = $config->getCSSDefinition(); |
||||
$this->info['list-style-type'] = $def->info['list-style-type']; |
||||
$this->info['list-style-position'] = $def->info['list-style-position']; |
||||
$this->info['list-style-image'] = $def->info['list-style-image']; |
||||
} |
||||
|
||||
public function validate($string, $config, $context) { |
||||
|
||||
// regular pre-processing |
||||
$string = $this->parseCDATA($string); |
||||
if ($string === '') return false; |
||||
|
||||
// assumes URI doesn't have spaces in it |
||||
$bits = explode(' ', strtolower($string)); // bits to process |
||||
|
||||
$caught = array(); |
||||
$caught['type'] = false; |
||||
$caught['position'] = false; |
||||
$caught['image'] = false; |
||||
|
||||
$i = 0; // number of catches |
||||
$none = false; |
||||
|
||||
foreach ($bits as $bit) { |
||||
if ($i >= 3) return; // optimization bit |
||||
if ($bit === '') continue; |
||||
foreach ($caught as $key => $status) { |
||||
if ($status !== false) continue; |
||||
$r = $this->info['list-style-' . $key]->validate($bit, $config, $context); |
||||
if ($r === false) continue; |
||||
if ($r === 'none') { |
||||
if ($none) continue; |
||||
else $none = true; |
||||
if ($key == 'image') continue; |
||||
} |
||||
$caught[$key] = $r; |
||||
$i++; |
||||
break; |
||||
} |
||||
} |
||||
|
||||
if (!$i) return false; |
||||
|
||||
$ret = array(); |
||||
|
||||
// construct type |
||||
if ($caught['type']) $ret[] = $caught['type']; |
||||
|
||||
// construct image |
||||
if ($caught['image']) $ret[] = $caught['image']; |
||||
|
||||
// construct position |
||||
if ($caught['position']) $ret[] = $caught['position']; |
||||
|
||||
if (empty($ret)) return false; |
||||
return implode(' ', $ret); |
||||
|
||||
} |
||||
|
||||
} |
||||
|
||||
// vim: et sw=4 sts=4 |
||||
@ -1,40 +0,0 @@
|
||||
<?php |
||||
|
||||
/** |
||||
* Validates a Percentage as defined by the CSS spec. |
||||
*/ |
||||
class HTMLPurifier_AttrDef_CSS_Percentage extends HTMLPurifier_AttrDef |
||||
{ |
||||
|
||||
/** |
||||
* Instance of HTMLPurifier_AttrDef_CSS_Number to defer number validation |
||||
*/ |
||||
protected $number_def; |
||||
|
||||
/** |
||||
* @param Bool indicating whether to forbid negative values |
||||
*/ |
||||
public function __construct($non_negative = false) { |
||||
$this->number_def = new HTMLPurifier_AttrDef_CSS_Number($non_negative); |
||||
} |
||||
|
||||
public function validate($string, $config, $context) { |
||||
|
||||
$string = $this->parseCDATA($string); |
||||
|
||||
if ($string === '') return false; |
||||
$length = strlen($string); |
||||
if ($length === 1) return false; |
||||
if ($string[$length - 1] !== '%') return false; |
||||
|
||||
$number = substr($string, 0, $length - 1); |
||||
$number = $this->number_def->validate($number, $config, $context); |
||||
|
||||
if ($number === false) return false; |
||||
return "$number%"; |
||||
|
||||
} |
||||
|
||||
} |
||||
|
||||
// vim: et sw=4 sts=4 |
||||
@ -1,28 +0,0 @@
|
||||
<?php |
||||
|
||||
/** |
||||
* Validates a boolean attribute |
||||
*/ |
||||
class HTMLPurifier_AttrDef_HTML_Bool extends HTMLPurifier_AttrDef |
||||
{ |
||||
|
||||
protected $name; |
||||
public $minimized = true; |
||||
|
||||
public function __construct($name = false) {$this->name = $name;} |
||||
|
||||
public function validate($string, $config, $context) { |
||||
if (empty($string)) return false; |
||||
return $this->name; |
||||
} |
||||
|
||||
/** |
||||
* @param $string Name of attribute |
||||
*/ |
||||
public function make($string) { |
||||
return new HTMLPurifier_AttrDef_HTML_Bool($string); |
||||
} |
||||
|
||||
} |
||||
|
||||
// vim: et sw=4 sts=4 |
||||
@ -1,32 +0,0 @@
|
||||
<?php |
||||
|
||||
/** |
||||
* Validates a color according to the HTML spec. |
||||
*/ |
||||
class HTMLPurifier_AttrDef_HTML_Color extends HTMLPurifier_AttrDef |
||||
{ |
||||
|
||||
public function validate($string, $config, $context) { |
||||
|
||||
static $colors = null; |
||||
if ($colors === null) $colors = $config->get('Core.ColorKeywords'); |
||||
|
||||
$string = trim($string); |
||||
|
||||
if (empty($string)) return false; |
||||
if (isset($colors[$string])) return $colors[$string]; |
||||
if ($string[0] === '#') $hex = substr($string, 1); |
||||
else $hex = $string; |
||||
|
||||
$length = strlen($hex); |
||||
if ($length !== 3 && $length !== 6) return false; |
||||
if (!ctype_xdigit($hex)) return false; |
||||
if ($length === 3) $hex = $hex[0].$hex[0].$hex[1].$hex[1].$hex[2].$hex[2]; |
||||
|
||||
return "#$hex"; |
||||
|
||||
} |
||||
|
||||
} |
||||
|
||||
// vim: et sw=4 sts=4 |
||||
@ -1,21 +0,0 @@
|
||||
<?php |
||||
|
||||
/** |
||||
* Special-case enum attribute definition that lazy loads allowed frame targets |
||||
*/ |
||||
class HTMLPurifier_AttrDef_HTML_FrameTarget extends HTMLPurifier_AttrDef_Enum |
||||
{ |
||||
|
||||
public $valid_values = false; // uninitialized value |
||||
protected $case_sensitive = false; |
||||
|
||||
public function __construct() {} |
||||
|
||||
public function validate($string, $config, $context) { |
||||
if ($this->valid_values === false) $this->valid_values = $config->get('Attr.AllowedFrameTargets'); |
||||
return parent::validate($string, $config, $context); |
||||
} |
||||
|
||||
} |
||||
|
||||
// vim: et sw=4 sts=4 |
||||
@ -1,70 +0,0 @@
|
||||
<?php |
||||
|
||||
/** |
||||
* Validates the HTML attribute ID. |
||||
* @warning Even though this is the id processor, it |
||||
* will ignore the directive Attr:IDBlacklist, since it will only |
||||
* go according to the ID accumulator. Since the accumulator is |
||||
* automatically generated, it will have already absorbed the |
||||
* blacklist. If you're hacking around, make sure you use load()! |
||||
*/ |
||||
|
||||
class HTMLPurifier_AttrDef_HTML_ID extends HTMLPurifier_AttrDef |
||||
{ |
||||
|
||||
// ref functionality disabled, since we also have to verify |
||||
// whether or not the ID it refers to exists |
||||
|
||||
public function validate($id, $config, $context) { |
||||
|
||||
if (!$config->get('Attr.EnableID')) return false; |
||||
|
||||
$id = trim($id); // trim it first |
||||
|
||||
if ($id === '') return false; |
||||
|
||||
$prefix = $config->get('Attr.IDPrefix'); |
||||
if ($prefix !== '') { |
||||
$prefix .= $config->get('Attr.IDPrefixLocal'); |
||||
// prevent re-appending the prefix |
||||
if (strpos($id, $prefix) !== 0) $id = $prefix . $id; |
||||
} elseif ($config->get('Attr.IDPrefixLocal') !== '') { |
||||
trigger_error('%Attr.IDPrefixLocal cannot be used unless '. |
||||
'%Attr.IDPrefix is set', E_USER_WARNING); |
||||
} |
||||
|
||||
//if (!$this->ref) { |
||||
$id_accumulator =& $context->get('IDAccumulator'); |
||||
if (isset($id_accumulator->ids[$id])) return false; |
||||
//} |
||||
|
||||
// we purposely avoid using regex, hopefully this is faster |
||||
|
||||
if (ctype_alpha($id)) { |
||||
$result = true; |
||||
} else { |
||||
if (!ctype_alpha(@$id[0])) return false; |
||||
$trim = trim( // primitive style of regexps, I suppose |
||||
$id, |
||||
'A..Za..z0..9:-._' |
||||
); |
||||
$result = ($trim === ''); |
||||
} |
||||
|
||||
$regexp = $config->get('Attr.IDBlacklistRegexp'); |
||||
if ($regexp && preg_match($regexp, $id)) { |
||||
return false; |
||||
} |
||||
|
||||
if (/*!$this->ref && */$result) $id_accumulator->add($id); |
||||
|
||||
// if no change was made to the ID, return the result |
||||
// else, return the new id if stripping whitespace made it |
||||
// valid, or return false. |
||||
return $result ? $id : false; |
||||
|
||||
} |
||||
|
||||
} |
||||
|
||||
// vim: et sw=4 sts=4 |
||||
@ -1,41 +0,0 @@
|
||||
<?php |
||||
|
||||
/** |
||||
* Validates the HTML type length (not to be confused with CSS's length). |
||||
* |
||||
* This accepts integer pixels or percentages as lengths for certain |
||||
* HTML attributes. |
||||
*/ |
||||
|
||||
class HTMLPurifier_AttrDef_HTML_Length extends HTMLPurifier_AttrDef_HTML_Pixels |
||||
{ |
||||
|
||||
public function validate($string, $config, $context) { |
||||
|
||||
$string = trim($string); |
||||
if ($string === '') return false; |
||||
|
||||
$parent_result = parent::validate($string, $config, $context); |
||||
if ($parent_result !== false) return $parent_result; |
||||
|
||||
$length = strlen($string); |
||||
$last_char = $string[$length - 1]; |
||||
|
||||
if ($last_char !== '%') return false; |
||||
|
||||
$points = substr($string, 0, $length - 1); |
||||
|
||||
if (!is_numeric($points)) return false; |
||||
|
||||
$points = (int) $points; |
||||
|
||||
if ($points < 0) return '0%'; |
||||
if ($points > 100) return '100%'; |
||||
|
||||
return ((string) $points) . '%'; |
||||
|
||||
} |
||||
|
||||
} |
||||
|
||||
// vim: et sw=4 sts=4 |
||||
@ -1,41 +0,0 @@
|
||||
<?php |
||||
|
||||
/** |
||||
* Validates a MultiLength as defined by the HTML spec. |
||||
* |
||||
* A multilength is either a integer (pixel count), a percentage, or |
||||
* a relative number. |
||||
*/ |
||||
class HTMLPurifier_AttrDef_HTML_MultiLength extends HTMLPurifier_AttrDef_HTML_Length |
||||
{ |
||||
|
||||
public function validate($string, $config, $context) { |
||||
|
||||
$string = trim($string); |
||||
if ($string === '') return false; |
||||
|
||||
$parent_result = parent::validate($string, $config, $context); |
||||
if ($parent_result !== false) return $parent_result; |
||||
|
||||
$length = strlen($string); |
||||
$last_char = $string[$length - 1]; |
||||
|
||||
if ($last_char !== '*') return false; |
||||
|
||||
$int = substr($string, 0, $length - 1); |
||||
|
||||
if ($int == '') return '*'; |
||||
if (!is_numeric($int)) return false; |
||||
|
||||
$int = (int) $int; |
||||
|
||||
if ($int < 0) return false; |
||||
if ($int == 0) return '0'; |
||||
if ($int == 1) return '*'; |
||||
return ((string) $int) . '*'; |
||||
|
||||
} |
||||
|
||||
} |
||||
|
||||
// vim: et sw=4 sts=4 |
||||
@ -1,48 +0,0 @@
|
||||
<?php |
||||
|
||||
/** |
||||
* Validates an integer representation of pixels according to the HTML spec. |
||||
*/ |
||||
class HTMLPurifier_AttrDef_HTML_Pixels extends HTMLPurifier_AttrDef |
||||
{ |
||||
|
||||
protected $max; |
||||
|
||||
public function __construct($max = null) { |
||||
$this->max = $max; |
||||
} |
||||
|
||||
public function validate($string, $config, $context) { |
||||
|
||||
$string = trim($string); |
||||
if ($string === '0') return $string; |
||||
if ($string === '') return false; |
||||
$length = strlen($string); |
||||
if (substr($string, $length - 2) == 'px') { |
||||
$string = substr($string, 0, $length - 2); |
||||
} |
||||
if (!is_numeric($string)) return false; |
||||
$int = (int) $string; |
||||
|
||||
if ($int < 0) return '0'; |
||||
|
||||
// upper-bound value, extremely high values can |
||||
// crash operating systems, see <http://ha.ckers.org/imagecrash.html> |
||||
// WARNING, above link WILL crash you if you're using Windows |
||||
|
||||
if ($this->max !== null && $int > $this->max) return (string) $this->max; |
||||
|
||||
return (string) $int; |
||||
|
||||
} |
||||
|
||||
public function make($string) { |
||||
if ($string === '') $max = null; |
||||
else $max = (int) $string; |
||||
$class = get_class($this); |
||||
return new $class($max); |
||||
} |
||||
|
||||
} |
||||
|
||||
// vim: et sw=4 sts=4 |
||||
@ -1,15 +0,0 @@
|
||||
<?php |
||||
|
||||
/** |
||||
* Validates arbitrary text according to the HTML spec. |
||||
*/ |
||||
class HTMLPurifier_AttrDef_Text extends HTMLPurifier_AttrDef |
||||
{ |
||||
|
||||
public function validate($string, $config, $context) { |
||||
return $this->parseCDATA($string); |
||||
} |
||||
|
||||
} |
||||
|
||||
// vim: et sw=4 sts=4 |
||||
@ -1,62 +0,0 @@
|
||||
<?php |
||||
|
||||
/** |
||||
* Validates a host according to the IPv4, IPv6 and DNS (future) specifications. |
||||
*/ |
||||
class HTMLPurifier_AttrDef_URI_Host extends HTMLPurifier_AttrDef |
||||
{ |
||||
|
||||
/** |
||||
* Instance of HTMLPurifier_AttrDef_URI_IPv4 sub-validator |
||||
*/ |
||||
protected $ipv4; |
||||
|
||||
/** |
||||
* Instance of HTMLPurifier_AttrDef_URI_IPv6 sub-validator |
||||
*/ |
||||
protected $ipv6; |
||||
|
||||
public function __construct() { |
||||
$this->ipv4 = new HTMLPurifier_AttrDef_URI_IPv4(); |
||||
$this->ipv6 = new HTMLPurifier_AttrDef_URI_IPv6(); |
||||
} |
||||
|
||||
public function validate($string, $config, $context) { |
||||
$length = strlen($string); |
||||
if ($string === '') return ''; |
||||
if ($length > 1 && $string[0] === '[' && $string[$length-1] === ']') { |
||||
//IPv6 |
||||
$ip = substr($string, 1, $length - 2); |
||||
$valid = $this->ipv6->validate($ip, $config, $context); |
||||
if ($valid === false) return false; |
||||
return '['. $valid . ']'; |
||||
} |
||||
|
||||
// need to do checks on unusual encodings too |
||||
$ipv4 = $this->ipv4->validate($string, $config, $context); |
||||
if ($ipv4 !== false) return $ipv4; |
||||
|
||||
// A regular domain name. |
||||
|
||||
// This breaks I18N domain names, but we don't have proper IRI support, |
||||
// so force users to insert Punycode. If there's complaining we'll |
||||
// try to fix things into an international friendly form. |
||||
|
||||
// The productions describing this are: |
||||
$a = '[a-z]'; // alpha |
||||
$an = '[a-z0-9]'; // alphanum |
||||
$and = '[a-z0-9-]'; // alphanum | "-" |
||||
// domainlabel = alphanum | alphanum *( alphanum | "-" ) alphanum |
||||
$domainlabel = "$an($and*$an)?"; |
||||
// toplabel = alpha | alpha *( alphanum | "-" ) alphanum |
||||
$toplabel = "$a($and*$an)?"; |
||||