+ 
+
+ util.php is a collection of useful functions and snippets + that you need or could use every day. It's implemented as a class with static methods, to avoid conflicts with your + existing code-base. Just drop it in and start using it immediately. +
+ ++ Included are 60+ functions that provide you with the ability to do common tasks much easier and more efficiently, + without having to find that one comment on php.net where you know its been done already. Access superglobals + without checking to see if certain indexes are set first and pass default values, use a nicely formatted var dump, + validate emails, generate random strings, flatten an array, pull a single column out of a multidimensional array + and much more. +
+ ++ Although it's implemented as one giant class, util.php has extensive documentation and a full suite of unit tests + to avoid breaking backwards-compatibility unintentionally. +
+ ++ The project is hosted on GitHub. + You can report bugs and discuss features on the + issues page, + or send tweets to @brandonwamboldt. +
+ +
+ Stable Version (1.1.0)
+ Unstable Version (master)
+
+ Simply drop util.php in any project and call include 'util.php'; in your project.
+ You can then access the Util class.
+
+ Add the following dependency to your composer.json: + +
"brandonwamboldt/utilphp": "1.1.*"+ + When used with composer, the class is namespaced (
\utilphp\util) instead of
+ just util.
+
+
+
+ var_dump
+
+ util::var_dump(mixed $var[, bool $return = FALSE])
+
+
+ Nicely prints out the contents of a passed variable. Booleans are properly displayed as 'true' or 'false', + null values are shown as 'NULL', variable types are displayed, and arrays and objects are displayed as a + collapsible tree powered by JavaScript. +
+ +Usage:
+ +util::var_dump($var);+ +
+
+ array_first
+
+ util::array_first(array $array)
+
+
+ Retrieve the first value from an array. Can be run on function callbacks, and it will not modify the pointer + of the source array unlike most other methods of doing this. +
+ +Usage:
+ +util::array_first( ['a', 'b', 'c'] );+
=> Returns 'a'
+ array_first_key
+
+ util::array_first_key(array $array)
+
+
+ Retrieve the first key from an array. Can be run on function callbacks, and it will not modify the pointer of + the source array unlike most other methods of doing this. +
+ +Usage:
+ +util::array_first_key( $users );+
=> Returns 'brandon'
+ array_flatten
+
+ util::array_flatten(array $array[, bool $preserve_keys = TRUE])
+
+
Flattens a multi-dimensional array into a one dimensional array
+ +Usage:
+ +util::array_flatten( [ 'a', 'b', [ 'c', 'd', 'e', [ 'f', 'g', [ [ [ [ 'h', 'i', 'j' ] ] ] ] ] ] ] ); +=> Returns [ 'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j' ]+
+ array_get
+
+ util::array_get($var[, mixed $default = NULL])
+
+
Retrieve a value from an array, or return a given default if the index isn't set
+ +Usage:
+ +util::array_get($_POST['action'], 'index'); +=> If $_POST['action'] is set, returns its value, otherwise returns 'index' +util::array_get($_POST['action']['do'], 'index'); +=> Returns the value of $_POST['action']['do'] or 'index'+
+ array_last
+
+ util::array_last(array $array)
+
+
+ Retrieve the last value from an array. Can be run on function callbacks, and it will not modify the pointer + of the source array unlike most other methods of doing this. +
+ +Usage:
+ +util::array_last( [ 'a', 'b', 'c'] ); +=> Returns 'c'+
+ array_last_key
+
+ util::array_last_key(array $array)
+
+
+ Retrieve the last key from an array. Can be run on function callbacks, and it will not modify the pointer of + the source array unlike most other methods of doing this. +
+ +Usage:
+ +util::array_last_key( $users ); +=> Returns 'zane'+
+ array_map_deep
+
+ util::array_map_deep(array $array, callable $callback[, bool $on_nonscalar = FALSE])
+
+
+ Returns an array containing all the elements of $array after applying the callback function to each one recursively. + Particularly useful for avoiding errors when calling functions that only accept scalar values on an array that could + contain nested arrays, such as $_GET or $_POST. +
+ +Usage:
+ +util::array_map_deep($_POST, 'htmlentities'); +=> Recursively escapes each scalar value in $_POST +util::array_map_deep($_POST, 'htmlentities', TRUE); +=> Recursively escapes each value in $_POST regardless of its type+
+ array_pluck
+
+ util::array_pluck(array $array, string $field[, bool $preserve_keys, bool $remove_nomatches])
+
+
+ Replaces each value in an array with the specified field of the array or object that used to be the value. Very + useful when you have an array of objects or arrays from a database, and you only want one specific field. For + example, you want an array of emails from an array of users. +
+ +Usage:
+ +util::array_pluck([['val' => 1], ['val' => 2], ['val' => 3]], 'val'); +=> Returns [1, 2, 3] +util::array_pluck($users, 'email'); +=> Returns an array of email addresses for each user+
+ array_search_deep
+
+ util::array_search_deep(array $array, mixed $search[, string $field = FALSE])
+
+
+ Allows you to search for a value in an array of arrays or an array of objects, and return the key of the value + that matches the search criteria. If $field is unspecified, the entire array/object is searched. +
+ +Usage:
+ +util::array_search_deep($_POST, 'delete_post'); +=> Might return 'do' if $_POST['do']['action'] = 'delete_post' +util::array_search_deep($users, 'rogue_coder', 'username'); +=> Might return 5 if $users[5]->username = 'rogue_coder'+
+ array_clean
+
+ util::array_clean(array $array)
+
+
+ Remove all null/empty/false values from the given array. +
+ +Usage:
+ +util::array_clean( array( 'a', 'b', '', null, false, 0) );+
=> Returns array('a', 'b');
+ add_query_arg
+
+ util::add_query_arg()
+
+
Adds one ore more query args to the query string of the current URL or a given URL
+ +Usage:
+ +util::add_query_arg( 'user', '5', '/admin/users?action=edit' ); +=> Returns '/admin/users?action=edit&user=5' +util::add_query_arg( [ 'user' => 5, 'action' => 'edit' ], '/admin/users' ); +=> Returns '/admin/users?user=5&action=edit'+
+ get_current_url
+
+ util::get_current_url()
+
+
Returns the current URL with hostname
+ +Usage:
+ +util::get_current_url(); +=> Returns 'http://brandonwamboldt.ca/utilphp/'+
+ is_https
+
+ util::is_https()
+
+
Returns true if the current page is being loaded over https, false if it isn't
+ +Usage:
+ +util::is_https(); +=> Returns false+
+ http_build_url
+
+ util::http_build_url([mixed $url[, mixed $parts[, int $flags = HTTP_URL_REPLACE[, array &amo;$new_url]]]])
+
+
+ Pure PHP implementation/polyfill for http_build_url + which requires pecl_http to be installed. +
+ +Usage:
+ +echo util::http_build_url("http://user@www.example.com/pub/index.php?a=b#files",
+ array(
+ "scheme" => "ftp",
+ "host" => "ftp.example.com",
+ "path" => "files/current/",
+ "query" => "a=c"
+ ),
+ HTTP_URL_STRIP_AUTH | HTTP_URL_JOIN_PATH | HTTP_URL_JOIN_QUERY | HTTP_URL_STRIP_FRAGMENT
+);
+
+ The above example will output:
+ +ftp://ftp.example.com/pub/files/current/?a=c+
+ is_https
+
+ util::is_https()
+
+
Returns true if the current page is being loaded over https, false if it isn't
+ +Usage:
+ +util::is_https(); +=> Returns false+
+ remove_query_arg
+
+ util::remove_query_arg( array|string $query_args[, string $url])
+
+
Removes one ore more query args from the query string of the current URL or a given URL
+ +Usage:
+ +util::remove_query_arg( 'action', '/admin/users?action=edit&user=5' ); +=> Returns '/admin/users?user=5' +util::remove_query_arg( [ 'user', 'action'], '/admin/users?action=edit&user=5' ); +=> Returns '/admin/users'+
+ slugify
+
+ util::slugify(string $string[, string $separator = "-", bool $css_mode = FALSE])
+
+
+ Generate a string safe for use in URLs from any given string. Converts any accent characters + to their equivalent normal characters and converts any other non-alphanumeric characters to + dashes, then converts any sequence of two or more dashes to a single dash. This function + generates slugs safe for use as URLs, and if you pass TRUE as the second parameter, it will + create strings safe for use as CSS classes or IDs. +
+ +Usage:
+ +util::slugify('This is a random --string with an Ãccent');
+=> Returns 'this-is-a-random-string-with-an-accent'
+util::slugify('Another String', '.');
+=> Returns 'another.string'
+
+ htmlentities
+
+ util::htmlentities(string $string[, bool $preserve_encoded_entities = FALSE])
+
+
+ Executes htmlentities with ENT_QUOTES set by default. However, if you pass TRUE as + the second parameter, it will not re-encode entities that are already encoded. +
+ +Usage:
+ +util::htmlentities('this string < this string', TRUE);
+=> Returns 'this string < this string'
+
+ htmlspecialchars
+
+ util::htmlspecialchars(string $string[, bool $preserve_encoded_entities = FALSE])
+
+
+ Executes htmlspecialchars with ENT_QUOTES set by default. However, if you pass TRUE as + the second parameter, it will not re-encode entities that are already encoded. +
+ +Usage:
+ +util::htmlspecialchars('this string < this string', TRUE);
+=> Returns 'this string < this string'
+
+ linkify
+
+ util::linkify(string $text)
+
+
Find's any URLs in the specified text and wraps them with HTML anchor tags
+ +Usage:
+ +util::linkify('this string has a link to www.google.com');
+=> Returns 'this string has a link to <a href="http://wwww.google.com/">www.google.com</a>'
+
+ match_string
+
+ util::match_string(string $pattern, string $string[, bool $caseSensitive = true])
+
+
+ Check if a string matches a given pattern. You can use '*' as a wildcard character. +
+ +Usage:
+ +util::match_string("test/*", "test/my/test");
+=> Returns true
+util::match_string("test/", "test/my/test");
+=> Returns false
+
+ random_string
+
+ util::random_string(int $length[, bool $human_friendly = TRUE, bool $include_symbols = FALSE, bool $no_duplicate_chars = FALSE])
+
+
+ Generates a random string of the specified length. Human friendly mode + will exclude characters that can be confused with other characters, such + as 0 (zero) and O (capital o), 1 (one) and l (lowercase L). +
+ +Usage:
+ +util::random_string(8); +=> Returns 'a6BiF4UW'+
+ number_to_word
+
+ util::number_to_word(int|float $number)
+
+
Converts a number into its text equivalent. For example, 56 becomes fifty-six.
+ +util::number_to_word(512.5); +=> Returns 'five hundred and twelve point five'+
+ ordinal
+
+ util::ordinal(int $number)
+
+
Returns the ordinal version of a number (appends th, st, nd, rd)
+ +Usage:
+ +util::ordinal(22); +=> Returns '22nd'+
+ remove_accents
+
+ util::remove_accents(string $string)
+
+
Converts all accent characters to their ASCII equivalents
+ +Usage:
+ +util::remove_accents('Àccent');
+=> Returns 'Accent'
+
+ secure_random_string
+
+ util::secure_random_string(int $length)
+
+
Generate a random string of characters. Will attempt to use a secure source (openssl).
+ +Usage:
+ +util::secure_random_string(16); +=> Returns '5bB1RJH0cQhNjviT'+
+ seems_utf8
+
+ util::seems_utf8(string $string)
+
+
Checks to see if a given string is UTF-8 encoded/safe
+ +Usage:
+ +util::seems_utf8('This is some random string user input');
+=> Returns true
+
+ safe_truncate
+
+ util::safe_truncate(string $string, int $length[, string $append = '...'])
+
+
Truncate a string to a specified length without cutting a word off
+ +Usage:
+ +util::safe_truncate('The quick brown fox jumps over the lazy dog', 24);
+=> Returns 'The quick brown fox...'
+
+ size_format
+
+ util::size_format(int $bytes[, int $decimals = 0])
+
+
Formats an integer as a human friendly size string, such as 4 KiB.
+ +Usage:
+ +util::size_format( 25151251, 2 ); +=> Returns '23.99 MiB'+
+ str_to_bool
+
+ util::str_to_bool(string $string)
+
+
Converts a string to boolean, looking for yes/no words like 'yes', 'no', 'true', 'false', 'y', 'n', etc
+ +Usage:
+ +util::str_to_bool('yes');
+=> Returns true
+
+ zero_pad
+
+ util::zero_pad(int $number, int $length)
+
+
Pads a given number with zeroes on the left
+ +Usage:
+ +util::zero_pad(341, 8); +=> Returns '00000341'+
+ strip_space
+
+ util::strip_space(string $string)
+
+
Strip all withspace from the given string
+ +Usage:
+ +util::strip_space(' The quick brown fox jumps over the lazy dog ');
+=> Returns 'Thequickbrownfoxjumpsoverthelazydog'
+
+ sanitize_string
+
+ util::sanitize_string(string $string)
+
+
+ Sanitize a string by performing the following operation : +
Usage:
+ +util::sanitize_string(' Benoit! à New-York? j’ai perçu 1 % : Qu’as-tu "gagné" chez M. V. Noël? Dix francs.');
+=> Returns 'benoitanewyorkjaipercu1quastugagnechezmvnoeldixfrancs'
+
+ full_permissions
+
+ util::full_permissions(string $file)
+
+
Returns the file permissions as a nice string, like -rw-r--r--
+ +Usage:
+ +util::full_permissions('/etc/passwd');
+=> Returns '-rw-r--r--'
+
+ rmdir
+
+ util::rmdir(string $dir[, bool $traverseSymlinks = false])
+
+
Recursively deletes a directories (including all contents).
+ +Usage:
+ +util::rmdir('/tmp/working/dir');
+=> Returns true
+
+ is_serialized
+
+ util::is_serialized(mixed $data)
+
+
Checks to see if a given variable is a seralized data structure
+ +Usage:
+ +util::is_serialized( 'a:0:{}' );
+=> Returns true
+
+ maybe_serialize
+
+ util::maybe_serialize(mixed $data)
+
+
Serialize data, if needed to store in plaintext (Arrays or objects)
+ +Usage:
+ +util::maybe_serialize( 5 );
+=> Returns 5
+util::maybe_serialize( array() );
+=> Returns 'a:0:{}'
+
+ maybe_unserialize
+
+ util::maybe_unserialize(mixed $data)
+
+
Unserialize data, if it's a serialized string
+ +Usage:
+ +util::maybe_unserialize(5);
+=> Returns 5
+util::maybe_unserialize("a:0:{}");
+=> Returns array()
+
+ fix_broken_serialization
+
+ util::fix_broken_serialization(mixed $data)
+
+
+ Attempt to fix a broken serialization string (e.g. where string offsets are incorrect). Can fix + errors that frequently occur with mismatched character sets or higher-than-ASCII characters. +
+ +Usage:
+ +util::fix_broken_serialization('a:1:{s:4:"test";s:4:"abc";}');
+=> Returns 'a:1:{s:4:"test";s:3:"abc";}'
+
+ force_download
+
+ util::force_download(string $filename, string $content = FALSE)
+
+
+ Transmit headers that force a browser to display the download file dialog. Cross + browser compatible. Only fires if headers have not already been sent. +
+ +Usage:
+ +util::force_download( 'export.csv', file_get_contents( 'securefile.csv' ) ); +=> The user will be prompted to download the file+
+ get_client_ip
+
+ util::get_client_ip(bool $trust_proxy_headers = FALSE)
+
+
+ Returns the IP address of the client. Only enable $trust_proxy_headers if your server is behind a proxy + that sets the HTTP_CLIENT_IP and HTTP_X_FORWARDED_FOR headers. +
+ +Usage:
+ +util::get_client_ip(); +=> Returns '12.123.12.100'+
+ get_gravatar
+
+ util::get_gravatar(string $email, int $size = 32)
+
+
Return the URL to a user's gravatar
+ +Usage:
+ +util::get_gravatar('brandon.wamboldt@gmail.com');
+=> Returns 'http://www.gravatar.com/avatar/46679faeb6780ecb1ea57527fdc66eb3?s=32'
+
+ human_time_diff
+
+ util::human_time_diff(int $from, int $to = '', int $as_text = FALSE, string $suffix = ' ago')
+
+
Converts a unix timestamp to a relative time string, such as "3 days ago" or "2 weeks ago"
+ +Usage:
+ +util::human_time_diff(time() - 7400); +=> Returns '2 hours ago' +util::human_time_diff(time() - 7400, '', TRUE); +=> Returns 'two hours ago'+
+ nocache_headers
+
+ util::nocache_headers(mixed $data)
+
+
Sets the headers to prevent caching for the different browsers
+ ++ Different browsers support different nocache headers, so several headers must be sent + so that all of them get the point that no caching should occur +
+ +Usage:
+ +util::nocache_headers();+
+ utf8_headers
+
+ util::utf8_headers(mixed $content_type = 'text/html')
+
+
Transmit UTF-8 content headers if the headers haven't already been sent
+ +Usage:
+ +util::utf8_headers();+
+ validate_email
+
+ util::validate_email(string $possible_email)
+
+
Validate an email address
+ +Usage:
+ +util::validate_email( 'brandon.wamboldt@gmail.com' ); +=> Returns true +util::validate_email( 'not an email' ); +=> Returns false+
+ SECONDS_IN_A_MINUTE
+
+ util::SECONDS_IN_A_MINUTE
+
+
The number of seconds in a minute, useful for making code more verbose
+
+ SECONDS_IN_AN_HOUR
+
+ util::SECONDS_IN_AN_HOUR
+
+
The number of seconds in an hour, useful for making code more verbose
+
+ SECONDS_IN_A_DAY
+
+ util::SECONDS_IN_A_DAY
+
+
The number of seconds in a day, useful for making code more verbose
+
+ SECONDS_IN_A_WEEK
+
+ util::SECONDS_IN_A_WEEK
+
+
The number of seconds in a week (7 days), useful for making code more verbose
+
+ SECONDS_IN_A_MONTH
+
+ util::SECONDS_IN_A_MONTH
+
+
The number of seconds in a month (30 days), useful for making code more verbose
+
+ SECONDS_IN_A_YEAR
+
+ util::SECONDS_IN_A_YEAR
+
+
The number of seconds in a year (365 days), useful for making code more verbose
+
+ 1.1.0
+
+ This release introduces a deprecation notice for slugify(), please update your code.
+
+ - Added a cryptographically secure random string function secure_random_string. Thanks to @abhimanyusharma003 via Pull Request #53
+ - Added limit_characters and limit_words functions. Thanks to @abhimanyusharma003 via Pull Request #55
+ - Added rmdir method to recursively delete a directory. Thanks to @ARACOOOL via Pull Request #56
+ - Added set_executable, set_readable, set_writable, directory_size, directory_contents and get_user_dir functions. Thanks to @sergserg via Pull Request #70
+ - Changed parameter ordering for slugify, $css_mode is now the third argument. For backwards compatibility, the old order will still work but it will generate an E_USER_DEPRECATED warning. Thanks to @abhimanyusharma003 via Pull Request #71
+ - Added match_string method. Thanks to @abhimanyusharma003 via Pull Request #72
+ - Renamed internal methods (protected ones) for PSR-2 compliance
+ - General performance improvements, code quality improvements, and increased unit test coverage (special thanks to @hopeseekr for getting us near 100% coverage)
+
+ 1.0.7
+ - Added fix_broken_serialization to fix broken serialized strings (Thanks to @hopeseekr via Pull Request #48)
+ - Fixed get_current_url appending port 80 or 443 when not needed (Thanks to @scottchiefbaker via Pull Request #49)
+ - var_dump can now handle recursive data structures without crashing
+ - var_dump code was minified and cleaned up
+ - array_flatten was optimized (thanks to @hopeseekr via Pull Request #47)
+ - remove_accents was completely rewritten and is now ~4x faster
+
+ 1.0.6
+ - Added start_with function
+ - Added ends_with function
+ - Added str_contains function
+ - Added str_icontains function
+ - Added get_file_ext function
+ - Fixing permissions on the files & directories
+ - Fixing a bug with the include path of util.php
+
+ 1.0.5
+ - Issue #29 Fixed error in var_dump if mbstring extension wasn't present
+ - Adding Composer support
+ - Updating license from GPL to MIT
+ - Adding Changelog to project
+ - Bumping minimum version to PHP 5.3.3
+
+ 1.0.4
+ - Issue #22 Removed all superglobal *_get functions, you can use the modified array_get now
+ - Issue #22 Modifed the behaviour of array_get, see documentation
+ - Pull Request #21 Added multibyte support to html* functions
+ - Issue #9 Removed the str_to_utf8 function
+ - Issue #3 Removed the absint function
+ - Removed declare() from util.php to avoid errors
+ - Updated PHPUnit tests to use PHPUnit 3.6
+
+ 1.0.3
+ - Issue #16 Improved performance of slugify
+ - Issue #14 Modified the regex for seems_utf8 to be more accurate
+ - Issue #13 Changed validate_email to be wrapper for filter_var
+ - Added 'ok' to the list of yes words for str_to_bool
+ - str_to_bool matches no followed by any number of 'o's
+
+ 1.0.2
+ - Issue #12 get_current_url now includes the port and user/password if required
+ - Issue #11 human_time_diff now uses the DateTime functions
+ - Issue #10 is_https no longer checks the port as well
+
+ 1.0.1
+ - Issue #7 Added the $trust_proxy_headers parameter to get_client_ip
+ - Issue #6 Removed is_isset as the function did not work as intended
+ - Issue #6 Removed is_empty as it is redundant, use ! with function calls instead
+ - Fixed a bug with get_gravatar
+
+ 1.0.0
+ Initial release of util.php.
+
'; + $done = array(); + $html .= self::var_dump_plain($var, intval($expandLevel), 0, $done); + $html .= ''; + + if (self::$hasArray) { + $html = $jsCode . $html; + } + + if (!$return) { + echo $html; + } + + return $html; + } + + /** + * Display a variable's contents using nice HTML formatting (Without + * the
tag) and will properly display the values of variables
+ * like booleans and resources. Supports collapsable arrays and objects
+ * as well.
+ *
+ * @param mixed $var The variable to dump
+ * @return string
+ */
+ public static function var_dump_plain($var, $expLevel, $depth = 0, $done = array())
+ {
+ $html = '';
+
+ if ($expLevel > 0) {
+ $expLevel--;
+ $setImg = 0;
+ $setStyle = 'display:inline;';
+ } elseif ($expLevel == 0) {
+ $setImg = 1;
+ $setStyle='display:none;';
+ } elseif ($expLevel < 0) {
+ $setImg = 0;
+ $setStyle = 'display:inline;';
+ }
+
+ if (is_bool($var)) {
+ $html .= 'bool(' . (($var) ? 'true' : 'false') . ')';
+ } elseif (is_int($var)) {
+ $html .= 'int(' . $var . ')';
+ } elseif (is_float($var)) {
+ $html .= 'float(' . $var . ')';
+ } elseif (is_string($var)) {
+ $html .= 'string(' . strlen($var) . ') "' . self::htmlentities($var) . '"';
+ } elseif (is_null($var)) {
+ $html .= 'NULL';
+ } elseif (is_resource($var)) {
+ $html .= 'resource("' . get_resource_type($var) . '") "' . $var . '"';
+ } elseif (is_array($var)) {
+ // Check for recursion
+ if ($depth > 0) {
+ foreach ($done as $prev) {
+ if ($prev === $var) {
+ $html .= 'array(' . count($var) . ') *RECURSION DETECTED*';
+ return $html;
+ }
+ }
+
+ // Keep track of variables we have already processed to detect recursion
+ $done[] = &$var;
+ }
+
+ self::$hasArray = true;
+ $uuid = 'include-php-' . uniqid() . mt_rand(1, 1000000);
+
+ $html .= (!empty($var) ? ' 
' : '') . 'array(' . count($var) . ')';
+ if (!empty($var)) {
+ $html .= '
[
';
+
+ $indent = 4;
+ $longest_key = 0;
+
+ foreach ($var as $key => $value) {
+ if (is_string($key)) {
+ $longest_key = max($longest_key, strlen($key) + 2);
+ } else {
+ $longest_key = max($longest_key, strlen($key));
+ }
+ }
+
+ foreach ($var as $key => $value) {
+ if (is_numeric($key)) {
+ $html .= str_repeat(' ', $indent) . str_pad($key, $longest_key, ' ');
+ } else {
+ $html .= str_repeat(' ', $indent) . str_pad('"' . self::htmlentities($key) . '"', $longest_key, ' ');
+ }
+
+ $html .= ' => ';
+
+ $value = explode('
', self::var_dump_plain($value, $expLevel, $depth + 1, $done));
+
+ foreach ($value as $line => $val) {
+ if ($line != 0) {
+ $value[$line] = str_repeat(' ', $indent * 2) . $val;
+ }
+ }
+
+ $html .= implode('
', $value) . '
';
+ }
+
+ $html .= ']';
+ }
+ } elseif (is_object($var)) {
+ // Check for recursion
+ foreach ($done as $prev) {
+ if ($prev === $var) {
+ $html .= 'object(' . get_class($var) . ') *RECURSION DETECTED*';
+ return $html;
+ }
+ }
+
+ // Keep track of variables we have already processed to detect recursion
+ $done[] = &$var;
+
+ self::$hasArray=true;
+ $uuid = 'include-php-' . uniqid() . mt_rand(1, 1000000);
+
+ $html .= ' object(' . get_class($var) . ')
[
';
+
+ $varArray = (array) $var;
+
+ $indent = 4;
+ $longest_key = 0;
+
+ foreach ($varArray as $key => $value) {
+ if (substr($key, 0, 2) == "\0*") {
+ unset($varArray[$key]);
+ $key = 'protected:' . substr($key, 3);
+ $varArray[$key] = $value;
+ } elseif (substr($key, 0, 1) == "\0") {
+ unset($varArray[$key]);
+ $key = 'private:' . substr($key, 1, strpos(substr($key, 1), "\0")) . ':' . substr($key, strpos(substr($key, 1), "\0") + 2);
+ $varArray[$key] = $value;
+ }
+
+ if (is_string($key)) {
+ $longest_key = max($longest_key, strlen($key) + 2);
+ } else {
+ $longest_key = max($longest_key, strlen($key));
+ }
+ }
+
+ foreach ($varArray as $key => $value) {
+ if (is_numeric($key)) {
+ $html .= str_repeat(' ', $indent) . str_pad($key, $longest_key, ' ');
+ } else {
+ $html .= str_repeat(' ', $indent) . str_pad('"' . self::htmlentities($key) . '"', $longest_key, ' ');
+ }
+
+ $html .= ' => ';
+
+ $value = explode('
', self::var_dump_plain($value, $expLevel, $depth + 1, $done));
+
+ foreach ($value as $line => $val) {
+ if ($line != 0) {
+ $value[$line] = str_repeat(' ', $indent * 2) . $val;
+ }
+ }
+
+ $html .= implode('
', $value) . '
';
+ }
+
+ $html .= ']';
+ }
+
+ return $html;
+ }
+
+ /**
+ * Converts any accent characters to their equivalent normal characters
+ * and converts any other non-alphanumeric characters to dashes, then
+ * converts any sequence of two or more dashes to a single dash. This
+ * function generates slugs safe for use as URLs, and if you pass true
+ * as the second parameter, it will create strings safe for use as CSS
+ * classes or IDs.
+ *
+ * @param string $string A string to convert to a slug
+ * @param string $separator The string to separate words with
+ * @param boolean $css_mode Whether or not to generate strings safe for
+ * CSS classes/IDs (Default to false)
+ * @return string
+ */
+ public static function slugify($string, $separator = '-', $css_mode = false)
+ {
+ // Compatibility with 1.0.* parameter ordering for semvar
+ if ($separator === true || $separator === false) {
+ $css_mode = $separator;
+ $separator = '-';
+
+ // Raise deprecation error
+ trigger_error(
+ 'util::slugify() now takes $css_mode as the third parameter, please update your code',
+ E_USER_DEPRECATED
+ );
+ }
+
+ $slug = preg_replace('/([^a-z0-9]+)/', $separator, strtolower(self::remove_accents($string)));
+
+ if ($css_mode) {
+ $digits = array('zero', 'one', 'two', 'three', 'four', 'five', 'six', 'seven', 'eight', 'nine');
+
+ if (is_numeric(substr($slug, 0, 1))) {
+ $slug = $digits[substr($slug, 0, 1)] . substr($slug, 1);
+ }
+ }
+
+ return $slug;
+ }
+
+ /**
+ * Checks to see if a string is utf8 encoded.
+ *
+ * NOTE: This function checks for 5-Byte sequences, UTF8
+ * has Bytes Sequences with a maximum length of 4.
+ *
+ * Written by Tony Ferrara
+ *
+ * @param string $string The string to be checked
+ * @return boolean
+ */
+ public static function seems_utf8($string)
+ {
+ if (function_exists('mb_check_encoding')) {
+ // If mbstring is available, this is significantly faster than
+ // using PHP regexps.
+ return mb_check_encoding($string, 'UTF-8');
+ }
+
+ // @codeCoverageIgnoreStart
+ return self::seemsUtf8Regex($string);
+ // @codeCoverageIgnoreEnd
+ }
+
+ /**
+ * A non-Mbstring UTF-8 checker.
+ *
+ * @param $string
+ * @return bool
+ */
+ protected static function seemsUtf8Regex($string)
+ {
+ // Obtained from http://stackoverflow.com/a/11709412/430062 with permission.
+ $regex = '/(
+ [\xC0-\xC1] # Invalid UTF-8 Bytes
+ | [\xF5-\xFF] # Invalid UTF-8 Bytes
+ | \xE0[\x80-\x9F] # Overlong encoding of prior code point
+ | \xF0[\x80-\x8F] # Overlong encoding of prior code point
+ | [\xC2-\xDF](?![\x80-\xBF]) # Invalid UTF-8 Sequence Start
+ | [\xE0-\xEF](?![\x80-\xBF]{2}) # Invalid UTF-8 Sequence Start
+ | [\xF0-\xF4](?![\x80-\xBF]{3}) # Invalid UTF-8 Sequence Start
+ | (?<=[\x0-\x7F\xF5-\xFF])[\x80-\xBF] # Invalid UTF-8 Sequence Middle
+ | (?
+ *
+ * @param string $brokenSerializedData
+ * @return string
+ */
+ public static function fix_broken_serialization($brokenSerializedData)
+ {
+ $fixdSerializedData = preg_replace_callback('!s:(\d+):"(.*?)";!', function($matches) {
+ $snip = $matches[2];
+ return 's:' . strlen($snip) . ':"' . $snip . '";';
+ }, $brokenSerializedData);
+
+ return $fixdSerializedData;
+ }
+
+ /**
+ * Checks to see if the page is being server over SSL or not
+ *
+ * @return boolean
+ */
+ public static function is_https()
+ {
+ return isset($_SERVER['HTTPS']) && !empty($_SERVER['HTTPS']) && $_SERVER['HTTPS'] != 'off';
+ }
+
+ /**
+ * Add or remove query arguments to the URL.
+ *
+ * @param mixed $newKey Either newkey or an associative array
+ * @param mixed $newValue Either newvalue or oldquery or uri
+ * @param mixed $uri URI or URL to append the queru/queries to.
+ * @return string
+ */
+ public static function add_query_arg($newKey, $newValue = null, $uri = null)
+ {
+ // Was an associative array of key => value pairs passed?
+ if (is_array($newKey)) {
+ $newParams = $newKey;
+
+ // Was the URL passed as an argument?
+ if (!is_null($newValue)) {
+ $uri = $newValue;
+ } elseif (!is_null($uri)) {
+ $uri = $uri;
+ } else {
+ $uri = self::array_get($_SERVER['REQUEST_URI'], '');
+ }
+ } else {
+ $newParams = array($newKey => $newValue);
+
+ // Was the URL passed as an argument?
+ $uri = is_null($uri) ? self::array_get($_SERVER['REQUEST_URI'], '') : $uri;
+ }
+
+ // Parse the URI into it's components
+ $puri = parse_url($uri);
+
+ if (isset($puri['query'])) {
+ parse_str($puri['query'], $queryParams);
+ $queryParams = array_merge($queryParams, $newParams);
+ } elseif (isset($puri['path']) && strstr($puri['path'], '=') !== false) {
+ $puri['query'] = $puri['path'];
+ unset($puri['path']);
+ parse_str($puri['query'], $queryParams);
+ $queryParams = array_merge($queryParams, $newParams);
+ } else {
+ $queryParams = $newParams;
+ }
+
+ // Strip out any query params that are set to false
+ foreach ($queryParams as $param => $value) {
+ if ($value === false) {
+ unset($queryParams[$param]);
+ }
+ }
+
+ // Re-construct the query string
+ $puri['query'] = http_build_query($queryParams);
+
+ // Re-construct the entire URL
+ $nuri = self::http_build_url($puri);
+
+ // Make the URI consistent with our input
+ if ($nuri[0] === '/' && strstr($uri, '/') === false) {
+ $nuri = substr($nuri, 1);
+ }
+
+ if ($nuri[0] === '?' && strstr($uri, '?') === false) {
+ $nuri = substr($nuri, 1);
+ }
+
+ return rtrim($nuri, '?');
+ }
+
+ /**
+ * Removes an item or list from the query string.
+ *
+ * @param string|array $keys Query key or keys to remove.
+ * @param bool $uri When false uses the $_SERVER value
+ * @return string
+ */
+ public static function remove_query_arg($keys, $uri = null)
+ {
+ if (is_array($keys)) {
+ return self::add_query_arg(array_combine($keys, array_fill(0, count($keys), null)), $uri);
+ }
+
+ return self::add_query_arg(array($keys => null), $uri);
+ }
+
+ /**
+ * Build a URL.
+ *
+ * The parts of the second URL will be merged into the first according to
+ * the flags argument.
+ *
+ * @author Jake Smith
+ * @see https://github.com/jakeasmith/http_build_url/
+ *
+ * @param mixed $url (part(s) of) an URL in form of a string or
+ * associative array like parse_url() returns
+ * @param mixed $parts same as the first argument
+ * @param int $flags a bitmask of binary or'ed HTTP_URL constants;
+ * HTTP_URL_REPLACE is the default
+ * @param array $new_url if set, it will be filled with the parts of the
+ * composed url like parse_url() would return
+ * @return string
+ */
+ public static function http_build_url($url, $parts = array(), $flags = self::HTTP_URL_REPLACE, &$new_url = array())
+ {
+ is_array($url) || $url = parse_url($url);
+ is_array($parts) || $parts = parse_url($parts);
+
+ isset($url['query']) && is_string($url['query']) || $url['query'] = null;
+ isset($parts['query']) && is_string($parts['query']) || $parts['query'] = null;
+
+ $keys = array('user', 'pass', 'port', 'path', 'query', 'fragment');
+
+ // HTTP_URL_STRIP_ALL and HTTP_URL_STRIP_AUTH cover several other flags.
+ if ($flags & self::HTTP_URL_STRIP_ALL) {
+ $flags |= self::HTTP_URL_STRIP_USER | self::HTTP_URL_STRIP_PASS
+ | self::HTTP_URL_STRIP_PORT | self::HTTP_URL_STRIP_PATH
+ | self::HTTP_URL_STRIP_QUERY | self::HTTP_URL_STRIP_FRAGMENT;
+ } elseif ($flags & self::HTTP_URL_STRIP_AUTH) {
+ $flags |= self::HTTP_URL_STRIP_USER | self::HTTP_URL_STRIP_PASS;
+ }
+
+ // Schema and host are alwasy replaced
+ foreach (array('scheme', 'host') as $part) {
+ if (isset($parts[$part])) {
+ $url[$part] = $parts[$part];
+ }
+ }
+
+ if ($flags & self::HTTP_URL_REPLACE) {
+ foreach ($keys as $key) {
+ if (isset($parts[$key])) {
+ $url[$key] = $parts[$key];
+ }
+ }
+ } else {
+ if (isset($parts['path']) && ($flags & self::HTTP_URL_JOIN_PATH)) {
+ if (isset($url['path']) && substr($parts['path'], 0, 1) !== '/') {
+ $url['path'] = rtrim(
+ str_replace(basename($url['path']), '', $url['path']),
+ '/'
+ ) . '/' . ltrim($parts['path'], '/');
+ } else {
+ $url['path'] = $parts['path'];
+ }
+ }
+
+ if (isset($parts['query']) && ($flags & self::HTTP_URL_JOIN_QUERY)) {
+ if (isset($url['query'])) {
+ parse_str($url['query'], $url_query);
+ parse_str($parts['query'], $parts_query);
+
+ $url['query'] = http_build_query(
+ array_replace_recursive(
+ $url_query,
+ $parts_query
+ )
+ );
+ } else {
+ $url['query'] = $parts['query'];
+ }
+ }
+ }
+
+ if (isset($url['path']) && substr($url['path'], 0, 1) !== '/') {
+ $url['path'] = '/' . $url['path'];
+ }
+
+ foreach ($keys as $key) {
+ $strip = 'HTTP_URL_STRIP_' . strtoupper($key);
+ if ($flags & constant('utilphp\\util::' . $strip)) {
+ unset($url[$key]);
+ }
+ }
+
+ $parsed_string = '';
+
+ if (isset($url['scheme'])) {
+ $parsed_string .= $url['scheme'] . '://';
+ }
+
+ if (isset($url['user'])) {
+ $parsed_string .= $url['user'];
+
+ if (isset($url['pass'])) {
+ $parsed_string .= ':' . $url['pass'];
+ }
+
+ $parsed_string .= '@';
+ }
+
+ if (isset($url['host'])) {
+ $parsed_string .= $url['host'];
+ }
+
+ if (isset($url['port'])) {
+ $parsed_string .= ':' . $url['port'];
+ }
+
+ if (!empty($url['path'])) {
+ $parsed_string .= $url['path'];
+ } else {
+ $parsed_string .= '/';
+ }
+
+ if (isset($url['query'])) {
+ $parsed_string .= '?' . $url['query'];
+ }
+
+ if (isset($url['fragment'])) {
+ $parsed_string .= '#' . $url['fragment'];
+ }
+
+ $new_url = $url;
+
+ return $parsed_string;
+ }
+
+ /**
+ * Converts many english words that equate to true or false to boolean.
+ *
+ * Supports 'y', 'n', 'yes', 'no' and a few other variations.
+ *
+ * @param string $string The string to convert to boolean
+ * @param bool $default The value to return if we can't match any
+ * yes/no words
+ * @return boolean
+ */
+ public static function str_to_bool($string, $default = false)
+ {
+ $yes_words = 'affirmative|all right|aye|indubitably|most assuredly|ok|of course|okay|sure thing|y|yes+|yea|yep|sure|yeah|true|t|on|1|oui|vrai';
+ $no_words = 'no*|no way|nope|nah|na|never|absolutely not|by no means|negative|never ever|false|f|off|0|non|faux';
+
+ if (preg_match('/^(' . $yes_words . ')$/i', $string)) {
+ return true;
+ } elseif (preg_match('/^(' . $no_words . ')$/i', $string)) {
+ return false;
+ }
+
+ return $default;
+ }
+
+ /**
+ * Check if a string starts with the given string.
+ *
+ * @param string $string
+ * @param string $starts_with
+ * @return boolean
+ */
+ public static function starts_with($string, $starts_with)
+ {
+ return strpos($string, $starts_with) === 0;
+ }
+
+ /**
+ * Check if a string ends with the given string.
+ *
+ * @param string $string
+ * @param string $starts_with
+ * @return boolean
+ */
+ public static function ends_with($string, $ends_with)
+ {
+ return substr($string, -strlen($ends_with)) === $ends_with;
+ }
+
+ /**
+ * Check if a string contains another string.
+ *
+ * @param string $haystack
+ * @param string $needle
+ * @return boolean
+ */
+ public static function str_contains($haystack, $needle)
+ {
+ return strpos($haystack, $needle) !== false;
+ }
+
+ /**
+ * Check if a string contains another string. This version is case
+ * insensitive.
+ *
+ * @param string $haystack
+ * @param string $needle
+ * @return boolean
+ */
+ public static function str_icontains($haystack, $needle)
+ {
+ return stripos($haystack, $needle) !== false;
+ }
+
+ /**
+ * Return the file extension of the given filename.
+ *
+ * @param string $filename
+ * @return string
+ */
+ public static function get_file_ext($filename)
+ {
+ return pathinfo($filename, PATHINFO_EXTENSION);
+ }
+
+ /**
+ * Removes a directory (and its contents) recursively.
+ *
+ * Contributed by Askar (ARACOOL)
+ *
+ * @param string $dir The directory to be deleted recursively
+ * @param bool $traverseSymlinks Delete contents of symlinks recursively
+ * @return bool
+ * @throws \RuntimeException
+ */
+ public static function rmdir($dir, $traverseSymlinks = false)
+ {
+ if (!file_exists($dir)) {
+ return true;
+ } elseif (!is_dir($dir)) {
+ throw new \RuntimeException('Given path is not a directory');
+ }
+
+ if (!is_link($dir) || $traverseSymlinks) {
+ foreach (scandir($dir) as $file) {
+ if ($file === '.' || $file === '..') {
+ continue;
+ }
+
+ $currentPath = $dir . '/' . $file;
+
+ if (is_dir($currentPath)) {
+ self::rmdir($currentPath, $traverseSymlinks);
+ } elseif (!unlink($currentPath)) {
+ // @codeCoverageIgnoreStart
+ throw new \RuntimeException('Unable to delete ' . $currentPath);
+ // @codeCoverageIgnoreEnd
+ }
+ }
+ }
+
+ // Windows treats removing directory symlinks identically to removing directories.
+ if (is_link($dir) && !defined('PHP_WINDOWS_VERSION_MAJOR')) {
+ if (!unlink($dir)) {
+ // @codeCoverageIgnoreStart
+ throw new \RuntimeException('Unable to delete ' . $dir);
+ // @codeCoverageIgnoreEnd
+ }
+ } else {
+ if (!rmdir($dir)) {
+ // @codeCoverageIgnoreStart
+ throw new \RuntimeException('Unable to delete ' . $dir);
+ // @codeCoverageIgnoreEnd
+ }
+ }
+
+ return true;
+ }
+
+ /**
+ * Convert entities, while preserving already-encoded entities.
+ *
+ * @param string $string The text to be converted
+ * @return string
+ */
+ public static function htmlentities($string, $preserve_encoded_entities = false)
+ {
+ if ($preserve_encoded_entities) {
+ // @codeCoverageIgnoreStart
+ if (defined('HHVM_VERSION')) {
+ $translation_table = get_html_translation_table(HTML_ENTITIES, ENT_QUOTES);
+ } else {
+ $translation_table = get_html_translation_table(HTML_ENTITIES, ENT_QUOTES, self::mbInternalEncoding());
+ }
+ // @codeCoverageIgnoreEnd
+
+ $translation_table[chr(38)] = '&';
+ return preg_replace('/&(?![A-Za-z]{0,4}\w{2,3};|#[0-9]{2,3};)/', '&', strtr($string, $translation_table));
+ }
+
+ return htmlentities($string, ENT_QUOTES, self::mbInternalEncoding());
+ }
+
+ /**
+ * Convert >, <, ', " and & to html entities, but preserves entities that
+ * are already encoded.
+ *
+ * @param string $string The text to be converted
+ * @return string
+ */
+ public static function htmlspecialchars($string, $preserve_encoded_entities = false)
+ {
+ if ($preserve_encoded_entities) {
+ // @codeCoverageIgnoreStart
+ if (defined('HHVM_VERSION')) {
+ $translation_table = get_html_translation_table(HTML_SPECIALCHARS, ENT_QUOTES);
+ } else {
+ $translation_table = get_html_translation_table(HTML_SPECIALCHARS, ENT_QUOTES, self::mbInternalEncoding());
+ }
+ // @codeCoverageIgnoreEnd
+
+ $translation_table[chr(38)] = '&';
+
+ return preg_replace('/&(?![A-Za-z]{0,4}\w{2,3};|#[0-9]{2,3};)/', '&', strtr($string, $translation_table));
+ }
+
+ return htmlentities($string, ENT_QUOTES, self::mbInternalEncoding());
+ }
+
+ /**
+ * Transliterates characters to their ASCII equivalents.
+ *
+ * Part of the URLify.php Project
+ *
+ * @param int $length length of string
+ * @return bool
+ */
+ public static function secure_random_string($length = 16)
+ {
+ if (function_exists('openssl_random_pseudo_bytes')) {
+ $bytes = openssl_random_pseudo_bytes($length * 2);
+
+ if ($bytes === false) {
+ throw new \LengthException('$length is not accurate, unable to generate random string');
+ }
+
+ return substr(str_replace(array('/', '+', '='), '', base64_encode($bytes)), 0, $length);
+ }
+
+ // @codeCoverageIgnoreStart
+ return static::random_string($length);
+ // @codeCoverageIgnoreEnd
+ }
+
+ /**
+ * Check if a given string matches a given pattern.
+ *
+ * Contributed by Abhimanyu Sharma
+ *
+ * @param string $pattern Parttern of string exptected
+ * @param string $string String that need to be matched
+ * @return bool
+ */
+ public static function match_string($pattern, $string, $caseSensitive = true)
+ {
+ if ($pattern == $string) {
+ return true;
+ }
+
+ // Preg flags
+ $flags = $caseSensitive ? '' : 'i';
+
+ // Escape any regex special characters
+ $pattern = preg_quote($pattern, '#');
+
+ // Unescape * which is our wildcard character and change it to .*
+ $pattern = str_replace('\*', '.*', $pattern);
+
+ return (bool) preg_match('#^' . $pattern . '$#' . $flags, $string);
+ }
+
+ /**
+ * Validate an email address.
+ *
+ * @param string $possible_email An email address to validate
+ * @return bool
+ */
+ public static function validate_email($possible_email)
+ {
+ return (bool) filter_var($possible_email, FILTER_VALIDATE_EMAIL);
+ }
+
+ /**
+ * Return the URL to a user's gravatar.
+ *
+ * @param string $email The email of the user
+ * @param integer $size The size of the gravatar
+ * @return string
+ */
+ public static function get_gravatar($email, $size = 32)
+ {
+ if (self::is_https()) {
+ $url = 'https://secure.gravatar.com/';
+ } else {
+ $url = 'http://www.gravatar.com/';
+ }
+
+ $url .= 'avatar/' . md5($email) . '?s=' . (int) abs($size);
+
+ return $url;
+ }
+
+ /**
+ * Turns all of the links in a string into HTML links.
+ *
+ * Part of the LinkifyURL Project
+ *
+ * @param string $text The string to parse
+ * @return string
+ */
+ public static function linkify($text)
+ {
+ $text = preg_replace('/'/', ''', $text); // IE does not handle ' entity!
+ $section_html_pattern = '%# Rev:20100913_0900 github.com/jmrware/LinkifyURL
+ # Section text into HTML tags and everything else.
+ ( # $1: Everything not HTML tag.
+ [^<]+(?:(?!... tag.
+ ]*> # opening tag.
+ [^<]*(?:(?! # closing tag.
+ ) # End $2:
+ %ix';
+
+ return preg_replace_callback($section_html_pattern, array(__CLASS__, 'linkifyCallback'), $text);
+ }
+
+ /**
+ * Callback for the preg_replace in the linkify() method.
+ *
+ * Part of the LinkifyURL Project
+ *
+ * @param array $matches Matches from the preg_ function
+ * @return string
+ */
+ protected static function linkifyRegex($text)
+ {
+ $url_pattern = '/# Rev:20100913_0900 github.com\/jmrware\/LinkifyURL
+ # Match http & ftp URL that is not already linkified.
+ # Alternative 1: URL delimited by (parentheses).
+ (\() # $1 "(" start delimiter.
+ ((?:ht|f)tps?:\/\/[a-z0-9\-._~!$&\'()*+,;=:\/?#[\]@%]+) # $2: URL.
+ (\)) # $3: ")" end delimiter.
+ | # Alternative 2: URL delimited by [square brackets].
+ (\[) # $4: "[" start delimiter.
+ ((?:ht|f)tps?:\/\/[a-z0-9\-._~!$&\'()*+,;=:\/?#[\]@%]+) # $5: URL.
+ (\]) # $6: "]" end delimiter.
+ | # Alternative 3: URL delimited by {curly braces}.
+ (\{) # $7: "{" start delimiter.
+ ((?:ht|f)tps?:\/\/[a-z0-9\-._~!$&\'()*+,;=:\/?#[\]@%]+) # $8: URL.
+ (\}) # $9: "}" end delimiter.
+ | # Alternative 4: URL delimited by .
+ (<|&(?:lt|\#60|\#x3c);) # $10: "<" start delimiter (or HTML entity).
+ ((?:ht|f)tps?:\/\/[a-z0-9\-._~!$&\'()*+,;=:\/?#[\]@%]+) # $11: URL.
+ (>|&(?:gt|\#62|\#x3e);) # $12: ">" end delimiter (or HTML entity).
+ | # Alternative 5: URL not delimited by (), [], {} or <>.
+ (# $13: Prefix proving URL not already linked.
+ (?: ^ # Can be a beginning of line or string, or
+ | [^=\s\'"\]] # a non-"=", non-quote, non-"]", followed by
+ ) \s*[\'"]? # optional whitespace and optional quote;
+ | [^=\s]\s+ # or... a non-equals sign followed by whitespace.
+ ) # End $13. Non-prelinkified-proof prefix.
+ (\b # $14: Other non-delimited URL.
+ (?:ht|f)tps?:\/\/ # Required literal http, https, ftp or ftps prefix.
+ [a-z0-9\-._~!$\'()*+,;=:\/?#[\]@%]+ # All URI chars except "&" (normal*).
+ (?: # Either on a "&" or at the end of URI.
+ (?! # Allow a "&" char only if not start of an...
+ &(?:gt|\#0*62|\#x0*3e); # HTML ">" entity, or
+ | &(?:amp|apos|quot|\#0*3[49]|\#x0*2[27]); # a [&\'"] entity if
+ [.!&\',:?;]? # followed by optional punctuation then
+ (?:[^a-z0-9\-._~!$&\'()*+,;=:\/?#[\]@%]|$) # a non-URI char or EOS.
+ ) & # If neg-assertion true, match "&" (special).
+ [a-z0-9\-._~!$\'()*+,;=:\/?#[\]@%]* # More non-& URI chars (normal*).
+ )* # Unroll-the-loop (special normal*)*.
+ [a-z0-9\-_~$()*+=\/#[\]@%] # Last char can\'t be [.!&\',;:?]
+ ) # End $14. Other non-delimited URL.
+ /imx';
+
+ $url_replace = '$1$4$7$10$13$2$5$8$11$14$3$6$9$12';
+
+ return preg_replace($url_pattern, $url_replace, $text);
+ }
+
+ /**
+ * Callback for the preg_replace in the linkify() method.
+ *
+ * Part of the LinkifyURL Project
+ *
+ * @param array $matches Matches from the preg_ function
+ * @return string
+ */
+ protected static function linkifyCallback($matches)
+ {
+ if (isset($matches[2])) {
+ return $matches[2];
+ }
+
+ return self::linkifyRegex($matches[1]);
+ }
+
+ /**
+ * Return the current URL.
+ *
+ * @return string
+ */
+ public static function get_current_url()
+ {
+ $url = '';
+
+ // Check to see if it's over https
+ $is_https = self::is_https();
+ if ($is_https) {
+ $url .= 'https://';
+ } else {
+ $url .= 'http://';
+ }
+
+ // Was a username or password passed?
+ if (isset($_SERVER['PHP_AUTH_USER'])) {
+ $url .= $_SERVER['PHP_AUTH_USER'];
+
+ if (isset($_SERVER['PHP_AUTH_PW'])) {
+ $url .= ':' . $_SERVER['PHP_AUTH_PW'];
+ }
+
+ $url .= '@';
+ }
+
+
+ // We want the user to stay on the same host they are currently on,
+ // but beware of security issues
+ // see http://shiflett.org/blog/2006/mar/server-name-versus-http-host
+ $url .= $_SERVER['HTTP_HOST'];
+
+ $port = $_SERVER['SERVER_PORT'];
+
+ // Is it on a non standard port?
+ if ($is_https && ($port != 443)) {
+ $url .= ':' . $_SERVER['SERVER_PORT'];
+ } elseif (!$is_https && ($port != 80)) {
+ $url .= ':' . $_SERVER['SERVER_PORT'];
+ }
+
+ // Get the rest of the URL
+ if (!isset($_SERVER['REQUEST_URI'])) {
+ // Microsoft IIS doesn't set REQUEST_URI by default
+ $url .= $_SERVER['PHP_SELF'];
+
+ if (isset($_SERVER['QUERY_STRING'])) {
+ $url .= '?' . $_SERVER['QUERY_STRING'];
+ }
+ } else {
+ $url .= $_SERVER['REQUEST_URI'];
+ }
+
+ return $url;
+ }
+
+ /**
+ * Returns the IP address of the client.
+ *
+ * @param boolean $trust_proxy_headers Whether or not to trust the
+ * proxy headers HTTP_CLIENT_IP
+ * and HTTP_X_FORWARDED_FOR. ONLY
+ * use if your server is behind a
+ * proxy that sets these values
+ * @return string
+ */
+ public static function get_client_ip($trust_proxy_headers = false)
+ {
+ if (!$trust_proxy_headers) {
+ return $_SERVER['REMOTE_ADDR'];
+ }
+
+ if (!empty($_SERVER['HTTP_CLIENT_IP'])) {
+ $ip = $_SERVER['HTTP_CLIENT_IP'];
+ } elseif (!empty($_SERVER['HTTP_X_FORWARDED_FOR'])) {
+ $ip = $_SERVER['HTTP_X_FORWARDED_FOR'];
+ } else {
+ $ip = $_SERVER['REMOTE_ADDR'];
+ }
+
+ return $ip;
+ }
+
+ /**
+ * Truncate a string to a specified length without cutting a word off.
+ *
+ * @param string $string The string to truncate
+ * @param integer $length The length to truncate the string to
+ * @param string $append Text to append to the string IF it gets
+ * truncated, defaults to '...'
+ * @return string
+ */
+ public static function safe_truncate($string, $length, $append = '...')
+ {
+ $ret = substr($string, 0, $length);
+ $last_space = strrpos($ret, ' ');
+
+ if ($last_space !== false && $string != $ret) {
+ $ret = substr($ret, 0, $last_space);
+ }
+
+ if ($ret != $string) {
+ $ret .= $append;
+ }
+
+ return $ret;
+ }
+
+
+ /**
+ * Truncate the string to given length of charactes.
+ *
+ * @param $string
+ * @param $limit
+ * @param string $append
+ * @return string
+ */
+ public static function limit_characters($string, $limit = 100, $append = '...')
+ {
+ if (mb_strlen($string) <= $limit) {
+ return $string;
+ }
+
+ return rtrim(mb_substr($string, 0, $limit, 'UTF-8')) . $append;
+ }
+
+ /**
+ * Truncate the string to given length of words.
+ *
+ * @param $string
+ * @param $limit
+ * @param string $append
+ * @return string
+ */
+ public static function limit_words($string, $limit = 100, $append = '...')
+ {
+ preg_match('/^\s*+(?:\S++\s*+){1,' . $limit . '}/u', $string, $matches);
+
+ if (!isset($matches[0]) || strlen($string) === strlen($matches[0])) {
+ return $string;
+ }
+
+ return rtrim($matches[0]).$append;
+ }
+
+ /**
+ * Returns the ordinal version of a number (appends th, st, nd, rd).
+ *
+ * @param string $number The number to append an ordinal suffix to
+ * @return string
+ */
+ public static function ordinal($number)
+ {
+ $test_c = abs($number) % 10;
+ $ext = ((abs($number) % 100 < 21 && abs($number) % 100 > 4) ? 'th' : (($test_c < 4) ? ($test_c < 3) ? ($test_c < 2) ? ($test_c < 1) ? 'th' : 'st' : 'nd' : 'rd' : 'th'));
+
+ return $number . $ext;
+ }
+
+ /**
+ * Returns the file permissions as a nice string, like -rw-r--r-- or false
+ * if the file is not found.
+ *
+ * @param string $file The name of the file to get permissions form
+ * @param int $perms Numerical value of permissions to display as text.
+ * @return string
+ */
+ public static function full_permissions($file, $perms = null)
+ {
+ if (is_null($perms)) {
+ if (!file_exists($file)) {
+ return false;
+ }
+ $perms = fileperms($file);
+ }
+
+ if (($perms & 0xC000) == 0xC000) {
+ // Socket
+ $info = 's';
+ } elseif (($perms & 0xA000) == 0xA000) {
+ // Symbolic Link
+ $info = 'l';
+ } elseif (($perms & 0x8000) == 0x8000) {
+ // Regular
+ $info = '-';
+ } elseif (($perms & 0x6000) == 0x6000) {
+ // Block special
+ $info = 'b';
+ } elseif (($perms & 0x4000) == 0x4000) {
+ // Directory
+ $info = 'd';
+ } elseif (($perms & 0x2000) == 0x2000) {
+ // Character special
+ $info = 'c';
+ } elseif (($perms & 0x1000) == 0x1000) {
+ // FIFO pipe
+ $info = 'p';
+ } else {
+ // Unknown
+ $info = 'u';
+ }
+
+ // Owner
+ $info .= (($perms & 0x0100) ? 'r' : '-');
+ $info .= (($perms & 0x0080) ? 'w' : '-');
+ $info .= (($perms & 0x0040) ?
+ (($perms & 0x0800) ? 's' : 'x') :
+ (($perms & 0x0800) ? 'S' : '-'));
+
+ // Group
+ $info .= (($perms & 0x0020) ? 'r' : '-');
+ $info .= (($perms & 0x0010) ? 'w' : '-');
+ $info .= (($perms & 0x0008) ?
+ (($perms & 0x0400) ? 's' : 'x') :
+ (($perms & 0x0400) ? 'S' : '-'));
+
+ // World
+ $info .= (($perms & 0x0004) ? 'r' : '-');
+ $info .= (($perms & 0x0002) ? 'w' : '-');
+ $info .= (($perms & 0x0001) ?
+ (($perms & 0x0200) ? 't' : 'x') :
+ (($perms & 0x0200) ? 'T' : '-'));
+
+ return $info;
+ }
+
+ /**
+ * Returns the first element in an array.
+ *
+ * @param array $array
+ * @return mixed
+ */
+ public static function array_first(array $array)
+ {
+ return reset($array);
+ }
+
+ /**
+ * Returns the last element in an array.
+ *
+ * @param array $array
+ * @return mixed
+ */
+ public static function array_last(array $array)
+ {
+ return end($array);
+ }
+
+ /**
+ * Returns the first key in an array.
+ *
+ * @param array $array
+ * @return int|string
+ */
+ public static function array_first_key(array $array)
+ {
+ reset($array);
+
+ return key($array);
+ }
+
+ /**
+ * Returns the last key in an array.
+ *
+ * @param array $array
+ * @return int|string
+ */
+ public static function array_last_key(array $array)
+ {
+ end($array);
+
+ return key($array);
+ }
+
+ /**
+ * Flatten a multi-dimensional array into a one dimensional array.
+ *
+ * Contributed by Theodore R. Smith of PHP Experts, Inc.
+ * @since 1.0.000
+ */
+class UtilityPHPTest extends PHPUnit_Framework_TestCase
+{
+ /**
+ * Allows for the testing of private and protected methods.
+ *
+ * @param $name
+ * @return \ReflectionMethod
+ */
+ protected static function getMethod($name)
+ {
+ $class = new \ReflectionClass('util');
+ $method = $class->getMethod($name);
+ $method->setAccessible(true);
+ return $method;
+ }
+
+ public function test_array_get()
+ {
+ $_GET = array();
+ $_GET['abc'] = 'def';
+ $_GET['nested'] = array( 'key1' => 'val1', 'key2' => 'val2', 'key3' => 'val3' );
+
+ // Looks for $array['abc']
+ $this->assertEquals( 'def', util::array_get( $_GET['abc'] ) );
+
+ // Looks for $array['nested']['key2']
+ $this->assertEquals( 'val2', util::array_get( $_GET['nested']['key2'] ) );
+
+ // Looks for $array['doesnotexist']
+ $this->assertEquals( 'defaultval', util::array_get( $_GET['doesnotexist'], 'defaultval' ) );
+ }
+
+ public function test_slugify()
+ {
+ $this->assertEquals( 'a-simple-title', util::slugify( 'A simple title' ) );
+ $this->assertEquals( 'this-post-it-has-a-dash', util::slugify( 'This post -- it has a dash' ) );
+ $this->assertEquals( '123-1251251', util::slugify( '123----1251251' ) );
+ $this->assertEquals( 'one23-1251251', util::slugify( '123----1251251', '-', true ) );
+
+ $this->assertEquals( 'a-simple-title', util::slugify( 'A simple title', '-' ) );
+ $this->assertEquals( 'this-post-it-has-a-dash', util::slugify( 'This post -- it has a dash', '-' ) );
+ $this->assertEquals( '123-1251251', util::slugify( '123----1251251', '-' ) );
+ $this->assertEquals( 'one23-1251251', util::slugify( '123----1251251', '-', true ) );
+
+ $this->assertEquals( 'a_simple_title', util::slugify( 'A simple title', '_' ) );
+ $this->assertEquals( 'this_post_it_has_a_dash', util::slugify( 'This post -- it has a dash', '_' ) );
+ $this->assertEquals( '123_1251251', util::slugify( '123----1251251', '_' ) );
+ $this->assertEquals( 'one23_1251251', util::slugify( '123----1251251', '_', true ) );
+
+ // Blank seperator test
+ $this->assertEquals( 'asimpletitle', util::slugify( 'A simple title', '' ) );
+ $this->assertEquals( 'thispostithasadash', util::slugify( 'This post -- it has a dash', '' ) );
+ $this->assertEquals( '1231251251', util::slugify( '123----1251251', '' ) );
+ $this->assertEquals( 'one231251251', util::slugify( '123----1251251', '', true ) );
+
+ // Test old parameter ordering for backwards compatability
+ error_reporting(E_ALL ^ E_USER_DEPRECATED);
+ $this->assertEquals( 'one23-1251251', util::slugify( '123----1251251', true ) );
+ $this->assertEquals( '123-1251251', util::slugify( '123----1251251', false ) );
+ }
+
+ public function test_seems_utf8()
+ {
+ // Test a valid UTF-8 sequence: "ÜTF-8 Fµñ".
+ $validUTF8 = "\xC3\x9CTF-8 F\xC2\xB5\xC3\xB1";
+ $this->assertTrue( util::seems_utf8( $validUTF8 ) );
+
+ $this->assertTrue( util::seems_utf8( "\xEF\xBF\xBD this has \xEF\xBF\xBD\xEF\xBF\xBD some invalid utf8 \xEF\xBF\xBD" ) );
+
+ // Test invalid UTF-8 sequences
+ $invalidUTF8 = "\xc3 this has \xe6\x9d some invalid utf8 \xe6";
+ $this->assertFalse( util::seems_utf8( $invalidUTF8 ) );
+
+ // And test some plain ASCII
+ $this->assertTrue( util::seems_utf8( 'The quick brown fox jumps over the lazy dog' ) );
+
+ // Test an invalid non-UTF-8 string.
+ if (function_exists('mb_convert_encoding')) {
+ mb_internal_encoding('UTF-8');
+ // Converts the 'ç' UTF-8 character to UCS-2LE
+ $utf8Char = pack('n', 50087);
+ $ucsChar = mb_convert_encoding($utf8Char, 'UCS-2LE', 'UTF-8');
+
+ // Ensure that PHP's internal encoding system isn't malconfigured.
+ $this->assertEquals( $utf8Char, 'ç', 'This PHP system\'s internal character set is not properly set as UTF-8.' );
+ $this->assertEquals( $utf8Char, pack('n', 50087), 'Something is wrong with your ICU unicode library.' );
+
+ // Test for not UTF-8.
+ $this->assertFalse( util::seems_utf8( $ucsChar) );
+
+ // Test the worker method.
+ $method = self::getMethod('seemsUtf8Regex');
+ $this->assertFalse($method->invoke(null, $invalidUTF8), 'util::seemsUtf8Regex did not properly detect invalid UTF-8.');
+ $this->assertTrue($method->invoke(null, $validUTF8), 'util::seemsUtf8Regex did not properly detect valid UTF-8.');
+ }
+ }
+
+ public function test_size_format()
+ {
+ $size = util::size_format( 512, 0 );
+ $this->assertEquals( '512 B', $size );
+
+ $size = util::size_format( 2048, 1 );
+ $this->assertEquals( '2.0 KiB', $size );
+
+ $size = util::size_format( 25151251, 2 );
+ $this->assertEquals( '23.99 MiB', $size );
+
+ $size = util::size_format( 19971597926, 2 );
+ $this->assertEquals( '18.60 GiB', $size );
+
+ $size = util::size_format( 2748779069440, 1 );
+ $this->assertEquals( '2.5 TiB', $size );
+
+ $size = util::size_format( 2.81475e15, 1 );
+ $this->assertEquals( '2.5 PiB', $size );
+
+ $size = util::size_format( 2.81475e19, 1 );
+ $this->assertEquals( '25000.0 PiB', $size );
+ }
+
+ public function test_maybe_serialize()
+ {
+ $obj = new stdClass();
+ $obj->prop1 = 'Hello';
+ $obj->prop2 = 'World';
+
+ $this->assertEquals( 'This is a string', util::maybe_serialize( 'This is a string' ) );
+ $this->assertEquals( 5.81, util::maybe_serialize( 5.81 ) );
+ $this->assertEquals( 'a:0:{}', util::maybe_serialize( array() ) );
+ $this->assertEquals( 'O:8:"stdClass":2:{s:5:"prop1";s:5:"Hello";s:5:"prop2";s:5:"World";}', util::maybe_serialize( $obj ) );
+ $this->assertEquals( 'a:4:{i:0;s:4:"test";i:1;s:4:"blah";s:5:"hello";s:5:"world";s:5:"array";O:8:"stdClass":2:{s:5:"prop1";s:5:"Hello";s:5:"prop2";s:5:"World";}}', util::maybe_serialize( array( 'test', 'blah', 'hello' => 'world', 'array' => $obj ) ) );
+ }
+
+ public function test_maybe_unserialize()
+ {
+ $obj = new stdClass();
+ $obj->prop1 = 'Hello';
+ $obj->prop2 = 'World';
+
+ $this->assertNull(util::maybe_unserialize(serialize(null)));
+ $this->assertFalse(util::maybe_unserialize(serialize(false)));
+
+ $this->assertEquals( 'This is a string', util::maybe_unserialize( 'This is a string' ) );
+ $this->assertEquals( 5.81, util::maybe_unserialize( 5.81 ) );
+ $this->assertEquals( array(), util::maybe_unserialize( 'a:0:{}' ) );
+ $this->assertEquals( $obj, util::maybe_unserialize( 'O:8:"stdClass":2:{s:5:"prop1";s:5:"Hello";s:5:"prop2";s:5:"World";}' ) );
+ $this->assertEquals( array( 'test', 'blah', 'hello' => 'world', 'array' => $obj ), util::maybe_unserialize( 'a:4:{i:0;s:4:"test";i:1;s:4:"blah";s:5:"hello";s:5:"world";s:5:"array";O:8:"stdClass":2:{s:5:"prop1";s:5:"Hello";s:5:"prop2";s:5:"World";}}' ) );
+
+ // Test a broken serialization.
+ $expectedData = array(
+ 'Normal',
+ 'High-value Char: '.chr(231).'a-va?', // High-value Char: ça-va? [in ISO-8859-1]
+ );
+
+ $brokenSerialization = 'a:2:{i:0;s:6:"Normal";i:1;s:23:"High-value Char: ▒a-va?";}';
+
+ $unserializedData = util::maybe_unserialize($brokenSerialization);
+ $this->assertEquals($expectedData[0], $unserializedData[0], 'Did not properly fix the broken serialized data.');
+ $this->assertEquals(substr($expectedData[1], 0, 10), substr($unserializedData[1], 0, 10), 'Did not properly fix the broken serialized data.');
+
+ // Test unfixable serialization.
+ $unfixableSerialization = 'a:2:{i:0;s:6:"Normal";}';
+ $this->assertEquals($unfixableSerialization, util::maybe_unserialize($unfixableSerialization), 'Somehow the [previously?] impossible happened and utilphp thinks it has unserialized an unfixable serialization.');
+ }
+
+ public function test_is_serialized()
+ {
+ $this->assertFalse( util::is_serialized(1) );
+ $this->assertFalse( util::is_serialized(null) );
+ $this->assertFalse( util::is_serialized( 's:4:"test;' ) );
+ $this->assertFalse( util::is_serialized( 'a:0:{}!' ) );
+ $this->assertFalse( util::is_serialized( 'a:0' ) );
+ $this->assertFalse( util::is_serialized( 'This is a string' ) );
+ $this->assertFalse( util::is_serialized( 'a string' ) );
+ $this->assertFalse( util::is_serialized( 'z:0;' ) );
+ $this->assertTrue( util::is_serialized( 'N;' ) );
+ $this->assertTrue( util::is_serialized( 'b:1;' ) );
+ $this->assertTrue( util::is_serialized( 'a:0:{}' ) );
+ $this->assertTrue( util::is_serialized( 'O:8:"stdClass":2:{s:5:"prop1";s:5:"Hello";s:5:"prop2";s:5:"World";}' ) );
+ }
+
+ public function test_fix_broken_serialization()
+ {
+ $expectedData = array(
+ 'Normal',
+ 'High-value Char: '.chr(231).'a-va?', // High-value Char: ça-va? [in ISO-8859-1]
+ );
+
+ $brokenSerialization = 'a:2:{i:0;s:6:"Normal";i:1;s:23:"High-value Char: ▒a-va?";}';
+
+ // Temporarily override error handling to ensure that this is, in fact, [still] a broken serialization.
+ {
+ $expectedError = array(
+ 'errno' => 8,
+ 'errstr' => 'unserialize(): Error at offset 55 of 60 bytes'
+ );
+
+ $reportedError = array();
+ set_error_handler(function ($errno, $errstr, $errfile, $errline, $errcontext) use (&$reportedError) {
+ $reportedError = compact('errno', 'errstr');
+ });
+
+ unserialize($brokenSerialization);
+
+ $this->assertEquals($expectedError['errno'], $reportedError['errno']);
+ // Because HHVM's unserialize() error message does not contain enough info to properly test.
+ if (!defined('HHVM_VERSION')) {
+ $this->assertEquals($expectedError['errstr'], $reportedError['errstr']);
+ }
+ restore_error_handler();
+ }
+
+ $fixedSerialization = util::fix_broken_serialization($brokenSerialization);
+ $unserializedData = unserialize($fixedSerialization);
+ $this->assertEquals($expectedData[0], $unserializedData[0], 'Did not properly fix the broken serialized data.');
+
+ $this->assertEquals(substr($expectedData[1], 0, 10), substr($unserializedData[1], 0, 10), 'Did not properly fix the broken serialized data.');
+ }
+
+ public function test_is_https()
+ {
+ $_SERVER['HTTPS'] = null;
+
+ $this->assertFalse( util::is_https() );
+
+ $_SERVER['HTTPS'] = 'on';
+
+ $this->assertTrue( util::is_https() );
+ }
+
+ public function test_add_query_arg()
+ {
+ // Regular tests
+ $this->assertEquals( '/app/admin/users?user=5', util::add_query_arg( 'user', 5, '/app/admin/users' ) );
+ $this->assertEquals( '/app/admin/users?user=5', util::add_query_arg( array( 'user' => 5 ), '/app/admin/users' ) );
+ $this->assertEquals( '/app/admin/users?user=5', util::add_query_arg( array( 'user' => 5 ), null, '/app/admin/users' ) );
+ $this->assertEquals( '/app/admin/users?action=edit&user=5', util::add_query_arg( 'user', 5, '/app/admin/users?action=edit' ) );
+ $this->assertEquals( '/app/admin/users?action=edit&user=5', util::add_query_arg( array( 'user' => 5 ), '/app/admin/users?action=edit' ) );
+ $this->assertEquals( '/app/admin/users?action=edit&tab=personal&user=5', util::add_query_arg( 'user', 5, '/app/admin/users?action=edit&tab=personal' ) );
+ $this->assertEquals( '/app/admin/users?action=edit&tab=personal&user=5', util::add_query_arg( array( 'user' => 5 ), '/app/admin/users?action=edit&tab=personal' ) );
+
+ // Ensure strips false.
+ $this->assertEquals('/index.php', util::add_query_arg('debug', false, '/index.php'));
+
+ // With a URL fragment
+ $this->assertEquals( '/app/admin/users?user=5#test', util::add_query_arg( 'user', 5, '/app/admin/users#test' ) );
+
+ // Full URL
+ $this->assertEquals( 'http://example.com/?a=b', util::add_query_arg( 'a', 'b', 'http://example.com' ) );
+
+ // Only the query string
+ $this->assertEquals( '?a=b&c=d', util::add_query_arg( 'c', 'd', '?a=b' ) );
+ $this->assertEquals( 'a=b&c=d', util::add_query_arg( 'c', 'd', 'a=b' ) );
+
+ // Url encoding test
+ $this->assertEquals( '/app/admin/users?param=containsa%26sym', util::add_query_arg( 'param', 'containsa&sym', '/app/admin/users' ) );
+
+ // If not provided, grab the URI from the server.
+ $_SERVER['REQUEST_URI'] = '/app/admin/users';
+ $this->assertEquals( '/app/admin/users?user=6', util::add_query_arg( array( 'user' => 6 ) ) );
+ $this->assertEquals( '/app/admin/users?user=7', util::add_query_arg( 'user', 7 ) );
+ }
+
+ public function test_remove_query_arg()
+ {
+ $this->assertEquals( '/app/admin/users', util::remove_query_arg( 'user', '/app/admin/users?user=5' ) );
+ $this->assertEquals( '/app/admin/users?action=edit', util::remove_query_arg( 'user', '/app/admin/users?action=edit&user=5' ) );
+ $this->assertEquals( '/app/admin/users?user=5', util::remove_query_arg( array( 'tab', 'action' ), '/app/admin/users?action=edit&tab=personal&user=5' ) );
+ }
+
+ public function test_http_build_url()
+ {
+ $url = 'http://user:pass@example.com:8080/path/?query#fragment';
+
+ $expected = 'http://example.com/';
+ $actual = util::http_build_url($url, array(), util::HTTP_URL_STRIP_ALL);
+ $this->assertEquals($expected, $actual);
+
+ $expected = 'http://example.com:8080/path/?query#fragment';
+ $actual = util::http_build_url($url, array(), util::HTTP_URL_STRIP_AUTH);
+ $this->assertEquals($expected, $actual);
+
+ $this->assertEquals('https://dev.example.com/', util::http_build_url('http://example.com/', array('scheme' => 'https', 'host' => 'dev.example.com')));
+ $this->assertEquals('http://example.com/#hi', util::http_build_url('http://example.com/', array('fragment' => 'hi'), util::HTTP_URL_REPLACE));
+ $this->assertEquals('http://example.com/page', util::http_build_url('http://example.com/', array('path' => 'page'), util::HTTP_URL_JOIN_PATH));
+ $this->assertEquals('http://example.com/page', util::http_build_url('http://example.com', array('path' => 'page'), util::HTTP_URL_JOIN_PATH));
+ $this->assertEquals('http://example.com/?hi=Bro', util::http_build_url('http://example.com/', array('query' => 'hi=Bro'), util::HTTP_URL_JOIN_QUERY));
+ $this->assertEquals('http://example.com/?show=1&hi=Bro', util::http_build_url('http://example.com/?show=1', array('query' => 'hi=Bro'), util::HTTP_URL_JOIN_QUERY));
+
+ $this->assertEquals('http://admin@example.com/', util::http_build_url('http://example.com/', array('user' => 'admin')));
+ $this->assertEquals('http://admin:1@example.com/', util::http_build_url('http://example.com/', array('user' => 'admin', 'pass' => '1')));
+ }
+
+ public function test_str_to_bool()
+ {
+ $this->assertTrue( util::str_to_bool( 'true' ) );
+ $this->assertTrue( util::str_to_bool( 'yes' ) );
+ $this->assertTrue( util::str_to_bool( 'y' ) );
+ $this->assertTrue( util::str_to_bool( 'oui' ) );
+ $this->assertTrue( util::str_to_bool( 'vrai' ) );
+
+ $this->assertFalse( util::str_to_bool( 'false' ) );
+ $this->assertFalse( util::str_to_bool( 'no' ) );
+ $this->assertFalse( util::str_to_bool( 'n' ) );
+ $this->assertFalse( util::str_to_bool( 'non' ) );
+ $this->assertFalse( util::str_to_bool( 'faux' ) );
+
+ $this->assertFalse( util::str_to_bool( 'test' , false) );
+
+ }
+
+ public function test_array_pluck()
+ {
+ $array = array(
+ array(
+ 'name' => 'Bob',
+ 'age' => 37
+ ),
+ array(
+ 'name' => 'Fred',
+ 'age' => 37
+ ),
+ array(
+ 'name' => 'Jane',
+ 'age' => 29
+ ),
+ array(
+ 'name' => 'Brandon',
+ 'age' => 20
+ ),
+ array(
+ 'age' => 41
+ )
+ );
+
+ $obj_array = array(
+ 'bob' => (object) array(
+ 'name' => 'Bob',
+ 'age' => 37
+ ),
+ 'fred' => (object) array(
+ 'name' => 'Fred',
+ 'age' => 37
+ ),
+ 'jane' => (object) array(
+ 'name' => 'Jane',
+ 'age' => 29
+ ),
+ 'brandon' => (object) array(
+ 'name' => 'Brandon',
+ 'age' => 20
+ ),
+ 'invalid' => (object) array(
+ 'age' => 41
+ )
+ );
+
+ $obj_array_expect = array(
+ 'bob' => 'Bob',
+ 'fred' => 'Fred',
+ 'jane' => 'Jane',
+ 'brandon' => 'Brandon'
+ );
+
+ $this->assertEquals( array( 'Bob', 'Fred', 'Jane', 'Brandon' ), util::array_pluck( $array, 'name' ) );
+ $this->assertEquals( array( 'Bob', 'Fred', 'Jane', 'Brandon', array( 'age' => 41 ) ), util::array_pluck( $array, 'name', TRUE, FALSE ) );
+ $this->assertEquals( $obj_array_expect, util::array_pluck( $obj_array, 'name' ) );
+ $this->assertEquals( array( 'Bob', 'Fred', 'Jane', 'Brandon' ), util::array_pluck( $obj_array, 'name', FALSE ) );
+
+ $expected = array('Bob', 'Fred', 'Jane', 'Brandon', 'invalid' => (object)array('age' => 41));
+ $this->assertEquals($expected, util::array_pluck($obj_array, 'name', FALSE, FALSE));
+ $expected = array('Bob', 'Fred', 'Jane', 'Brandon', array('age' => 41));
+ $this->assertEquals($expected, util::array_pluck($array, 'name', false, false));
+ }
+
+ public function test_htmlentities()
+ {
+ $this->assertEquals( 'One & Two', util::htmlentities( 'One & Two' ) );
+ $this->assertEquals( 'One & Two', util::htmlentities( 'One & Two', TRUE ) );
+ }
+
+ public function test_htmlspecialchars()
+ {
+ $this->assertEquals( 'One & Two', util::htmlspecialchars( 'One & Two' ) );
+ $this->assertEquals( 'One & Two', util::htmlspecialchars( 'One & Two', TRUE ) );
+ }
+
+ public function test_remove_accents()
+ {
+ $this->assertEquals( 'A', util::remove_accents( "\xC3\x81" ) );
+ $this->assertEquals( 'e', util::remove_accents( "\xC4\x97" ) );
+ $this->assertEquals( 'U', util::remove_accents( "\xC3\x9C" ) );
+ $this->assertEquals( 'Ae', util::remove_accents( "Ä", 'de' ) );
+ $this->assertEquals( 'OEoeAEDHTHssaedhth', util::remove_accents(chr(140) . chr(156) . chr(198) . chr(208) . chr(222) . chr(223) . chr(230) . chr(240) . chr(254)));
+ }
+
+ public function test_zero_pad()
+ {
+ $this->assertEquals( '00000341', util::zero_pad( 341, 8 ) );
+ $this->assertEquals( '341', util::zero_pad( 341, 1 ) );
+ }
+
+ public function test_human_time_diff()
+ {
+ $this->assertEquals( '1 second ago', util::human_time_diff( time() - 1 ) );
+ $this->assertEquals( '30 seconds ago', util::human_time_diff( time() - 30 ) );
+ $this->assertEquals( '1 minute ago', util::human_time_diff( time() - ( util::SECONDS_IN_A_MINUTE * 1.4 ) ) );
+ $this->assertEquals( '5 minutes ago', util::human_time_diff( time() - ( util::SECONDS_IN_A_MINUTE * 5 ) ) );
+ $this->assertEquals( '1 hour ago', util::human_time_diff( time() - ( util::SECONDS_IN_AN_HOUR ) ) );
+ $this->assertEquals( '2 hours ago', util::human_time_diff( time() - ( util::SECONDS_IN_AN_HOUR * 2 ) ) );
+ $this->assertEquals( '1 day ago', util::human_time_diff( time() - ( util::SECONDS_IN_AN_HOUR * 24 ) ) );
+ $this->assertEquals( '5 days ago', util::human_time_diff( time() - ( util::SECONDS_IN_AN_HOUR * 24 * 5 ) ) );
+ $this->assertEquals( '1 week ago', util::human_time_diff( time() - ( util::SECONDS_IN_AN_HOUR * 24 * 7 ) ) );
+ $this->assertEquals( '2 weeks ago', util::human_time_diff( time() - ( util::SECONDS_IN_AN_HOUR * 24 * 14 ) ) );
+ $this->assertEquals( '1 month ago', util::human_time_diff( time() - ( util::SECONDS_IN_A_WEEK * 5 ) ) );
+ $this->assertEquals( '2 months ago', util::human_time_diff( time() - ( util::SECONDS_IN_A_WEEK * 10 ) ) );
+ $this->assertEquals( '1 year ago', util::human_time_diff( time() - ( util::SECONDS_IN_A_MONTH * 15 ) ) );
+ $this->assertEquals( '2 years ago', util::human_time_diff( time() - ( util::SECONDS_IN_A_MONTH * 36 ) ) );
+ $this->assertEquals( '11 years ago', util::human_time_diff( time() - ( util::SECONDS_IN_A_MONTH * 140 ) ) );
+
+ $this->assertEquals( 'fifteen minutes ago', util::human_time_diff( time() - ( util::SECONDS_IN_A_MINUTE * 15 ), '', TRUE ) );
+ }
+
+ public function test_number_to_word()
+ {
+ try {
+ util::number_to_word('junk data');
+ $this->fail('Accepted junk data');
+ } catch(\LogicException $e) {
+ $this->assertEquals('Not a number', $e->getMessage());
+ }
+
+ // Partially numeric.
+ $this->assertEquals('', util::number_to_word('1a'));
+
+ // Decimals
+ $this->assertEquals( 'five point zero five', util::number_to_word('5.05') );
+ $this->assertEquals( 'zero point eight', util::number_to_word( 0.8 ) );
+
+ // Integers
+ $this->assertEquals( 'positive one', util::number_to_word( '+1' ) );
+ $this->assertEquals( 'negative twelve', util::number_to_word( -12 ) );
+ $this->assertEquals( 'one', util::number_to_word( 1 ) );
+ $this->assertEquals( 'five', util::number_to_word( 5 ) );
+ $this->assertEquals( 'fifteen', util::number_to_word( 15 ) );
+ $this->assertEquals( 'twenty-one', util::number_to_word( 21 ) );
+ $this->assertEquals( 'thirty-two', util::number_to_word( 32 ) );
+ $this->assertEquals( 'forty-three', util::number_to_word( 43 ) );
+ $this->assertEquals( 'fifty-four', util::number_to_word( 54 ) );
+ $this->assertEquals( 'sixty-six', util::number_to_word( 66 ) );
+ $this->assertEquals( 'seventy-seven', util::number_to_word( 77 ) );
+ $this->assertEquals( 'eighty-eight', util::number_to_word( 88 ) );
+ $this->assertEquals( 'ninety-nine', util::number_to_word( 99 ) );
+ $this->assertEquals( 'one hundred and thirty-six', util::number_to_word( 136 ) );
+ $this->assertEquals( 'ten', util::number_to_word( 10 ) );
+ $this->assertEquals( 'twenty', util::number_to_word( 20 ) );
+ $this->assertEquals( 'thirty', util::number_to_word( 30 ) );
+ $this->assertEquals( 'forty', util::number_to_word( 40 ) );
+ $this->assertEquals( 'fifty', util::number_to_word( 50 ) );
+ $this->assertEquals( 'sixty', util::number_to_word( 60 ) );
+ $this->assertEquals( 'seventy', util::number_to_word( 70 ) );
+ $this->assertEquals( 'eighty', util::number_to_word( 80 ) );
+ $this->assertEquals( 'ninety', util::number_to_word( 90 ) );
+ $this->assertEquals( 'eleven', util::number_to_word( 11 ) );
+ $this->assertEquals( 'thirteen', util::number_to_word( 13 ) );
+ $this->assertEquals( 'fourteen', util::number_to_word( 14 ) );
+ $this->assertEquals( 'fifteen', util::number_to_word( 15 ) );
+ $this->assertEquals( 'sixteen', util::number_to_word( 16 ) );
+ $this->assertEquals( 'seventeen', util::number_to_word( 17 ) );
+ $this->assertEquals( 'eighteen', util::number_to_word( 18 ) );
+ $this->assertEquals( 'nineteen', util::number_to_word( 19 ) );
+ $this->assertEquals( 'one thousand', util::number_to_word( 1000 ) );
+ $this->assertEquals( 'one million', util::number_to_word( 1000000 ) );
+ $this->assertEquals( 'one billion', util::number_to_word( 1000000000 ) );
+ $this->assertEquals( 'one trillion', util::number_to_word( 1000000000000 ) );
+ $this->assertEquals( 'one quadrillion', util::number_to_word( '1000000000000000' ) );
+ $this->assertEquals( 'one quintrillion', util::number_to_word( '1000000000000000000' ) );
+ $this->assertEquals( 'one sextillion', util::number_to_word( '1000000000000000000000' ) );
+ $this->assertEquals( 'one septillion', util::number_to_word( '1000000000000000000000000' ) );
+ $this->assertEquals( 'one octillion', util::number_to_word( '1000000000000000000000000000' ) );
+ $this->assertEquals( 'one nonillion', util::number_to_word( '1000000000000000000000000000000' ) );
+ $this->assertEquals( 'one decillion', util::number_to_word( '1000000000000000000000000000000000' ) );
+ $this->assertEquals( 'one', util::number_to_word( '1000000000000000000000000000000000000000000' ) );
+
+ }
+
+ public function test_array_search_deep()
+ {
+ $users = array(
+ 1 => (object) array( 'username' => 'brandon', 'age' => 20 ),
+ 2 => (object) array( 'username' => 'matt', 'age' => 27 ),
+ 3 => (object) array( 'username' => 'jane', 'age' => 53 ),
+ 4 => (object) array( 'username' => 'john', 'age' => 41 ),
+ 5 => (object) array( 'username' => 'steve', 'age' => 11 ),
+ 6 => (object) array( 'username' => 'fred', 'age' => 42 ),
+ 7 => (object) array( 'username' => 'rasmus', 'age' => 21 ),
+ 8 => (object) array( 'username' => 'don', 'age' => 15 ),
+ 9 => array( 'username' => 'darcy', 'age' => 33 ),
+ );
+
+ $test = array(
+ 1 => 'brandon',
+ 2 => 'devon',
+ 3 => array( 'troy' ),
+ 4 => 'annie'
+ );
+
+ $this->assertFalse( util::array_search_deep( $test, 'bob' ) );
+ $this->assertEquals( 3, util::array_search_deep( $test, 'troy' ) );
+ $this->assertEquals( 4, util::array_search_deep( $test, 'annie' ) );
+ $this->assertEquals( 2, util::array_search_deep( $test, 'devon', 'devon' ) );
+ $this->assertEquals( 7, util::array_search_deep( $users, 'rasmus', 'username' ) );
+ $this->assertEquals( 9, util::array_search_deep( $users, 'darcy', 'username' ) );
+ $this->assertEquals( 1, util::array_search_deep( $users, 'brandon' ) );
+ }
+
+ public function test_array_map_deep()
+ {
+ $input = array(
+ '<',
+ 'abc',
+ '>',
+ 'def',
+ array( '&', 'test', '123' ),
+ (object) array( 'hey', '<>' )
+ );
+
+ $expect = array(
+ '<',
+ 'abc',
+ '>',
+ 'def',
+ array( '&', 'test', '123' ),
+ (object) array( 'hey', '<>' )
+ );
+
+ $this->assertEquals( $expect, util::array_map_deep( $input, 'htmlentities' ) );
+ }
+
+ public function test_random_string()
+ {
+ // Make sure the generated string contains only human friendly characters and is 30 characters long
+ $str = util::random_string( 30 );
+ $this->assertTrue( (bool) preg_match( '/^([ABCDEFGHJKLMNPQRSTUVWXYZabcdefhjkmnprstuvwxyz23456789]{30})$/', $str ) );
+
+ // Make sure the generated string is 30 characters long
+ $str = util::random_string( 30, false, true );
+ $this->assertTrue( strlen( $str ) === 30, 'random_string produced an invalid length string' );
+
+ // Make sure the generated string is 120 characters long
+ $str = util::random_string( 120 );
+ $this->assertTrue(strlen( $str ) === 120, 'random_string produced an invalid length string');
+
+ // Make sure the string doesn't contain duplicate letters
+ $str = util::random_string( 53, true, false, true );
+ $this->assertTrue(strlen($str) === 53, 'random_string produced an invalid length string');
+ $this->assertTrue(count(array_unique(str_split($str))) === strlen($str), 'random_string produced a string with duplicate characters');
+
+ // Longer length than characters available
+ try {
+ $str = util::random_string( 55, true, false, true );
+ $this->assertTrue( false );
+ } catch (Exception $e) {
+ $this->assertTrue( true );
+ }
+
+ // Test secure variant
+ $str = util::secure_random_string(16);
+ $this->assertTrue(strlen($str) === 16);
+
+ // Longer length than characters available
+ try {
+ $str = util::secure_random_string(0);
+ $this->assertTrue(false);
+ } catch (Exception $e) {
+ $this->assertTrue(true);
+ }
+ }
+
+ public function test_match_string()
+ {
+ $this->assertTrue( util::match_string('a', 'a') );
+ $this->assertFalse( util::match_string('a', ' a') );
+ $this->assertFalse( util::match_string('/', '/something') );
+ $this->assertTrue( util::match_string('test/*', 'test/first/second') );
+ $this->assertTrue( util::match_string('*/test', 'first/second/test') );
+ $this->assertFalse( util::match_string('first/', 'first/second/test') );
+ $this->assertFalse( util::match_string('test', 'TEST') );
+ $this->assertTrue( util::match_string('test', 'TEST', false) );
+ }
+
+ public function test_validate_email()
+ {
+ $this->assertTrue( util::validate_email( 'john.smith@gmail.com' ) );
+ $this->assertTrue( util::validate_email( 'john.smith+label@gmail.com' ) );
+ $this->assertTrue( util::validate_email( 'john.smith@gmail.co.uk' ) );
+ }
+
+ public function test_safe_truncate()
+ {
+ $this->assertEquals( 'The quick brown fox...', util::safe_truncate( 'The quick brown fox jumps over the lazy dog', 24 ) );
+ $this->assertEquals( 'The quick brown fox jumps over the lazy dog', util::safe_truncate( 'The quick brown fox jumps over the lazy dog', 55 ) );
+ $this->assertEquals( 'Th...', util::safe_truncate( 'The quick brown fox jumps over the lazy dog', 2 ) );
+ $this->assertEquals( 'The...', util::safe_truncate( 'The quick brown fox jumps over the lazy dog', 3 ) );
+ $this->assertEquals( 'The...', util::safe_truncate( 'The quick brown fox jumps over the lazy dog', 7 ) );
+ }
+
+ public function test_limit_characters()
+ {
+ $this->assertEquals( 'The quick brown fox jump...', util::limit_characters( 'The quick brown fox jumps over the lazy dog', 24 ) );
+ $this->assertEquals( 'The quick brown fox jumps over the lazy dog', util::limit_characters( 'The quick brown fox jumps over the lazy dog', 55 ) );
+ $this->assertEquals( 'Th...', util::limit_characters( 'The quick brown fox jumps over the lazy dog', 2 ) );
+ $this->assertEquals( 'The...', util::limit_characters( 'The quick brown fox jumps over the lazy dog', 3 ) );
+ $this->assertEquals( 'The qui...', util::limit_characters( 'The quick brown fox jumps over the lazy dog', 7 ) );
+ $this->assertEquals( 'The quick brown fox jumps over the lazy dog', util::limit_characters( 'The quick brown fox jumps over the lazy dog', 150 ) );
+ }
+
+ public function test_limit_words()
+ {
+ $this->assertEquals( 'The quick brown...', util::limit_words( 'The quick brown fox jumps over the lazy dog', 3 ) );
+ $this->assertEquals( 'The quick brown fox jumps...', util::limit_words( 'The quick brown fox jumps over the lazy dog', 5 ) );
+ $this->assertEquals( 'The...', util::limit_words( 'The quick brown fox jumps over the lazy dog', 1 ) );
+ $this->assertEquals( 'The quick brown fox jumps over the lazy dog', util::limit_words( 'The quick brown fox jumps over the lazy dog', 90 ) );
+ $this->assertEquals( 'The quick brown fox jumps over the...', util::limit_words( 'The quick brown fox jumps over the lazy dog', 7 ) );
+ }
+
+ public function test_ordinal()
+ {
+ $this->assertEquals( '1st', util::ordinal( 1 ) );
+ $this->assertEquals( '2nd', util::ordinal( 2 ) );
+ $this->assertEquals( '3rd', util::ordinal( 3 ) );
+ $this->assertEquals( '4th', util::ordinal( 4 ) );
+ $this->assertEquals( '5th', util::ordinal( 5 ) );
+ $this->assertEquals( '6th', util::ordinal( 6 ) );
+ $this->assertEquals( '7th', util::ordinal( 7 ) );
+ $this->assertEquals( '8th', util::ordinal( 8 ) );
+ $this->assertEquals( '9th', util::ordinal( 9 ) );
+ $this->assertEquals( '22nd', util::ordinal( 22 ) );
+ $this->assertEquals( '23rd', util::ordinal( 23 ) );
+ $this->assertEquals( '143rd', util::ordinal( 143 ) );
+ }
+
+ public function test_array_first()
+ {
+ $test = array( 'a' => array( 'a', 'b', 'c' ) );
+
+ $this->assertEquals( 'a', util::array_first( util::array_get( $test['a'] ) ) );
+ }
+
+ public function test_array_first_key()
+ {
+ $test = array( 'a' => array( 'a' => 'b', 'c' => 'd' ) );
+
+ $this->assertEquals( 'a', util::array_first_key( util::array_get( $test['a'] ) ) );
+ }
+
+ public function test_array_last()
+ {
+ $test = array( 'a' => array( 'a', 'b', 'c' ) );
+
+ $this->assertEquals( 'c', util::array_last( util::array_get( $test['a'] ) ) );
+ }
+
+ public function test_array_last_key()
+ {
+ $test = array( 'a' => array( 'a' => 'b', 'c' => 'd' ) );
+
+ $this->assertEquals( 'c', util::array_last_key( util::array_get( $test['a'] ) ) );
+ }
+
+ public function test_array_flatten()
+ {
+ $input = array( 'a', 'b', 'c', 'd', array( 'first' => 'e', 'f', 'second' => 'g', array( 'h', 'third' => 'i', array( array( array( array( 'j', 'k', 'l' ) ) ) ) ) ) );
+ $expectNoKeys = range( 'a', 'l' );
+ $expectWithKeys = array(
+ 'a', 'b', 'c', 'd',
+ 'first' => 'e',
+ 'f',
+ 'second' => 'g',
+ 'h',
+ 'third' => 'i',
+ 'j', 'k', 'l'
+ );
+
+ $this->assertEquals( $expectWithKeys, util::array_flatten( $input ) );
+ $this->assertEquals( $expectNoKeys, util::array_flatten( $input, false ) );
+ $this->assertEquals( $expectWithKeys, util::array_flatten( $input, true ) );
+ }
+
+ public function test_strip_space()
+ {
+ $input = ' The quick brown fox jumps over the lazy dog ';
+ $expect = 'Thequickbrownfoxjumpsoverthelazydog';
+
+ $this->assertEquals($expect, Util::strip_space($input));
+ }
+
+ public function test_sanitize_string()
+ {
+ $input = ' Benoit! à New-York? j’ai perçu 1 % : Qu’as-tu "gagné" chez M. V. Noël? Dix francs.';
+ $expect = 'benoitanewyorkjaipercu1quastugagnechezmvnoeldixfrancs';
+
+ $this->assertEquals($expect, Util::sanitize_string($input));
+ }
+
+ public function test_get_gravatar()
+ {
+ $_SERVER['HTTPS'] = 'on';
+ $this->assertEquals('https://secure.gravatar.com/avatar/a4bf5bbb9feaa2713d99a3b52ab80024?s=32', util::get_gravatar('john.doe@example.org'));
+ $this->assertEquals('https://secure.gravatar.com/avatar/a4bf5bbb9feaa2713d99a3b52ab80024?s=128', util::get_gravatar('john.doe@example.org', 128));
+
+ $_SERVER['HTTPS'] = 'off';
+ $this->assertEquals('http://www.gravatar.com/avatar/a4bf5bbb9feaa2713d99a3b52ab80024?s=32', util::get_gravatar('john.doe@example.org'));
+ $this->assertEquals('http://www.gravatar.com/avatar/a4bf5bbb9feaa2713d99a3b52ab80024?s=128', util::get_gravatar('john.doe@example.org', 128));
+ }
+
+ public function test_get_client_ip()
+ {
+ $_SERVER['REMOTE_ADDR'] = '192.168.30.152';
+ $_SERVER['HTTP_CLIENT_IP'] = '192.168.30.153';
+ $_SERVER['HTTP_X_FORWARDED_FOR'] = '192.168.30.154';
+ $this->assertEquals('192.168.30.152', util::get_client_ip());
+ $this->assertEquals('192.168.30.153', util::get_client_ip(true));
+
+ unset($_SERVER['HTTP_CLIENT_IP']);
+ $this->assertEquals('192.168.30.154', util::get_client_ip(true));
+ unset($_SERVER['HTTP_X_FORWARDED_FOR']);
+ $this->assertEquals('192.168.30.152', util::get_client_ip(true));
+ }
+
+ public function test_full_permissions()
+ {
+ // Text a non-existant file.
+ $this->assertFalse(util::full_permissions('faker-123.blah'), 'Gave a permission value for a non-existant file.');
+
+ // Test an existing file.
+ $expected = '-rw-rw-rw-';
+ $tempFile = tempnam(sys_get_temp_dir(), 'foo');
+ $this->assertTrue(chmod($tempFile, 0666), 'Oops. Could not change temp file\'s permissions to 0666.');
+ $this->assertEquals($expected, util::full_permissions($tempFile), 'Could not properly obtain permissions of an existing file.');
+ unlink($tempFile);
+
+ $this->assertEquals('lr--r--r--', util::full_permissions('fake-file-222', octdec('120444')));
+ $this->assertEquals('ur--r--r--', util::full_permissions('fake-file-222', octdec('000444')));
+ $this->assertEquals('srwxr-xr-x', util::full_permissions('fake-file-222', octdec('140755')));
+ $this->assertEquals('drwxr-xr-x', util::full_permissions('fake-file-222', octdec('40755')));
+ $this->assertEquals('brw-rw----', util::full_permissions('fake-file-222', octdec('60660')));
+ $this->assertEquals('crw-rw----', util::full_permissions('fake-file-222', octdec('20660')));
+ $this->assertEquals('prw-rw----', util::full_permissions('fake-file-222', octdec('10660')));
+ $this->assertEquals('---x------', util::full_permissions('fake-file-222', octdec('100100')));
+ $this->assertEquals('--w-------', util::full_permissions('fake-file-222', octdec('100200')));
+ $this->assertEquals('--wx------', util::full_permissions('fake-file-222', octdec('100300')));
+ $this->assertEquals('-r--------', util::full_permissions('fake-file-222', octdec('100400')));
+ $this->assertEquals('-r-x------', util::full_permissions('fake-file-222', octdec('100500')));
+ $this->assertEquals('-rw-------', util::full_permissions('fake-file-222', octdec('100600')));
+ $this->assertEquals('-rwx------', util::full_permissions('fake-file-222', octdec('100700')));
+
+ // Windows does not have the concept of /.
+ if (!defined('PHP_WINDOWS_VERSION_MAJOR')) {
+ $this->assertEquals('drwxr-xr-x', util::full_permissions('/'));
+ }
+ }
+
+ public function test_array_clean()
+ {
+ $input = array( 'a', 'b', '', null, false, 0);
+ $expect = array('a', 'b');
+ $this->assertEquals($expect, Util::array_clean($input));
+ }
+
+ public function test_var_dump_plain()
+ {
+ $input = 'var';
+ $expect = 'string(3) "var"';
+ $this->assertEquals($expect, Util::var_dump_plain($input, true));
+
+ $input = true;
+ $expect = 'bool(true)';
+ $this->assertEquals($expect, Util::var_dump_plain($input, true));
+
+ $input = 1;
+ $expect = 'int(1)';
+ $this->assertEquals($expect, Util::var_dump_plain($input, true));
+
+ $input = 1.5;
+ $expect = 'float(1.5)';
+ $this->assertEquals($expect, Util::var_dump_plain($input, true));
+
+ $input = null;
+ $expect = 'NULL';
+ $this->assertEquals($expect, Util::var_dump_plain($input, true));
+
+ $input = fopen('php://memory', 'r');
+ $expect = 'resource("stream") "' . $input . '"';
+ $this->assertEquals($expect, Util::var_dump_plain($input, -1));
+ fclose($input);
+
+ // Test complex arrays.
+ $input = array(1, 2, 4, 6, 10 => 20, 100 => 200);
+ $actual = util::var_dump_plain($input, true);
+ $this->assertContains('![]()
)', $actual);
+
+ // Test complex objects.
+ $experiment = new VarDumpExperiment();
+ $actual = util::var_dump_plain($experiment, true);
+ $this->assertContains('1 => string(1', $actual);
+ }
+
+ public function test_var_dump()
+ {
+ $input = 'var';
+ $expect = 'string(3) "var"
';
+
+ // Ensure the proper output is returned
+ $this->assertEquals($expect, Util::var_dump($input, true));
+
+ // Ensure the proper output is actually outputted
+ $this->expectOutputString($expect);
+ util::var_dump($input);
+
+ // Ensure we avoid infinite recursion on recursive arrays
+ $a = array('a' => 'value a', 'b' => 'value b');
+ $b = array('test' => &$a);
+ $c = array('a' => &$a, 'b' => &$b);
+ $a['c'] = &$c;
+ $b['c'] = &$c;
+ $this->assertContains('*RECURSION DETECTED*', Util::var_dump($c, true));
+
+ // Ensure we avoid infinite recursion on recursive objects
+ $a = (object) array('a' => 'value a', 'b' => 'value b');
+ $b = (object) array('test' => &$a);
+ $c = (object) array('a' => &$a, 'b' => &$b);
+ $a->c = &$c;
+ $b->c = &$c;
+ $this->assertContains('*RECURSION DETECTED*', Util::var_dump($c, true));
+
+ // Test class scoping.
+ $experiment = new VarDumpExperiment();
+ $actual = util::var_dump($experiment, true);
+
+ $snippet = substr($actual, strrpos($actual, 'display:inline'));
+ $this->assertContains('"public"', $snippet);
+ $this->assertContains('"protected:protected"', $snippet);
+ $this->assertContains('"private:VarDumpExperiment:private"', $actual);
+ }
+
+ public function test_linkify()
+ {
+ $input = 'great websites: http://www.google.com?param=test and http://yahoo.com/a/nested/folder';
+ $expect = 'great websites: http://www.google.com?param=test and http://yahoo.com/a/nested/folder';
+ $this->assertEquals($expect, Util::linkify($input));
+
+ $this->assertEquals($expect, util::linkify($expect), 'linkify() tried to double linkify an href.');
+ }
+
+ public function test_start_with()
+ {
+ $this->assertTrue(Util::starts_with('start a string', 'start a'));
+ $this->assertFalse(Util::starts_with('start a string', 'string'));
+ }
+
+ public function test_end_with()
+ {
+ $this->assertTrue(Util::ends_with('start a string', 'a string'));
+ $this->assertFalse(Util::ends_with('start a string', 'start'));
+ }
+
+ public function test_contains()
+ {
+ $this->assertTrue(Util::str_contains('start a string', 'a string'));
+ $this->assertFalse(Util::str_contains('start a string', 'Start'));
+ }
+
+ public function test_iContains()
+ {
+ $this->assertTrue(Util::str_icontains('start a string', 'a string'));
+ $this->assertTrue(Util::str_icontains('start a string', 'Start'));
+ }
+
+ public function test_get_file_ext()
+ {
+ $input = 'a_pdf_fil.pdf';
+ $expect = 'pdf';
+ $this->assertEquals($expect, Util::get_file_ext($input));
+ }
+
+ public function test_rmdir()
+ {
+ $dirname = dirname(__FILE__);
+
+ // Test deleting a non-existant directory
+ $this->assertFalse(file_exists($dirname . '/test1'));
+ $this->assertTrue(util::rmdir($dirname . '/test1'));
+
+ // Test deleting an empty directory
+ $dir = $dirname . '/test2';
+ mkdir($dir);
+
+ $this->assertTrue(is_dir($dir));
+
+ if (is_dir($dir)) {
+ util::rmdir($dir);
+ $this->assertFalse(is_dir($dir));
+ }
+
+ // Test deleting a non-empty directory
+ $dir = $dirname . '/test3';
+ $file = $dirname . '/test3/test.txt';
+ mkdir($dir);
+ touch($file);
+
+ $this->assertTrue(is_dir($dir));
+ $this->assertTrue(is_file($file));
+
+ if (is_dir($dir)) {
+ util::rmdir($dir);
+ $this->assertFalse(is_dir($dir));
+ $this->assertFalse(is_file($file));
+ }
+
+ // Test deleting a non-directory path
+ $file = $dirname . '/test4.txt';
+ touch($file);
+
+ try {
+ $str = util::rmdir($file);
+ $this->assertTrue(false);
+ } catch (\Exception $e) {
+ $this->assertTrue(true);
+ }
+
+ unlink($file);
+
+ // Test deleting a nested directory
+ $dir1 = $dirname . '/test5';
+ $dir2 = $dirname . '/test5/nested_dir';
+ $file1 = $dir1 . '/file1.txt';
+ $file2 = $dir2 . '/file2.txt';
+ mkdir($dir1);
+ mkdir($dir2);
+ touch($file1);
+ touch($file2);
+
+ $this->assertTrue(is_dir($dir1));
+ $this->assertTrue(is_dir($dir2));
+ $this->assertTrue(is_file($file1));
+ $this->assertTrue(is_file($file2));
+
+ if (is_dir($dir1)) {
+ util::rmdir($dir1);
+ $this->assertFalse(is_dir($dir1));
+ $this->assertFalse(is_dir($dir2));
+ $this->assertFalse(is_file($file1));
+ $this->assertFalse(is_file($file2));
+ }
+
+ // Test symlink traversal.
+ $dir = $dirname . '/test6';
+ $nestedDir = "$dir/nested";
+ $symlink = "$dir/nested-symlink";
+
+ mkdir($dir);
+ mkdir($nestedDir);
+
+ $symlinkStatus = symlink($nestedDir, $symlink);
+ $this->assertTrue($symlinkStatus, 'The test system does not support making symlinks.');
+
+ if (!$symlink) {
+ return;
+ }
+
+ $this->assertTrue(util::rmdir($symlink, true), 'Could not delete a symlinked directory.');
+ $this->assertFalse(file_exists($symlink), 'Could not delete a symlinked directory.');
+ util::rmdir($dir, true);
+ $this->assertFalse(is_dir($dir), 'Could not delete a directory with a symlinked directory inside of it.');
+ }
+
+ public function test_get_current_url()
+ {
+ $expected = 'http://test.dev/test.php?foo=bar';
+ $expectedAuth = 'http://admin:123@test.dev/test.php?foo=bar';
+ $expectedPort = 'http://test.dev:443/test.php?foo=bar';
+ $expectedPort2 = 'https://test.dev:80/test.php?foo=bar';
+ $expectedSSL = 'https://test.dev/test.php?foo=bar';
+
+ $_SERVER['HTTP_HOST'] = 'test.dev';
+ $_SERVER['SERVER_PORT'] = 80;
+ $_SERVER['REQUEST_URI'] = '/test.php?foo=bar';
+ $_SERVER['QUERY_STRING'] = 'foo=bar';
+ $_SERVER['PHP_SELF'] = '/test.php';
+
+ // Test regular.
+ $this->assertEquals($expected, util::get_current_url());
+
+ // Test server auth.
+ $_SERVER['PHP_AUTH_USER'] = 'admin';
+ $_SERVER['PHP_AUTH_PW'] = '123';
+ $this->assertEquals($expectedAuth, util::get_current_url());
+ unset($_SERVER['PHP_AUTH_USER']);
+ unset($_SERVER['PHP_AUTH_PW']);
+
+ // Test port.
+ $_SERVER['SERVER_PORT'] = 443;
+ $this->assertEquals($expectedPort, util::get_current_url());
+
+ // Test SSL.
+ $_SERVER['HTTPS'] = 'on';
+ $this->assertEquals($expectedSSL, util::get_current_url());
+ $_SERVER['SERVER_PORT'] = 80;
+ $this->assertEquals($expectedPort2, util::get_current_url());
+ unset($_SERVER['HTTPS']);
+
+ // Test no $_SERVER['REQUEST_URI'] (e.g., MS IIS).
+ unset($_SERVER['REQUEST_URI']);
+ $this->assertEquals($expected, util::get_current_url());
+ }
+
+ public function test_set_writable()
+ {
+ if (strncasecmp(PHP_OS, 'WIN', 3) === 0) {
+ $this->markTestSkipped('This functionality is not working on Windows.');
+ }
+
+ if (posix_geteuid() === 0) {
+ $this->markTestSkipped('These tests don\'t work when run as root');
+ }
+
+ $this->assertFalse(util::set_writable('/no/such/file'));
+
+ // Create a file to test with
+ $dirname = dirname(__FILE__);
+ $file = $dirname . '/test7';
+ touch($file);
+ chmod($file, 0644);
+
+ // The file is owned by us so it should be writable
+ $this->assertTrue(is_writable($file));
+ $this->assertEquals('-rw-r--r--', util::full_permissions($file));
+
+ // Toggle writable bit off for us
+ util::set_writable($file, false);
+ clearstatcache();
+ $this->assertFalse(is_writable($file));
+ $this->assertEquals('-r--r--r--', util::full_permissions($file));
+
+ // Toggle writable bit back on for us
+ util::set_writable($file, true);
+ clearstatcache();
+ $this->assertTrue(is_writable($file));
+ $this->assertEquals('-rw-r--r--', util::full_permissions($file));
+
+ unlink($file);
+ }
+
+ public function test_set_readable()
+ {
+ if (strncasecmp(PHP_OS, 'WIN', 3) === 0) {
+ $this->markTestSkipped('This functionality is not working on Windows.');
+ }
+
+ if (posix_geteuid() === 0) {
+ $this->markTestSkipped('These tests don\'t work when run as root');
+ }
+
+ $this->assertFalse(util::set_readable('/no/such/file'));
+
+ $dirname = dirname(__FILE__);
+ $file = $dirname . '/test8';
+ touch($file);
+
+ $this->assertTrue(is_readable($file));
+
+ util::set_readable($file, false);
+ clearstatcache();
+ $this->assertFalse(is_readable($file));
+
+ util::set_readable($file, true);
+ clearstatcache();
+ $this->assertTrue(is_readable($file));
+
+ unlink($file);
+ }
+
+ public function test_set_executable()
+ {
+ if (strncasecmp(PHP_OS, 'WIN', 3) === 0) {
+ $this->markTestSkipped('This functionality is not working on Windows.');
+ }
+
+ if (posix_geteuid() === 0) {
+ $this->markTestSkipped('These tests don\'t work when run as root');
+ }
+
+ $this->assertFalse(util::set_executable('/no/such/file'));
+
+ $dirname = dirname(__FILE__);
+ $file = $dirname . '/test9';
+ touch($file);
+
+ $this->assertFalse(is_executable($file));
+
+ util::set_executable($file, true);
+ clearstatcache();
+ $this->assertTrue(is_executable($file));
+
+ util::set_executable($file, false);
+ clearstatcache();
+ $this->assertFalse(is_executable($file));
+
+ unlink($file);
+ }
+
+ public function test_directory_size() {
+ $dirname = dirname(__FILE__);
+ $dir = $dirname .'/dir1';
+ mkdir($dir);
+ $file1 = $dir .'/file1';
+ file_put_contents($file1, '1234567890');
+ $file2 = $dir .'/file2';
+ file_put_contents($file2, range('a', 'z'));
+ $this->assertEquals(10 + 26, util::directory_size($dir));
+ util::rmdir($dir);
+ }
+
+ public function test_get_user_directory() {
+ // Test for OS Default.
+ $this->assertTrue(is_writable(util::get_user_directory()));
+
+ $oldServer = $_SERVER;
+ unset($_SERVER);
+ // Test for UNIX.
+ $_SERVER['HOME'] = '/home/unknown';
+ $this->assertEquals($_SERVER['HOME'], util::get_user_directory(), 'Could not get the user\'s home directory in UNIX.');
+ unset($_SERVER);
+
+ // Test for Windows.
+ $expected = 'X:\Users\ThisUser';
+ $_SERVER['HOMEDRIVE'] = 'X:';
+ $_SERVER['HOMEPATH'] = '\Users\ThisUser';
+ $this->assertEquals($expected, util::get_user_directory(), 'Could not get the user\'s home directory in Windows.');
+
+ // In case the tests are not being run in isolation.
+ $_SERVER = $oldServer;
+ }
+
+ public function test_directory_contents() {
+ $dirname = dirname(__FILE__);
+ $dir = $dirname . DIRECTORY_SEPARATOR .'dir1';
+ mkdir($dir);
+ $file1 = $dir . DIRECTORY_SEPARATOR .'file1';
+ touch($file1);
+ $this->assertEquals(array($file1), util::directory_contents($dir));
+ util::rmdir($dir);
+ }
+}
diff --git a/vendor/brandonwamboldt/utilphp/util.php b/vendor/brandonwamboldt/utilphp/util.php
new file mode 100644
index 00000000..1b209796
--- /dev/null
+++ b/vendor/brandonwamboldt/utilphp/util.php
@@ -0,0 +1,10 @@
+
+ */
+class util extends \utilphp\util { }
diff --git a/vendor/composer/ClassLoader.php b/vendor/composer/ClassLoader.php
new file mode 100644
index 00000000..dc02dfb1
--- /dev/null
+++ b/vendor/composer/ClassLoader.php
@@ -0,0 +1,445 @@
+
+ * 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') && ini_get('apc.enabled') ? $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 00000000..f27399a0
--- /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 00000000..af2fd3b1
--- /dev/null
+++ b/vendor/composer/autoload_classmap.php
@@ -0,0 +1,16 @@
+ $vendorDir . '/sergeytsalkov/meekrodb/db.class.php',
+ 'DBHelper' => $vendorDir . '/sergeytsalkov/meekrodb/db.class.php',
+ 'DBTransaction' => $vendorDir . '/sergeytsalkov/meekrodb/db.class.php',
+ 'MeekroDB' => $vendorDir . '/sergeytsalkov/meekrodb/db.class.php',
+ 'MeekroDBEval' => $vendorDir . '/sergeytsalkov/meekrodb/db.class.php',
+ 'MeekroDBException' => $vendorDir . '/sergeytsalkov/meekrodb/db.class.php',
+ 'WhereClause' => $vendorDir . '/sergeytsalkov/meekrodb/db.class.php',
+);
diff --git a/vendor/composer/autoload_namespaces.php b/vendor/composer/autoload_namespaces.php
new file mode 100644
index 00000000..bf34e7c9
--- /dev/null
+++ b/vendor/composer/autoload_namespaces.php
@@ -0,0 +1,10 @@
+ array($vendorDir . '/brandonwamboldt/utilphp/src'),
+);
diff --git a/vendor/composer/autoload_psr4.php b/vendor/composer/autoload_psr4.php
new file mode 100644
index 00000000..f44fc383
--- /dev/null
+++ b/vendor/composer/autoload_psr4.php
@@ -0,0 +1,10 @@
+ array($vendorDir . '/league/plates/src'),
+);
diff --git a/vendor/composer/autoload_real.php b/vendor/composer/autoload_real.php
new file mode 100644
index 00000000..afca66f6
--- /dev/null
+++ b/vendor/composer/autoload_real.php
@@ -0,0 +1,52 @@
+= 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\ComposerStaticInit67b09c83b85c3bc0027caefe5bba171a::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);
+
+ return $loader;
+ }
+}
diff --git a/vendor/composer/autoload_static.php b/vendor/composer/autoload_static.php
new file mode 100644
index 00000000..ac3cfb2c
--- /dev/null
+++ b/vendor/composer/autoload_static.php
@@ -0,0 +1,53 @@
+
+ array (
+ 'League\\Plates\\' => 14,
+ ),
+ );
+
+ public static $prefixDirsPsr4 = array (
+ 'League\\Plates\\' =>
+ array (
+ 0 => __DIR__ . '/..' . '/league/plates/src',
+ ),
+ );
+
+ public static $prefixesPsr0 = array (
+ 'u' =>
+ array (
+ 'utilphp\\' =>
+ array (
+ 0 => __DIR__ . '/..' . '/brandonwamboldt/utilphp/src',
+ ),
+ ),
+ );
+
+ public static $classMap = array (
+ 'DB' => __DIR__ . '/..' . '/sergeytsalkov/meekrodb/db.class.php',
+ 'DBHelper' => __DIR__ . '/..' . '/sergeytsalkov/meekrodb/db.class.php',
+ 'DBTransaction' => __DIR__ . '/..' . '/sergeytsalkov/meekrodb/db.class.php',
+ 'MeekroDB' => __DIR__ . '/..' . '/sergeytsalkov/meekrodb/db.class.php',
+ 'MeekroDBEval' => __DIR__ . '/..' . '/sergeytsalkov/meekrodb/db.class.php',
+ 'MeekroDBException' => __DIR__ . '/..' . '/sergeytsalkov/meekrodb/db.class.php',
+ 'WhereClause' => __DIR__ . '/..' . '/sergeytsalkov/meekrodb/db.class.php',
+ );
+
+ public static function getInitializer(ClassLoader $loader)
+ {
+ return \Closure::bind(function () use ($loader) {
+ $loader->prefixLengthsPsr4 = ComposerStaticInit67b09c83b85c3bc0027caefe5bba171a::$prefixLengthsPsr4;
+ $loader->prefixDirsPsr4 = ComposerStaticInit67b09c83b85c3bc0027caefe5bba171a::$prefixDirsPsr4;
+ $loader->prefixesPsr0 = ComposerStaticInit67b09c83b85c3bc0027caefe5bba171a::$prefixesPsr0;
+ $loader->classMap = ComposerStaticInit67b09c83b85c3bc0027caefe5bba171a::$classMap;
+
+ }, null, ClassLoader::class);
+ }
+}
diff --git a/vendor/composer/installed.json b/vendor/composer/installed.json
new file mode 100644
index 00000000..b52416a5
--- /dev/null
+++ b/vendor/composer/installed.json
@@ -0,0 +1,152 @@
+[
+ {
+ "name": "brandonwamboldt/utilphp",
+ "version": "1.1.0",
+ "version_normalized": "1.1.0.0",
+ "source": {
+ "type": "git",
+ "url": "https://github.com/brandonwamboldt/utilphp.git",
+ "reference": "36c32efc4f0679c05163464a550f45c8d83fe683"
+ },
+ "dist": {
+ "type": "zip",
+ "url": "https://api.github.com/repos/brandonwamboldt/utilphp/zipball/36c32efc4f0679c05163464a550f45c8d83fe683",
+ "reference": "36c32efc4f0679c05163464a550f45c8d83fe683",
+ "shasum": ""
+ },
+ "require": {
+ "php": ">=5.3.3"
+ },
+ "require-dev": {
+ "satooshi/php-coveralls": "dev-master"
+ },
+ "time": "2015-02-02T17:56:14+00:00",
+ "type": "library",
+ "installation-source": "dist",
+ "autoload": {
+ "psr-0": {
+ "utilphp\\": "src/"
+ }
+ },
+ "notification-url": "https://packagist.org/downloads/",
+ "license": [
+ "MIT"
+ ],
+ "authors": [
+ {
+ "name": "Brandon Wamboldt",
+ "email": "brandon.wamboldt@gmail.com"
+ }
+ ],
+ "description": "util.php is a collection of useful functions and snippets that you need or could use every day, designed to avoid conflicts with existing projects",
+ "homepage": "https://github.com/brandonwamboldt/utilphp",
+ "keywords": [
+ "collection",
+ "helpers",
+ "php",
+ "utility"
+ ]
+ },
+ {
+ "name": "league/plates",
+ "version": "3.3.0",
+ "version_normalized": "3.3.0.0",
+ "source": {
+ "type": "git",
+ "url": "https://github.com/thephpleague/plates.git",
+ "reference": "b1684b6f127714497a0ef927ce42c0b44b45a8af"
+ },
+ "dist": {
+ "type": "zip",
+ "url": "https://api.github.com/repos/thephpleague/plates/zipball/b1684b6f127714497a0ef927ce42c0b44b45a8af",
+ "reference": "b1684b6f127714497a0ef927ce42c0b44b45a8af",
+ "shasum": ""
+ },
+ "require": {
+ "php": "^5.3 | ^7.0"
+ },
+ "require-dev": {
+ "mikey179/vfsstream": "^1.4",
+ "phpunit/phpunit": "~4.0",
+ "squizlabs/php_codesniffer": "~1.5"
+ },
+ "time": "2016-12-28T00:14:17+00:00",
+ "type": "library",
+ "extra": {
+ "branch-alias": {
+ "dev-master": "3.0-dev"
+ }
+ },
+ "installation-source": "dist",
+ "autoload": {
+ "psr-4": {
+ "League\\Plates\\": "src"
+ }
+ },
+ "notification-url": "https://packagist.org/downloads/",
+ "license": [
+ "MIT"
+ ],
+ "authors": [
+ {
+ "name": "Jonathan Reinink",
+ "email": "jonathan@reinink.ca",
+ "role": "Developer"
+ }
+ ],
+ "description": "Plates, the native PHP template system that's fast, easy to use and easy to extend.",
+ "homepage": "http://platesphp.com",
+ "keywords": [
+ "league",
+ "package",
+ "templates",
+ "templating",
+ "views"
+ ]
+ },
+ {
+ "name": "sergeytsalkov/meekrodb",
+ "version": "v2.3",
+ "version_normalized": "2.3.0.0",
+ "source": {
+ "type": "git",
+ "url": "https://github.com/SergeyTsalkov/meekrodb.git",
+ "reference": "eb36858f1aff94ae1665900e681a1cfb78563ee1"
+ },
+ "dist": {
+ "type": "zip",
+ "url": "https://api.github.com/repos/SergeyTsalkov/meekrodb/zipball/eb36858f1aff94ae1665900e681a1cfb78563ee1",
+ "reference": "eb36858f1aff94ae1665900e681a1cfb78563ee1",
+ "shasum": ""
+ },
+ "require": {
+ "php": ">=5.2.0"
+ },
+ "time": "2014-06-16T22:40:22+00:00",
+ "type": "library",
+ "installation-source": "dist",
+ "autoload": {
+ "classmap": [
+ "db.class.php"
+ ]
+ },
+ "notification-url": "https://packagist.org/downloads/",
+ "license": [
+ "LGPL-3.0"
+ ],
+ "authors": [
+ {
+ "name": "Sergey Tsalkov",
+ "email": "stsalkov@gmail.com"
+ }
+ ],
+ "description": "The Simple PHP/MySQL Library",
+ "homepage": "http://www.meekro.com",
+ "keywords": [
+ "database",
+ "mysql",
+ "mysqli",
+ "pdo"
+ ]
+ }
+]
diff --git a/vendor/league/plates/CONTRIBUTING.md b/vendor/league/plates/CONTRIBUTING.md
new file mode 100644
index 00000000..9eebab6e
--- /dev/null
+++ b/vendor/league/plates/CONTRIBUTING.md
@@ -0,0 +1,22 @@
+# Contributing
+
+Contributions are **welcome** and will be fully **credited**.
+
+We accept contributions via Pull Requests on [Github](https://github.com/thephpleague/plates).
+
+## Pull Requests
+
+- **[PSR-2 Coding Standard](https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-2-coding-style-guide.md)** - The easiest way to apply the conventions is to install [PHP Code Sniffer](http://pear.php.net/package/PHP_CodeSniffer).
+- **Add tests!** - Your patch won't be accepted if it doesn't have tests.
+- **Document any change in behaviour** - Make sure the README and any other relevant documentation are kept up-to-date.
+- **Consider our release cycle** - We try to follow semver. Randomly breaking public APIs is not an option.
+- **Create topic branches** - Don't ask us to pull from your master branch.
+- **One pull request per feature** - If you want to do more than one thing, send multiple pull requests.
+- **Send coherent history** - Make sure each individual commit in your pull request is meaningful. If you had to make multiple intermediate commits while developing, please squash them before submitting.
+
+## Running Tests
+
+``` bash
+$ phpunit
+```
+**Happy coding**!
\ No newline at end of file
diff --git a/vendor/league/plates/LICENSE b/vendor/league/plates/LICENSE
new file mode 100644
index 00000000..26357d46
--- /dev/null
+++ b/vendor/league/plates/LICENSE
@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2013 The League of Extraordinary Packages
+
+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.
\ No newline at end of file
diff --git a/vendor/league/plates/README.md b/vendor/league/plates/README.md
new file mode 100644
index 00000000..56679e19
--- /dev/null
+++ b/vendor/league/plates/README.md
@@ -0,0 +1,63 @@
+Plates
+======
+
+[](https://twitter.com/reinink)
+[](https://github.com/thephpleague/plates)
+[](https://github.com/thephpleague/plates/releases)
+[](LICENSE)
+[](https://travis-ci.org/thephpleague/plates)
+[](https://scrutinizer-ci.com/g/thephpleague/plates/code-structure)
+[](https://scrutinizer-ci.com/g/thephpleague/plates)
+[](https://packagist.org/packages/league/plates)
+
+Plates is a native PHP template system that's fast, easy to use and easy to extend. It's inspired by the excellent [Twig](http://twig.sensiolabs.org/) template engine and strives to bring modern template language functionality to native PHP templates. Plates is designed for developers who prefer to use native PHP templates over compiled template languages, such as Twig or Smarty.
+
+### Highlights
+
+- Native PHP templates, no new [syntax](http://platesphp.com/templates/syntax/) to learn
+- Plates is a template system, not a template language
+- Plates encourages the use of existing PHP functions
+- Increase code reuse with template [layouts](http://platesphp.com/templates/layouts/) and [inheritance](http://platesphp.com/templates/inheritance/)
+- Template [folders](http://platesphp.com/engine/folders/) for grouping templates into namespaces
+- [Data](http://platesphp.com/templates/data/#preassigned-and-shared-data) sharing across templates
+- Preassign [data](http://platesphp.com/templates/data/#preassigned-and-shared-data) to specific templates
+- Built-in [escaping](http://platesphp.com/templates/escaping/) helpers
+- Easy to extend using [functions](http://platesphp.com/engine/functions/) and [extensions](http://platesphp.com/engine/extensions/)
+- Framework-agnostic, will work with any project
+- Decoupled design makes templates easy to test
+- Composer ready and PSR-2 compliant
+
+## Installation
+
+Plates is available via Composer:
+
+```
+composer require league/plates
+```
+
+## Documentation
+
+Full documentation can be found at [platesphp.com](http://platesphp.com/).
+
+## Testing
+
+```bash
+phpunit
+```
+
+## Contributing
+
+Please see [CONTRIBUTING](https://github.com/thephpleague/plates/blob/master/CONTRIBUTING.md) for details.
+
+## Security
+
+If you discover any security related issues, please email jonathan@reinink.ca instead of using the issue tracker.
+
+## Credits
+
+- [Jonathan Reinink](https://github.com/reinink)
+- [All Contributors](https://github.com/thephpleague/plates/contributors)
+
+## License
+
+The MIT License (MIT). Please see [License File](https://github.com/thephpleague/plates/blob/master/LICENSE) for more information.
diff --git a/vendor/league/plates/composer.json b/vendor/league/plates/composer.json
new file mode 100644
index 00000000..8971a983
--- /dev/null
+++ b/vendor/league/plates/composer.json
@@ -0,0 +1,41 @@
+{
+ "name": "league/plates",
+ "description": "Plates, the native PHP template system that's fast, easy to use and easy to extend.",
+ "keywords": [
+ "league",
+ "package",
+ "templating",
+ "templates",
+ "views"
+ ],
+ "homepage": "http://platesphp.com",
+ "license": "MIT",
+ "authors" : [
+ {
+ "name": "Jonathan Reinink",
+ "email": "jonathan@reinink.ca",
+ "role": "Developer"
+ }
+ ],
+ "require" : {
+ "php": "^5.3 | ^7.0"
+ },
+ "require-dev": {
+ "mikey179/vfsStream": "^1.4",
+ "phpunit/phpunit": "~4.0",
+ "squizlabs/php_codesniffer": "~1.5"
+ },
+ "autoload": {
+ "psr-4": {
+ "League\\Plates\\": "src"
+ }
+ },
+ "extra": {
+ "branch-alias": {
+ "dev-master": "3.0-dev"
+ }
+ },
+ "scripts": {
+ "test": "phpunit"
+ }
+}
diff --git a/vendor/league/plates/docs/CNAME b/vendor/league/plates/docs/CNAME
new file mode 100644
index 00000000..1e00c34f
--- /dev/null
+++ b/vendor/league/plates/docs/CNAME
@@ -0,0 +1 @@
+platesphp.com
\ No newline at end of file
diff --git a/vendor/league/plates/docs/_data/images.yml b/vendor/league/plates/docs/_data/images.yml
new file mode 100644
index 00000000..56d11839
--- /dev/null
+++ b/vendor/league/plates/docs/_data/images.yml
@@ -0,0 +1,8 @@
+# Path to project specific favicon.ico, leave blank to use default
+favicon: /favicon.ico
+
+# Path to project specific apple-touch-icon-precomposed.png, leave blank to use default
+apple_touch: /apple-touch-icon-precomposed.png
+
+# Path to project logo
+logo: /logo.png
\ No newline at end of file
diff --git a/vendor/league/plates/docs/_data/menu.yml b/vendor/league/plates/docs/_data/menu.yml
new file mode 100644
index 00000000..317a0e4f
--- /dev/null
+++ b/vendor/league/plates/docs/_data/menu.yml
@@ -0,0 +1,24 @@
+Getting Started:
+ Introduction: '/'
+ Simple example: '/simple-example/'
+ Installation: '/installation/'
+ Changelog: '/changelog/'
+The Engine:
+ Overview: '/engine/'
+ File extensions: '/engine/file-extensions/'
+ Folders: '/engine/folders/'
+ Functions: '/engine/functions/'
+ Extensions: '/engine/extensions/'
+Templates:
+ Overview: '/templates/'
+ Data: '/templates/data/'
+ Functions: '/templates/functions/'
+ Nesting: '/templates/nesting/'
+ Layouts: '/templates/layouts/'
+ Sections: '/templates/sections/'
+ Inheritance: '/templates/inheritance/'
+ Escaping: '/templates/escaping/'
+ Syntax: '/templates/syntax/'
+Extensions:
+ Asset: '/extensions/asset/'
+ URI: '/extensions/uri/'
\ No newline at end of file
diff --git a/vendor/league/plates/docs/_data/project.yml b/vendor/league/plates/docs/_data/project.yml
new file mode 100644
index 00000000..4ff76f30
--- /dev/null
+++ b/vendor/league/plates/docs/_data/project.yml
@@ -0,0 +1,4 @@
+title: Plates
+tagline: Native PHP Templates
+description: 'Plates is a Twig inspired, native PHP template system that brings modern template language functionality to native PHP templates.'
+google_analytics_tracking_id: UA-46050814-2
\ No newline at end of file
diff --git a/vendor/league/plates/docs/_layouts/default.html b/vendor/league/plates/docs/_layouts/default.html
new file mode 100644
index 00000000..72042e30
--- /dev/null
+++ b/vendor/league/plates/docs/_layouts/default.html
@@ -0,0 +1,107 @@
+
+
+
+
+
+
+ {% if page.url == '/' %}
+ {{ site.data.project.title }} - {{ site.data.project.tagline }}
+ {% else %}
+ {{ page.title }} - {{ site.data.project.title }}
+ {% endif %}
+ {% if site.data.project.description %}
+
+ {% endif %}
+ {% if site.github.url %}
+ 
+
+
+
+
+ 
+
+ Our Packages:
+
+
+
+
+
+
+
+ {% if site.data.images.logo %}
+
+ 
+
+ {% endif %}
+ {{ site.data.project.title }}
+ {{ site.data.project.tagline }}
+
+
+ Presented by The League of Extraordinary Packages
+
+
+
+
+
+
+
+
+ {% for link in section[1] %}
+ -
+ {{ link[0] }}
+
+ {% endfor %}
+
+ {% endfor %}
+
+
+ {{ content }}
+
+
+
+
+
+
+
+
+
+{% if site.data.project.google_analytics_tracking_id %}
+
+{% endif %}
+
+
+
\ No newline at end of file
diff --git a/vendor/league/plates/docs/apple-touch-icon-precomposed.png b/vendor/league/plates/docs/apple-touch-icon-precomposed.png
new file mode 100644
index 00000000..460a2ba1
Binary files /dev/null and b/vendor/league/plates/docs/apple-touch-icon-precomposed.png differ
diff --git a/vendor/league/plates/docs/changelog.md b/vendor/league/plates/docs/changelog.md
new file mode 100644
index 00000000..a471991d
--- /dev/null
+++ b/vendor/league/plates/docs/changelog.md
@@ -0,0 +1,15 @@
+---
+layout: default
+permalink: changelog/
+title: Changelog
+---
+
+Changelog
+=========
+
+All notable changes to this project will be documented in this file.
+
+{% for release in site.github.releases %}
+## [{{ release.name }}]({{ release.html_url }}) - {{ release.published_at | date: "%Y-%m-%d" }}
+{{ release.body | markdownify }}
+{% endfor %}
\ No newline at end of file
diff --git a/vendor/league/plates/docs/css/custom.scss b/vendor/league/plates/docs/css/custom.scss
new file mode 100644
index 00000000..6bef9794
--- /dev/null
+++ b/vendor/league/plates/docs/css/custom.scss
@@ -0,0 +1,16 @@
+---
+---
+
+.github {
+ position: absolute;
+ top: 0;
+ right: 0;
+ border: 0;
+ z-index: 1000;
+}
+
+@media screen and (max-width: 1065px) {
+ .github {
+ display: none;
+ }
+}
\ No newline at end of file
diff --git a/vendor/league/plates/docs/engine/extensions.md b/vendor/league/plates/docs/engine/extensions.md
new file mode 100644
index 00000000..c40868a5
--- /dev/null
+++ b/vendor/league/plates/docs/engine/extensions.md
@@ -0,0 +1,120 @@
+---
+layout: default
+permalink: engine/extensions/
+title: Extensions
+---
+
+Extensions
+==========
+
+Creating extensions couldn't be easier, and can really make Plates sing for your specific project. Start by creating a class that implements `\League\Plates\Extension\ExtensionInterface`. Next, register your template [functions](/engine/functions/) within a `register()` method.
+
+## Simple extensions example
+
+~~~ php
+use League\Plates\Engine;
+use League\Plates\Extension\ExtensionInterface;
+
+class ChangeCase implements ExtensionInterface
+{
+ public function register(Engine $engine)
+ {
+ $engine->registerFunction('uppercase', [$this, 'uppercaseString']);
+ $engine->registerFunction('lowercase', [$this, 'lowercaseString']);
+ }
+
+ public function uppercaseString($var)
+ {
+ return strtoupper($var);
+ }
+
+ public function lowercaseString($var)
+ {
+ return strtolower($var);
+ }
+}
+~~~
+
+To use this extension in your template, simply call your new functions:
+
+~~~ php
+Hello, e($this->uppercase($name))?>
+~~~
+
+They can also be used in a [batch](/templates/functions/#batch-function-calls) compatible function:
+
+~~~ php
+Hello e($name, 'uppercase')
+~~~
+
+## Single method extensions
+
+Alternatively, you may choose to expose the entire extension object to the template using a single function. This can make your templates more legible and also reduce the chance of conflicts with other extensions.
+
+~~~ php
+use League\Plates\Engine;
+use League\Plates\Extension\ExtensionInterface;
+
+class ChangeCase implements ExtensionInterface
+{
+ public function register(Engine $engine)
+ {
+ $engine->registerFunction('case', [$this, 'getObject']);
+ }
+
+ public function getObject()
+ {
+ return $this;
+ }
+
+ public function upper($var)
+ {
+ return strtoupper($var);
+ }
+
+ public function lower($var)
+ {
+ return strtolower($var);
+ }
+}
+~~~
+
+To use this extension in your template, first call the primary function, then the secondary functions:
+
+~~~ php
+Hello, e($this->case()->upper($name))?>
+~~~
+
+## Loading extensions
+
+To enable an extension, load it into the [engine](/engine/) object using the `loadExtension()` method.
+
+~~~ php
+$engine->loadExtension(new ChangeCase());
+~~~
+
+## Accessing the engine and template
+
+It may be desirable to access the `engine` or `template` objects from within your extension. Plates makes both of these objects available to you. The engine is automatically passed to the `register()` method, and the template is assigned as a parameter on each function call.
+
+~~~ php
+use League\Plates\Engine;
+use League\Plates\Extension\ExtensionInterface;
+
+class MyExtension implements ExtensionInterface
+{
+ protected $engine;
+ public $template; // must be public
+
+ public function register(Engine $engine)
+ {
+ $this->engine = $engine;
+
+ // Access template data:
+ $data = $this->template->data();
+
+ // Register functions
+ // ...
+ }
+}
+~~~
\ No newline at end of file
diff --git a/vendor/league/plates/docs/engine/file-extensions.md b/vendor/league/plates/docs/engine/file-extensions.md
new file mode 100644
index 00000000..613bccf4
--- /dev/null
+++ b/vendor/league/plates/docs/engine/file-extensions.md
@@ -0,0 +1,36 @@
+---
+layout: default
+permalink: engine/file-extensions/
+title: File extensions
+---
+
+File extensions
+===============
+
+Plates does not enforce a specific template file extension. By default it assumes `.php`. This file extension is automatically appended to your template names when rendered. You are welcome to change the default extension using one of the following methods.
+
+## Constructor method
+
+~~~ php
+// Create new engine and set the default file extension to ".tpl"
+$template = new League\Plates\Engine('/path/to/templates', 'tpl');
+~~~
+
+## Setter method
+
+~~~ php
+// Sets the default file extension to ".tpl" after engine instantiation
+$template->setFileExtension('tpl');
+~~~
+
+## Manually assign
+
+If you prefer to manually set the file extension, simply set the default file extension to `null`.
+
+~~~ php
+// Disable automatic file extensions
+$template->setFileExtension(null);
+
+// Render template
+echo $templates->render('home.php');
+~~~
\ No newline at end of file
diff --git a/vendor/league/plates/docs/engine/folders.md b/vendor/league/plates/docs/engine/folders.md
new file mode 100644
index 00000000..7991bfcd
--- /dev/null
+++ b/vendor/league/plates/docs/engine/folders.md
@@ -0,0 +1,50 @@
+---
+layout: default
+permalink: engine/folders/
+title: Folders
+---
+
+Folders
+=======
+
+Folders make it really easy to organize and access your templates. Folders allow you to group your templates under different namespaces, each of which having their own file system path.
+
+## Creating folders
+
+To create folders, use the `addFolder()` method:
+
+~~~ php
+// Create new Plates instance
+$templates = new League\Plates\Engine();
+
+// Add folders
+$templates->addFolder('admin', '/path/to/admin/templates');
+$templates->addFolder('emails', '/path/to/email/templates');
+~~~
+
+## Using folders
+
+To use the folders you created within your project simply append the folder name with two colons before the template name. For example, to render a welcome email:
+
+~~~ php
+$email = $templates->render('emails::welcome');
+~~~
+
+This works with template functions as well, such as layouts or nested templates. For example:
+
+~~~ php
+layout('shared::template') ?>
+~~~
+
+## Folder fallbacks
+
+When enabled, if a folder template is missing, Plates will automatically fallback and look for a template with the **same** name in the default folder. This can be helpful when using folders to manage themes. To enable fallbacks, simply pass `true` as the third parameter in the `addFolders()` method.
+
+~~~ php
+// Create new Plates engine
+$templates = new \League\Plates\Engine('/path/to/default/theme');
+
+// Add themes
+$templates->addFolder('theme1', '/path/to/theme/1', true);
+$templates->addFolder('theme2', '/path/to/theme/2', true);
+~~~
\ No newline at end of file
diff --git a/vendor/league/plates/docs/engine/functions.md b/vendor/league/plates/docs/engine/functions.md
new file mode 100644
index 00000000..b677ec57
--- /dev/null
+++ b/vendor/league/plates/docs/engine/functions.md
@@ -0,0 +1,34 @@
+---
+layout: default
+permalink: engine/functions/
+title: Functions
+---
+
+Functions
+=========
+
+While [extensions](/engine/extensions/) are awesome for adding additional reusable functionality to Plates, sometimes it's easier to just create a one-off function for a specific use case. Plates makes this easy to do.
+
+## Registering functions
+
+~~~ php
+// Create new Plates engine
+$templates = new \League\Plates\Engine('/path/to/templates');
+
+// Register a one-off function
+$templates->registerFunction('uppercase', function ($string) {
+ return strtoupper($string);
+});
+~~~
+
+To use this function in a template, simply call it like any other function:
+
+~~~ php
+Hello e($this->uppercase($name))
+~~~
+
+It can also be used in a [batch](/templates/functions/#batch-function-calls) compatible function:
+
+~~~ php
+Hello e($name, 'uppercase')
+~~~
\ No newline at end of file
diff --git a/vendor/league/plates/docs/engine/index.md b/vendor/league/plates/docs/engine/index.md
new file mode 100644
index 00000000..6d428796
--- /dev/null
+++ b/vendor/league/plates/docs/engine/index.md
@@ -0,0 +1,56 @@
+---
+layout: default
+permalink: engine/
+title: The Engine
+---
+
+The Engine
+==========
+
+Plates uses a central object called the `Engine`, which is used to store the environment configuration, functions and extensions. It helps decouple your templates from the file system and other dependencies. For example, if you want to change the folder where your templates are stored, you can do so by simply changing the path in one location.
+
+## Basic usage
+
+~~~ php
+// Create new Plates engine
+$templates = new League\Plates\Engine('/path/to/templates');
+
+// Add any any additional folders
+$templates->addFolder('emails', '/path/to/emails');
+
+// Load any additional extensions
+$templates->loadExtension(new League\Plates\Extension\Asset('/path/to/public'));
+
+// Create a new template
+$template = $templates->make('emails::welcome');
+~~~
+
+## Dependency Injection
+
+Plates is designed to be easily passed around your application and easily injected in your controllers or other application objects. Simply pass an instance of the `Engine` to any consuming objects, and then use either the `make()` method to create a new template, or the `render()` method to render it immediately. For example:
+
+~~~ php
+class Controller
+{
+ private $templates;
+
+ public function __construct(League\Plates\Engine $templates)
+ {
+ $this->templates = $templates;
+ }
+
+ // Create a template object
+ public function getIndex()
+ {
+ $template = $this->templates->make('home');
+
+ return $template->render();
+ }
+
+ // Render a template directly
+ public function getIndex()
+ {
+ return $this->templates->render('home');
+ }
+}
+~~~
\ No newline at end of file
diff --git a/vendor/league/plates/docs/extensions/asset.md b/vendor/league/plates/docs/extensions/asset.md
new file mode 100644
index 00000000..6a1d40e6
--- /dev/null
+++ b/vendor/league/plates/docs/extensions/asset.md
@@ -0,0 +1,59 @@
+---
+layout: default
+permalink: extensions/asset/
+title: Asset extension
+---
+
+Asset
+=====
+
+The asset extension can be used to quickly create "cache busted" asset URLs in your templates. This is particularly helpful for aggressively cached files that can potentially change in the future, such as CSS files, JavaScript files and images. It works by appending the timestamp of the file's last update to its URL. For example, `/css/all.css` becomes `/css/all.1373577602.css`. As long as the file does not change, the timestamp remains the same and caching occurs. However, if the file is changed, a new URL is automatically generated with a new timestamp, and visitors receive the new file.
+
+## Installing the asset extension
+
+The asset extension comes packaged with Plates but is not enabled by default, as it requires extra parameters passed to it at instantiation.
+
+~~~ php
+// Load asset extension
+$engine->loadExtension(new League\Plates\Extension\Asset('/path/to/public/assets/', true));
+~~~
+
+The first constructor parameter is the file system path of the assets directory. The second is an optional `boolean` parameter that if set to true uses the filename caching method (ie. `file.1373577602.css`) instead of the default query string method (ie. `file.css?v=1373577602`).
+
+## Filename caching
+
+To make filename caching work, some URL rewriting is required:
+
+### Apache example
+~~~ php
+
+ RewriteCond %{REQUEST_FILENAME} !-f
+ RewriteCond %{REQUEST_FILENAME} !-d
+ RewriteRule ^(.+)\.(\d+)\.(js|css|png|jpg|gif)$ $1.$3 [L]
+
+~~~
+
+### Nginx example
+
+~~~ php
+location ~* (.+)\.(?:\d+)\.(js|css|png|jpg|jpeg|gif)$ {
+ try_files $uri $1.$2;
+}
+~~~
+
+## Using the asset extension
+
+~~~ php
+
+
+ Asset Extension Example
+
+
+
+
+
+?>)
+
+
+
+~~~
\ No newline at end of file
diff --git a/vendor/league/plates/docs/extensions/uri.md b/vendor/league/plates/docs/extensions/uri.md
new file mode 100644
index 00000000..e18c2060
--- /dev/null
+++ b/vendor/league/plates/docs/extensions/uri.md
@@ -0,0 +1,83 @@
+---
+layout: default
+permalink: extensions/uri/
+title: URI extension
+---
+
+URI
+===
+
+The URI extension is designed to make URI checks within templates easier. The most common use is marking the current page in a menu as "selected". It only has one function, `uri()`, but can do a number of helpful tasks depending on the parameters passed to it.
+
+## Installing the URI extension
+
+The URI extension comes packaged with Plates but is not enabled by default, as it requires an extra parameter passed to it at instantiation.
+
+~~~ php
+// Load URI extension using global variable
+$engine->loadExtension(new League\Plates\Extension\URI($_SERVER['PATH_INFO']));
+
+// Load URI extension using a HttpFoundation's request object
+$engine->loadExtension(new League\Plates\Extension\URI($request->getPathInfo()));
+~~~
+
+## URI example
+
+~~~ php
+
+ - uri('/', 'class="selected"')?>>Home
+ - uri('/about', 'class="selected"')?>>About
+ - uri('/products', 'class="selected"')?>>Products
+ - uri('/contact', 'class="selected"')?>>Contact
+
+~~~
+
+## Using the URI extension
+
+Get the whole URI.
+
+~~~ php
+uri()?>
+~~~
+
+Get a specified segment of the URI.
+
+~~~ php
+uri(1)?>
+~~~
+
+Check if a specific segment of the URI (first parameter) equals a given string (second parameter). Returns `true` on success or `false` on failure.
+
+~~~ php
+uri(1, 'home')): ?>
+~~~
+
+Check if a specific segment of the URI (first parameter) equals a given string (second parameter). Returns string (third parameter) on success or `false` on failure.
+
+~~~ php
+uri(1, 'home', 'success')?>
+~~~
+
+Check if a specific segment of the URI (first parameter) equals a given string (second parameter). Returns string (third parameter) on success or string (fourth parameter) on failure.
+
+~~~ php
+uri(1, 'home', 'success', 'fail')?>
+~~~
+
+Check if a regular expression string matches the current URI. Returns `true` on success or `false` on failure.
+
+~~~ php
+uri('/home')): ?>
+~~~
+
+Check if a regular expression string (first parameter) matches the current URI. Returns string (second parameter) on success or `false` on failure.
+
+~~~ php
+uri('/home', 'success')?>
+~~~
+
+Check if a regular expression string (first parameter) matches the current URI. Returns string (second parameter) on success or string (third parameter) on failure.
+
+~~~ php
+uri('/home', 'success', 'fail')?>
+~~~
\ No newline at end of file
diff --git a/vendor/league/plates/docs/favicon.ico b/vendor/league/plates/docs/favicon.ico
new file mode 100644
index 00000000..44d7f3ff
Binary files /dev/null and b/vendor/league/plates/docs/favicon.ico differ
diff --git a/vendor/league/plates/docs/index.md b/vendor/league/plates/docs/index.md
new file mode 100644
index 00000000..3c342719
--- /dev/null
+++ b/vendor/league/plates/docs/index.md
@@ -0,0 +1,40 @@
+---
+layout: default
+permalink: /
+title: Introduction
+---
+
+Introduction
+============
+
+[](https://twitter.com/reinink)
+[](https://github.com/thephpleague/plates)
+[](https://github.com/thephpleague/plates/releases)
+[](https://github.com/thephpleague/plates/blob/master/LICENSE)
+[](https://travis-ci.org/thephpleague/plates)
+[](https://scrutinizer-ci.com/g/thephpleague/plates/code-structure)
+[](https://scrutinizer-ci.com/g/thephpleague/plates)
+[](https://packagist.org/packages/league/plates)
+
+## About
+
+Plates is a native PHP template system that's fast, easy to use and easy to extend. It's inspired by the excellent [Twig](http://twig.sensiolabs.org/) template engine and strives to bring modern template language functionality to native PHP templates. Plates is designed for developers who prefer to use native PHP templates over compiled template languages, such as Twig or Smarty.
+
+## Highlights
+
+- Native PHP templates, no new [syntax](/templates/syntax/) to learn
+- Plates is a template system, not a template language
+- Plates encourages the use of existing PHP functions
+- Increase code reuse with template [layouts](/templates/layouts/) and [inheritance](/templates/inheritance/)
+- Template [folders](/engine/folders/) for grouping templates into namespaces
+- [Data](/templates/data/#preassigned-and-shared-data) sharing across templates
+- Preassign [data](/templates/data/#preassigned-and-shared-data) to specific templates
+- Built-in [escaping](/templates/escaping/) helpers
+- Easy to extend using [functions](/engine/functions/) and [extensions](/engine/extensions/)
+- Framework-agnostic, will work with any project
+- Decoupled design makes templates easy to test
+- Composer ready and PSR-2 compliant
+
+## Questions?
+
+Plates was created by [Jonathan Reinink](https://twitter.com/reinink). Submit issues to [Github](https://github.com/thephpleague/plates/issues).
diff --git a/vendor/league/plates/docs/installation.md b/vendor/league/plates/docs/installation.md
new file mode 100644
index 00000000..ba7a2b63
--- /dev/null
+++ b/vendor/league/plates/docs/installation.md
@@ -0,0 +1,35 @@
+---
+layout: default
+permalink: installation/
+title: Installation
+---
+
+Installation
+============
+
+## Using Composer
+
+Plates is available on [Packagist](https://packagist.org/packages/league/plates) and can be installed using [Composer](https://getcomposer.org/). This can be done by running the following command or by updating your `composer.json` file.
+
+~~~ bash
+composer require league/plates
+~~~
+
+composer.json
+~~~ javascript
+{
+ "require": {
+ "league/plates": "3.*"
+ }
+}
+~~~
+
+Be sure to also include your Composer autoload file in your project:
+
+~~~ php
+require 'vendor/autoload.php';
+~~~
+
+## Downloading .zip file
+
+This project is also available for download as a `.zip` file on GitHub. Visit the [releases page](https://github.com/thephpleague/plates/releases), select the version you want, and click the "Source code (zip)" download button.
\ No newline at end of file
diff --git a/vendor/league/plates/docs/logo.png b/vendor/league/plates/docs/logo.png
new file mode 100644
index 00000000..19cf68a7
Binary files /dev/null and b/vendor/league/plates/docs/logo.png differ
diff --git a/vendor/league/plates/docs/simple-example.md b/vendor/league/plates/docs/simple-example.md
new file mode 100644
index 00000000..35f9b71d
--- /dev/null
+++ b/vendor/league/plates/docs/simple-example.md
@@ -0,0 +1,54 @@
+---
+layout: default
+permalink: simple-example/
+title: Simple example
+---
+
+Simple example
+==============
+
+Here is a simple example of how to use Plates. We will assume the following directory stucture:
+
+~~~
+`-- path
+ `-- to
+ `-- templates
+ |-- template.php
+ |-- profile.php
+~~~
+
+## Within your controller
+
+~~~ php
+// Create new Plates instance
+$templates = new League\Plates\Engine('/path/to/templates');
+
+// Render a template
+echo $templates->render('profile', ['name' => 'Jonathan']);
+~~~
+
+## The page template
+
+profile.php
+~~~ php
+layout('template', ['title' => 'User Profile']) ?>
+
+User Profile
+Hello, e($name)?>
+~~~
+
+## The layout template
+
+template.php
+~~~ php
+
+
+ <?=$this->e($title)?>
+
+
+
+section('content')?>
+
+
+
+~~~
\ No newline at end of file
diff --git a/vendor/league/plates/docs/templates/data.md b/vendor/league/plates/docs/templates/data.md
new file mode 100644
index 00000000..33bfb2aa
--- /dev/null
+++ b/vendor/league/plates/docs/templates/data.md
@@ -0,0 +1,61 @@
+---
+layout: default
+permalink: templates/data/
+title: Data
+---
+
+Data
+====
+
+It's very common to share application data (variables) with a template. Data can be whatever you want: strings, arrays, objects, etc. Plates allows you set both template specific data as well as shared template data.
+
+## Assign data
+
+Assigning data is done from within your application code, such as a controller. There are a number of ways to assign the data, depending on how you structure your objects.
+
+~~~ php
+// Create new Plates instance
+$templates = new League\Plates\Engine('/path/to/templates');
+
+// Assign via the engine's render method
+echo $templates->render('profile', ['name' => 'Jonathan']);
+
+// Assign via the engine's make method
+$template = $templates->make('profile', ['name' => 'Jonathan']);
+
+// Assign directly to a template object
+$template = $templates->make('profile');
+$template->data(['name' => 'Jonathan']);
+~~~
+
+## Accessing data
+
+Template data is available as locally scoped variables at the time of rendering. Continuing with the example above, here is how you would [escape](/templates/escaping/) and output the "name" value in a template:
+
+~~~ php
+Hello e($name)?>
+~~~
+
+
+
+## Preassigned and shared data
+
+If you have data that you want assigned to a specific template each time that template is rendered throughout your application, the `addData()` function can help organize that code in one place.
+
+~~~ php
+$templates->addData(['name' => 'Jonathan'], 'emails::welcome');
+~~~
+
+You can pressaign data to more than one template by passing an array of templates:
+
+~~~ php
+$templates->addData(['name' => 'Jonathan'], ['login', 'template']);
+~~~
+
+To assign data to ALL templates, simply omit the second parameter:
+
+~~~ php
+$templates->addData(['name' => 'Jonathan']);
+~~~
+
+Keep in mind that shared data is assigned to a template when it's first created, meaning any conflicting data assigned that's afterwards to a specific template will overwrite the shared data. This is generally desired behavior.
\ No newline at end of file
diff --git a/vendor/league/plates/docs/templates/escaping.md b/vendor/league/plates/docs/templates/escaping.md
new file mode 100644
index 00000000..4dcd2f62
--- /dev/null
+++ b/vendor/league/plates/docs/templates/escaping.md
@@ -0,0 +1,50 @@
+---
+layout: default
+permalink: templates/escaping/
+title: Escaping
+---
+
+Escaping
+========
+
+Escaping is a form of [data filtering](http://www.phptherightway.com/#data_filtering) which sanitizes unsafe, user supplied input prior to outputting it as HTML. Plates provides two shortcuts to the `htmlspecialchars()` function.
+
+## Escaping example
+
+~~~ php
+Hello, escape($name)?>
+
+
+Hello, e($name)?>
+~~~
+
+## Batch function calls
+
+The escape functions also support [batch](/templates/functions/#batch-function-calls) function calls, which allow you to apply multiple functions, including native PHP functions, to a variable at one time.
+
+~~~ php
+Welcome e($name, 'strip_tags|strtoupper')?>
+~~~
+
+## Escaping HTML attributes
+
+
+
+Some [libraries](http://framework.zend.com/manual/2.1/en/modules/zend.escaper.escaping-html-attributes.html) go as far as having a special function for escaping HTML attributes. However, this is somewhat redundant considering that if a developer forgets to properly quote an HTML attribute, they will likely also forget to use this special function. Here is how you properly escape HTML attributes:
+
+~~~ php
+
+
+
+
+
+
+
+e($name)?>>
+~~~
+
+## Automatic escaping
+
+Probably the biggest drawbacks to native PHP templates is the inability to auto-escape variables properly. Template languages like Twig and Smarty can identify "echoed" variables during a parsing stage and automatically escape them. This cannot be done in native PHP as the language does not offer overloading functionality for it's output functions (ie. `print` and `echo`).
+
+Don't worry, escaping can still be done safely, it just means you are responsible for manually escaping each variable on output. Consider creating a snippet for one of the above, built-in escaping functions to make this process easier.
\ No newline at end of file
diff --git a/vendor/league/plates/docs/templates/functions.md b/vendor/league/plates/docs/templates/functions.md
new file mode 100644
index 00000000..234d9cf1
--- /dev/null
+++ b/vendor/league/plates/docs/templates/functions.md
@@ -0,0 +1,47 @@
+---
+layout: default
+permalink: templates/functions/
+title: Functions
+---
+
+Functions
+=========
+
+Template functions in Plates are accessed using the `$this` pseudo-variable.
+
+~~~ php
+Hello, escape($name)?>
+~~~
+
+
+## Custom fuctions
+
+In addition to the functions included with Plates, it's also possible to add [one-off functions](/engine/functions/), or even groups of functions, known as [extensions](/engine/extensions/).
+
+## Batch function calls
+
+Sometimes you need to apply more than function to a variable in your templates. This can become somewhat illegible. The `batch()` function helps by allowing you to apply multiple functions, including native PHP functions, to a variable at one time.
+
+~~~ php
+
+Welcome escape(strtoupper(strip_tags($name)))?>
+
+
+Welcome batch($name, 'strip_tags|strtoupper|escape')?>
+~~~
+
+The [escape](/templates/escaping/) functions also support batch function calls.
+
+~~~ php
+Welcome e($name, 'strip_tags|strtoupper')?>
+~~~
+
+The batch functions works well for "piped" functions that accept one parameter, modify it, and then return it. It's important to note that they execute functions left to right and will favour extension functions over native PHP functions if there are conflicts.
+
+~~~ php
+
+batch('Jonathan', 'escape|strtolower|strtoupper')?>
+
+
+batch('Jonathan', 'escape|strtoupper|strtolower')?>
+~~~
\ No newline at end of file
diff --git a/vendor/league/plates/docs/templates/index.md b/vendor/league/plates/docs/templates/index.md
new file mode 100644
index 00000000..f08f1469
--- /dev/null
+++ b/vendor/league/plates/docs/templates/index.md
@@ -0,0 +1,73 @@
+---
+layout: default
+permalink: templates/
+title: Templates
+---
+
+Templates
+=========
+
+Plates templates are very simple PHP objects. Generally you'll want to create these using the two factory methods, `make()` and `render()`, in the [engine](/engine/). For example:
+
+~~~ php
+// Create new Plates instance
+$templates = new League\Plates\Engine('/path/to/templates');
+
+// Render a template in a subdirectory
+echo $templates->render('partials/header');
+
+// Render a template
+echo $templates->render('profile', ['name' => 'Jonathan']);
+~~~
+
+For more information about how Plates is designed to be easily added to your application, see the section on [dependency injection](/engine/#dependency-injection).
+
+## Manually creating templates
+
+It's also possible to create templates manually. The only dependency they require is an instance of the [engine](/engine/) object. For example:
+
+~~~ php
+// Create new Plates instance
+$templates = new League\Plates\Engine('/path/to/templates');
+
+// Create a new template
+$template = new League\Plates\Template\Template($templates, 'profile');
+
+// Render the template
+echo $template->render(['name' => 'Jonathan']);
+
+// You can also render the template using the toString() magic method
+echo $template;
+~~~
+
+## Check if a template exists
+
+When dynamically loading templates, you may need to check if they exist. This can be done using the engine's `exists()` method:
+
+~~~ php
+if ($templates->exists('articles::beginners_guide')) {
+ // It exists!
+}
+~~~
+
+You can also run this check on an existing template:
+
+~~~ php
+if ($template->exists()) {
+ // It exists!
+}
+~~~
+
+## Get a template path
+
+To get a template path from its name, use the engine's `path()` method:
+
+~~~ php
+$path = $templates->path('articles::beginners_guide');
+~~~
+
+You can also get the path from an existing template:
+
+~~~ php
+$path = $template->path();
+~~~
diff --git a/vendor/league/plates/docs/templates/inheritance.md b/vendor/league/plates/docs/templates/inheritance.md
new file mode 100644
index 00000000..9b0f211a
--- /dev/null
+++ b/vendor/league/plates/docs/templates/inheritance.md
@@ -0,0 +1,63 @@
+---
+layout: default
+permalink: templates/inheritance/
+title: Inheritance
+---
+
+Inheritance
+===========
+
+By combining [layouts](/templates/layouts/) and [sections](/templates/sections/), Plates allows you to "build up" your pages using predefined sections. This is best understand using an example:
+
+
+## Inheritance example
+
+The following example illustrates a pretty standard website. Start by creating a site template, which includes your header and footer as well as any predefined content [sections](/templates/sections/). Notice how Plates makes it possible to even set default section content, in the event that a page doesn't define it.
+
+template.php
+~~~ php
+
+
+ <?=$this->e($title)?>
+
+
+
+
+
+
+ section('page')?>
+
+
+
+
+
+
+~~~
+
+With the template defined, any page can now "implement" this [layout](/templates/layouts/). Notice how each section of content is defined between the `start()` and `end()` functions.
+
+profile.php
+~~~ php
+layout('template', ['title' => 'User Profile']) ?>
+
+start('page') ?>
+ Welcome!
+ Hello e($name)?>
+stop() ?>
+
+start('sidebar') ?>
+
+ - Example Link
+ - Example Link
+ - Example Link
+ - Example Link
+ - Example Link
+
+stop() ?>
+~~~
\ No newline at end of file
diff --git a/vendor/league/plates/docs/templates/layouts.md b/vendor/league/plates/docs/templates/layouts.md
new file mode 100644
index 00000000..63c871df
--- /dev/null
+++ b/vendor/league/plates/docs/templates/layouts.md
@@ -0,0 +1,102 @@
+---
+layout: default
+permalink: templates/layouts/
+title: Layouts
+---
+
+Layouts
+=======
+
+The `layout()` function allows you to define a layout template that a template will implement. It's like having separate header and footer templates in one file.
+
+## Define a layout
+
+The `layout()` function can be called anywhere in a template, since the layout template is actually rendered second. Typically it's placed at the top of the file.
+
+~~~ php
+layout('template') ?>
+
+User Profile
+Hello, e($name)?>
+~~~
+
+This function also works with [folders](/engine/folders/):
+
+~~~ php
+layout('shared::template') ?>
+~~~
+
+## Assign data
+
+To assign data (variables) to a layout template, pass them as an array to the `layout()` function. This data will then be available as locally scoped variables within the layout template.
+
+~~~ php
+layout('template', ['title' => 'User Profile']) ?>
+~~~
+
+## Accessing the content
+
+To access the rendered template content within the layout, use the `section()` function, passing `'content'` as the section name. This will return all outputted content from the template that hasn't been defined in a [section](/templates/sections/).
+
+~~~ php
+
+
+ <?=$this->e($title)?>
+
+
+
+section('content')?>
+
+
+
+~~~
+
+## Stacked layouts
+
+Plates allows stacking of layouts, allowing even further simplification and organization of templates. Instead of just using one main layout, it's possible to break templates into more specific layouts, which themselves implement a main layout. Consider this example:
+
+### The main site layout
+
+template.php
+~~~ php
+
+
+ <?=$this->e($title)?>
+
+
+
+section('content')?>
+
+
+
+~~~
+
+### The blog layout
+
+blog.php
+~~~ php
+layout('template') ?>
+
+The Blog
+
+
+
+ section('content')?>
+
+
+
+~~~
+
+### A blog article
+
+blog-article.php
+~~~ php
+layout('blog', ['title' => $article->title]) ?>
+
+e($article->title)?>
+
+ e($article->content)?>
+
+~~~
\ No newline at end of file
diff --git a/vendor/league/plates/docs/templates/nesting.md b/vendor/league/plates/docs/templates/nesting.md
new file mode 100644
index 00000000..bc60aeb9
--- /dev/null
+++ b/vendor/league/plates/docs/templates/nesting.md
@@ -0,0 +1,44 @@
+---
+layout: default
+permalink: templates/nesting/
+title: Nesting
+---
+
+Nesting
+=======
+
+Including another template into the current template is done using the `insert()` function:
+
+~~~ php
+insert('partials/header') ?>
+
+Your content.
+
+insert('partials/footer') ?>
+~~~
+
+The `insert()` function also works with [folders](/engine/folders/):
+
+~~~ php
+insert('partials::header') ?>
+~~~
+
+## Alternative syntax
+
+The `insert()` function automatically outputs the rendered template. If you prefer to manually output the response, use the `fetch()` function instead:
+
+~~~ php
+fetch('partials/header')?>
+~~~
+
+## Assign data
+
+To assign data (variables) to a nested template, pass them as an array to the `insert()` or `fetch()` functions. This data will then be available as locally scoped variables within the nested template.
+
+~~~ php
+insert('partials/header', ['name' => 'Jonathan']) ?>
+
+Your content.
+
+insert('partials/footer') ?>
+~~~
\ No newline at end of file
diff --git a/vendor/league/plates/docs/templates/sections.md b/vendor/league/plates/docs/templates/sections.md
new file mode 100644
index 00000000..a5cadcd3
--- /dev/null
+++ b/vendor/league/plates/docs/templates/sections.md
@@ -0,0 +1,80 @@
+---
+layout: default
+permalink: templates/sections/
+title: Sections
+---
+
+Sections
+========
+
+The `start()` and `stop` functions allow you to build sections (or blocks) of content within your template, and instead of them being rendered directly, they are saved for use elsewhere. For example, in your [layout](/templates/layouts/) template.
+
+## Creating sections
+
+You define the name of the section with the `start()` function. To end a section call the `stop()` function.
+
+~~~ php
+start('welcome') ?>
+
+ Welcome!
+ Hello e($name)?>
+
+stop() ?>
+~~~
+
+## Stacking section content
+
+By default, when you render a section its content will overwrite any existing content for that section. However, it's possible to append (or stack) the content instead using the `push()` method. This can be useful for specifying any JavaScript libraries required by your child views.
+
+~~~ php
+push('scripts') ?>
+
+end() ?>
+~~~
+
+
+
+## Accessing section content
+
+Access rendered section content using the name you assigned in the `start()` method. This variable can be accessed from the current template and layout templates using the `section()` function.
+
+~~~ php
+section('welcome')?>
+~~~
+
+
+
+## Default section content
+
+In situations where a page doesn't implement a particular section, it's helpful to assign default content. There are a couple ways to do this:
+
+### Defining it inline
+
+If the default content can be defined in a single line of code, it's best to simply pass it as the second parameter of the `content()` function.
+
+~~~ php
+
+~~~
+
+### Use an if statement
+
+If the default content requires more than a single line of code, it's best to use a simple if statement to check if a section exists, and otherwise display the default.
+
+~~~ php
+
+~~~
+
diff --git a/vendor/league/plates/docs/templates/syntax.md b/vendor/league/plates/docs/templates/syntax.md
new file mode 100644
index 00000000..c2a78e9c
--- /dev/null
+++ b/vendor/league/plates/docs/templates/syntax.md
@@ -0,0 +1,50 @@
+---
+layout: default
+permalink: templates/syntax/
+title: Syntax
+---
+
+Syntax
+======
+
+While the actual syntax you use in your templates is entirely your choice (it's just PHP after all), we suggest the following syntax guidelines to help keep templates clean and legible.
+
+## Guidelines
+
+- Always use HTML with inline PHP. Never use blocks of PHP.
+- Always escape potentially dangerous variables prior to outputting using the built-in escape functions. More on escaping [here](/templates/escaping/).
+- Always use the short echo syntax (`layout('template', ['title' => 'User Profile']) ?>
+
+Welcome!
+Hello e($name)?>
+
+Friends
+
+
+ -
+
+ e($friend->name)?>
+
+
+
+
+
+
+ Invitations
+ You have some friend invites!
+
+~~~
diff --git a/vendor/league/plates/example/example.php b/vendor/league/plates/example/example.php
new file mode 100644
index 00000000..aaffe052
--- /dev/null
+++ b/vendor/league/plates/example/example.php
@@ -0,0 +1,12 @@
+addData(['company' => 'The Company Name'], 'layout');
+
+// Render a template
+echo $templates->render('profile', ['name' => 'Jonathan']);
diff --git a/vendor/league/plates/example/templates/layout.php b/vendor/league/plates/example/templates/layout.php
new file mode 100644
index 00000000..5b5847cf
--- /dev/null
+++ b/vendor/league/plates/example/templates/layout.php
@@ -0,0 +1,12 @@
+
+
+ <?=$this->e($title)?> | <?=$this->e($company)?>
+
+
+
+section('content')?>
+
+section('scripts')?>
+
+
+
\ No newline at end of file
diff --git a/vendor/league/plates/example/templates/profile.php b/vendor/league/plates/example/templates/profile.php
new file mode 100644
index 00000000..0797e463
--- /dev/null
+++ b/vendor/league/plates/example/templates/profile.php
@@ -0,0 +1,12 @@
+layout('layout', ['title' => 'User Profile']) ?>
+
+User Profile
+Hello, e($name)?>!
+
+insert('sidebar') ?>
+
+push('scripts') ?>
+
+end() ?>
\ No newline at end of file
diff --git a/vendor/league/plates/example/templates/sidebar.php b/vendor/league/plates/example/templates/sidebar.php
new file mode 100644
index 00000000..13d9ea83
--- /dev/null
+++ b/vendor/league/plates/example/templates/sidebar.php
@@ -0,0 +1,6 @@
+
\ No newline at end of file
diff --git a/vendor/league/plates/phpunit.xml.dist b/vendor/league/plates/phpunit.xml.dist
new file mode 100644
index 00000000..aae18548
--- /dev/null
+++ b/vendor/league/plates/phpunit.xml.dist
@@ -0,0 +1,20 @@
+
+
+
+
+ tests/
+
+
+
+
+ src/
+
+
+
+
+
diff --git a/vendor/league/plates/src/Engine.php b/vendor/league/plates/src/Engine.php
new file mode 100644
index 00000000..6c89642b
--- /dev/null
+++ b/vendor/league/plates/src/Engine.php
@@ -0,0 +1,279 @@
+directory = new Directory($directory);
+ $this->fileExtension = new FileExtension($fileExtension);
+ $this->folders = new Folders();
+ $this->functions = new Functions();
+ $this->data = new Data();
+ }
+
+ /**
+ * Set path to templates directory.
+ * @param string|null $directory Pass null to disable the default directory.
+ * @return Engine
+ */
+ public function setDirectory($directory)
+ {
+ $this->directory->set($directory);
+
+ return $this;
+ }
+
+ /**
+ * Get path to templates directory.
+ * @return string
+ */
+ public function getDirectory()
+ {
+ return $this->directory->get();
+ }
+
+ /**
+ * Set the template file extension.
+ * @param string|null $fileExtension Pass null to manually set it.
+ * @return Engine
+ */
+ public function setFileExtension($fileExtension)
+ {
+ $this->fileExtension->set($fileExtension);
+
+ return $this;
+ }
+
+ /**
+ * Get the template file extension.
+ * @return string
+ */
+ public function getFileExtension()
+ {
+ return $this->fileExtension->get();
+ }
+
+ /**
+ * Add a new template folder for grouping templates under different namespaces.
+ * @param string $name
+ * @param string $directory
+ * @param boolean $fallback
+ * @return Engine
+ */
+ public function addFolder($name, $directory, $fallback = false)
+ {
+ $this->folders->add($name, $directory, $fallback);
+
+ return $this;
+ }
+
+ /**
+ * Remove a template folder.
+ * @param string $name
+ * @return Engine
+ */
+ public function removeFolder($name)
+ {
+ $this->folders->remove($name);
+
+ return $this;
+ }
+
+ /**
+ * Get collection of all template folders.
+ * @return Folders
+ */
+ public function getFolders()
+ {
+ return $this->folders;
+ }
+
+ /**
+ * Add preassigned template data.
+ * @param array $data;
+ * @param null|string|array $templates;
+ * @return Engine
+ */
+ public function addData(array $data, $templates = null)
+ {
+ $this->data->add($data, $templates);
+
+ return $this;
+ }
+
+ /**
+ * Get all preassigned template data.
+ * @param null|string $template;
+ * @return array
+ */
+ public function getData($template = null)
+ {
+ return $this->data->get($template);
+ }
+
+ /**
+ * Register a new template function.
+ * @param string $name;
+ * @param callback $callback;
+ * @return Engine
+ */
+ public function registerFunction($name, $callback)
+ {
+ $this->functions->add($name, $callback);
+
+ return $this;
+ }
+
+ /**
+ * Remove a template function.
+ * @param string $name;
+ * @return Engine
+ */
+ public function dropFunction($name)
+ {
+ $this->functions->remove($name);
+
+ return $this;
+ }
+
+ /**
+ * Get a template function.
+ * @param string $name
+ * @return Func
+ */
+ public function getFunction($name)
+ {
+ return $this->functions->get($name);
+ }
+
+ /**
+ * Check if a template function exists.
+ * @param string $name
+ * @return boolean
+ */
+ public function doesFunctionExist($name)
+ {
+ return $this->functions->exists($name);
+ }
+
+ /**
+ * Load an extension.
+ * @param ExtensionInterface $extension
+ * @return Engine
+ */
+ public function loadExtension(ExtensionInterface $extension)
+ {
+ $extension->register($this);
+
+ return $this;
+ }
+
+ /**
+ * Load multiple extensions.
+ * @param array $extensions
+ * @return Engine
+ */
+ public function loadExtensions(array $extensions = array())
+ {
+ foreach ($extensions as $extension) {
+ $this->loadExtension($extension);
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get a template path.
+ * @param string $name
+ * @return string
+ */
+ public function path($name)
+ {
+ $name = new Name($this, $name);
+
+ return $name->getPath();
+ }
+
+ /**
+ * Check if a template exists.
+ * @param string $name
+ * @return boolean
+ */
+ public function exists($name)
+ {
+ $name = new Name($this, $name);
+
+ return $name->doesPathExist();
+ }
+
+ /**
+ * Create a new template.
+ * @param string $name
+ * @return Template
+ */
+ public function make($name)
+ {
+ return new Template($this, $name);
+ }
+
+ /**
+ * Create a new template and render it.
+ * @param string $name
+ * @param array $data
+ * @return string
+ */
+ public function render($name, array $data = array())
+ {
+ return $this->make($name)->render($data);
+ }
+}
diff --git a/vendor/league/plates/src/Extension/Asset.php b/vendor/league/plates/src/Extension/Asset.php
new file mode 100644
index 00000000..91d39f66
--- /dev/null
+++ b/vendor/league/plates/src/Extension/Asset.php
@@ -0,0 +1,85 @@
+path = rtrim($path, '/');
+ $this->filenameMethod = $filenameMethod;
+ }
+
+ /**
+ * Register extension function.
+ * @param Engine $engine
+ * @return null
+ */
+ public function register(Engine $engine)
+ {
+ $engine->registerFunction('asset', array($this, 'cachedAssetUrl'));
+ }
+
+ /**
+ * Create "cache busted" asset URL.
+ * @param string $url
+ * @return string
+ */
+ public function cachedAssetUrl($url)
+ {
+ $filePath = $this->path . '/' . ltrim($url, '/');
+
+ if (!file_exists($filePath)) {
+ throw new LogicException(
+ 'Unable to locate the asset "' . $url . '" in the "' . $this->path . '" directory.'
+ );
+ }
+
+ $lastUpdated = filemtime($filePath);
+ $pathInfo = pathinfo($url);
+
+ if ($pathInfo['dirname'] === '.') {
+ $directory = '';
+ } elseif ($pathInfo['dirname'] === '/') {
+ $directory = '/';
+ } else {
+ $directory = $pathInfo['dirname'] . '/';
+ }
+
+ if ($this->filenameMethod) {
+ return $directory . $pathInfo['filename'] . '.' . $lastUpdated . '.' . $pathInfo['extension'];
+ }
+
+ return $directory . $pathInfo['filename'] . '.' . $pathInfo['extension'] . '?v=' . $lastUpdated;
+ }
+}
diff --git a/vendor/league/plates/src/Extension/ExtensionInterface.php b/vendor/league/plates/src/Extension/ExtensionInterface.php
new file mode 100644
index 00000000..0164d1ea
--- /dev/null
+++ b/vendor/league/plates/src/Extension/ExtensionInterface.php
@@ -0,0 +1,13 @@
+uri = $uri;
+ $this->parts = explode('/', $this->uri);
+ }
+
+ /**
+ * Register extension functions.
+ * @param Engine $engine
+ * @return null
+ */
+ public function register(Engine $engine)
+ {
+ $engine->registerFunction('uri', array($this, 'runUri'));
+ }
+
+ /**
+ * Perform URI check.
+ * @param null|integer|string $var1
+ * @param mixed $var2
+ * @param mixed $var3
+ * @param mixed $var4
+ * @return mixed
+ */
+ public function runUri($var1 = null, $var2 = null, $var3 = null, $var4 = null)
+ {
+ if (is_null($var1)) {
+ return $this->uri;
+ }
+
+ if (is_numeric($var1) and is_null($var2)) {
+ return array_key_exists($var1, $this->parts) ? $this->parts[$var1] : null;
+ }
+
+ if (is_numeric($var1) and is_string($var2)) {
+ return $this->checkUriSegmentMatch($var1, $var2, $var3, $var4);
+ }
+
+ if (is_string($var1)) {
+ return $this->checkUriRegexMatch($var1, $var2, $var3);
+ }
+
+ throw new LogicException('Invalid use of the uri function.');
+ }
+
+ /**
+ * Perform a URI segment match.
+ * @param integer $key
+ * @param string $string
+ * @param mixed $returnOnTrue
+ * @param mixed $returnOnFalse
+ * @return mixed
+ */
+ protected function checkUriSegmentMatch($key, $string, $returnOnTrue = null, $returnOnFalse = null)
+ {
+ if (array_key_exists($key, $this->parts) && $this->parts[$key] === $string) {
+ return is_null($returnOnTrue) ? true : $returnOnTrue;
+ }
+
+ return is_null($returnOnFalse) ? false : $returnOnFalse;
+ }
+
+ /**
+ * Perform a regular express match.
+ * @param string $regex
+ * @param mixed $returnOnTrue
+ * @param mixed $returnOnFalse
+ * @return mixed
+ */
+ protected function checkUriRegexMatch($regex, $returnOnTrue = null, $returnOnFalse = null)
+ {
+ if (preg_match('#^' . $regex . '$#', $this->uri) === 1) {
+ return is_null($returnOnTrue) ? true : $returnOnTrue;
+ }
+
+ return is_null($returnOnFalse) ? false : $returnOnFalse;
+ }
+}
diff --git a/vendor/league/plates/src/Template/Data.php b/vendor/league/plates/src/Template/Data.php
new file mode 100644
index 00000000..aa4d1e1e
--- /dev/null
+++ b/vendor/league/plates/src/Template/Data.php
@@ -0,0 +1,93 @@
+shareWithAll($data);
+ }
+
+ if (is_array($templates)) {
+ return $this->shareWithSome($data, $templates);
+ }
+
+ if (is_string($templates)) {
+ return $this->shareWithSome($data, array($templates));
+ }
+
+ throw new LogicException(
+ 'The templates variable must be null, an array or a string, ' . gettype($templates) . ' given.'
+ );
+ }
+
+ /**
+ * Add data shared with all templates.
+ * @param array $data;
+ * @return Data
+ */
+ public function shareWithAll($data)
+ {
+ $this->sharedVariables = array_merge($this->sharedVariables, $data);
+
+ return $this;
+ }
+
+ /**
+ * Add data shared with some templates.
+ * @param array $data;
+ * @param array $templates;
+ * @return Data
+ */
+ public function shareWithSome($data, array $templates)
+ {
+ foreach ($templates as $template) {
+ if (isset($this->templateVariables[$template])) {
+ $this->templateVariables[$template] = array_merge($this->templateVariables[$template], $data);
+ } else {
+ $this->templateVariables[$template] = $data;
+ }
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get template data.
+ * @param null|string $template;
+ * @return array
+ */
+ public function get($template = null)
+ {
+ if (isset($template, $this->templateVariables[$template])) {
+ return array_merge($this->sharedVariables, $this->templateVariables[$template]);
+ }
+
+ return $this->sharedVariables;
+ }
+}
diff --git a/vendor/league/plates/src/Template/Directory.php b/vendor/league/plates/src/Template/Directory.php
new file mode 100644
index 00000000..f5de5374
--- /dev/null
+++ b/vendor/league/plates/src/Template/Directory.php
@@ -0,0 +1,53 @@
+set($path);
+ }
+
+ /**
+ * Set path to templates directory.
+ * @param string|null $path Pass null to disable the default directory.
+ * @return Directory
+ */
+ public function set($path)
+ {
+ if (!is_null($path) and !is_dir($path)) {
+ throw new LogicException(
+ 'The specified path "' . $path . '" does not exist.'
+ );
+ }
+
+ $this->path = $path;
+
+ return $this;
+ }
+
+ /**
+ * Get path to templates directory.
+ * @return string
+ */
+ public function get()
+ {
+ return $this->path;
+ }
+}
diff --git a/vendor/league/plates/src/Template/FileExtension.php b/vendor/league/plates/src/Template/FileExtension.php
new file mode 100644
index 00000000..57646bdd
--- /dev/null
+++ b/vendor/league/plates/src/Template/FileExtension.php
@@ -0,0 +1,45 @@
+set($fileExtension);
+ }
+
+ /**
+ * Set the template file extension.
+ * @param null|string $fileExtension
+ * @return FileExtension
+ */
+ public function set($fileExtension)
+ {
+ $this->fileExtension = $fileExtension;
+
+ return $this;
+ }
+
+ /**
+ * Get the template file extension.
+ * @return string
+ */
+ public function get()
+ {
+ return $this->fileExtension;
+ }
+}
diff --git a/vendor/league/plates/src/Template/Folder.php b/vendor/league/plates/src/Template/Folder.php
new file mode 100644
index 00000000..01fcbdd2
--- /dev/null
+++ b/vendor/league/plates/src/Template/Folder.php
@@ -0,0 +1,109 @@
+setName($name);
+ $this->setPath($path);
+ $this->setFallback($fallback);
+ }
+
+ /**
+ * Set the folder name.
+ * @param string $name
+ * @return Folder
+ */
+ public function setName($name)
+ {
+ $this->name = $name;
+
+ return $this;
+ }
+
+ /**
+ * Get the folder name.
+ * @return string
+ */
+ public function getName()
+ {
+ return $this->name;
+ }
+
+ /**
+ * Set the folder path.
+ * @param string $path
+ * @return Folder
+ */
+ public function setPath($path)
+ {
+ if (!is_dir($path)) {
+ throw new LogicException('The specified directory path "' . $path . '" does not exist.');
+ }
+
+ $this->path = $path;
+
+ return $this;
+ }
+
+ /**
+ * Get the folder path.
+ * @return string
+ */
+ public function getPath()
+ {
+ return $this->path;
+ }
+
+ /**
+ * Set the folder fallback status.
+ * @param boolean $fallback
+ * @return Folder
+ */
+ public function setFallback($fallback)
+ {
+ $this->fallback = $fallback;
+
+ return $this;
+ }
+
+ /**
+ * Get the folder fallback status.
+ * @return boolean
+ */
+ public function getFallback()
+ {
+ return $this->fallback;
+ }
+}
diff --git a/vendor/league/plates/src/Template/Folders.php b/vendor/league/plates/src/Template/Folders.php
new file mode 100644
index 00000000..9bf266a7
--- /dev/null
+++ b/vendor/league/plates/src/Template/Folders.php
@@ -0,0 +1,75 @@
+exists($name)) {
+ throw new LogicException('The template folder "' . $name . '" is already being used.');
+ }
+
+ $this->folders[$name] = new Folder($name, $path, $fallback);
+
+ return $this;
+ }
+
+ /**
+ * Remove a template folder.
+ * @param string $name
+ * @return Folders
+ */
+ public function remove($name)
+ {
+ if (!$this->exists($name)) {
+ throw new LogicException('The template folder "' . $name . '" was not found.');
+ }
+
+ unset($this->folders[$name]);
+
+ return $this;
+ }
+
+ /**
+ * Get a template folder.
+ * @param string $name
+ * @return Folder
+ */
+ public function get($name)
+ {
+ if (!$this->exists($name)) {
+ throw new LogicException('The template folder "' . $name . '" was not found.');
+ }
+
+ return $this->folders[$name];
+ }
+
+ /**
+ * Check if a template folder exists.
+ * @param string $name
+ * @return boolean
+ */
+ public function exists($name)
+ {
+ return isset($this->folders[$name]);
+ }
+}
diff --git a/vendor/league/plates/src/Template/Func.php b/vendor/league/plates/src/Template/Func.php
new file mode 100644
index 00000000..79141f46
--- /dev/null
+++ b/vendor/league/plates/src/Template/Func.php
@@ -0,0 +1,107 @@
+setName($name);
+ $this->setCallback($callback);
+ }
+
+ /**
+ * Set the function name.
+ * @param string $name
+ * @return Func
+ */
+ public function setName($name)
+ {
+ if (preg_match('/^[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*$/', $name) !== 1) {
+ throw new LogicException(
+ 'Not a valid function name.'
+ );
+ }
+
+ $this->name = $name;
+
+ return $this;
+ }
+
+ /**
+ * Get the function name.
+ * @return string
+ */
+ public function getName()
+ {
+ return $this->name;
+ }
+
+ /**
+ * Set the function callback
+ * @param callable $callback
+ * @return Func
+ */
+ public function setCallback($callback)
+ {
+ if (!is_callable($callback, true)) {
+ throw new LogicException(
+ 'Not a valid function callback.'
+ );
+ }
+
+ $this->callback = $callback;
+
+ return $this;
+ }
+
+ /**
+ * Get the function callback.
+ * @return callable
+ */
+ public function getCallback()
+ {
+ return $this->callback;
+ }
+
+ /**
+ * Call the function.
+ * @param Template $template
+ * @param array $arguments
+ * @return mixed
+ */
+ public function call(Template $template = null, $arguments = array())
+ {
+ if (is_array($this->callback) and
+ isset($this->callback[0]) and
+ $this->callback[0] instanceof ExtensionInterface
+ ) {
+ $this->callback[0]->template = $template;
+ }
+
+ return call_user_func_array($this->callback, $arguments);
+ }
+}
diff --git a/vendor/league/plates/src/Template/Functions.php b/vendor/league/plates/src/Template/Functions.php
new file mode 100644
index 00000000..e0e4c2c1
--- /dev/null
+++ b/vendor/league/plates/src/Template/Functions.php
@@ -0,0 +1,78 @@
+exists($name)) {
+ throw new LogicException(
+ 'The template function name "' . $name . '" is already registered.'
+ );
+ }
+
+ $this->functions[$name] = new Func($name, $callback);
+
+ return $this;
+ }
+
+ /**
+ * Remove a template function.
+ * @param string $name;
+ * @return Functions
+ */
+ public function remove($name)
+ {
+ if (!$this->exists($name)) {
+ throw new LogicException(
+ 'The template function "' . $name . '" was not found.'
+ );
+ }
+
+ unset($this->functions[$name]);
+
+ return $this;
+ }
+
+ /**
+ * Get a template function.
+ * @param string $name
+ * @return Func
+ */
+ public function get($name)
+ {
+ if (!$this->exists($name)) {
+ throw new LogicException('The template function "' . $name . '" was not found.');
+ }
+
+ return $this->functions[$name];
+ }
+
+ /**
+ * Check if a template function exists.
+ * @param string $name
+ * @return boolean
+ */
+ public function exists($name)
+ {
+ return isset($this->functions[$name]);
+ }
+}
diff --git a/vendor/league/plates/src/Template/Name.php b/vendor/league/plates/src/Template/Name.php
new file mode 100644
index 00000000..a999d74d
--- /dev/null
+++ b/vendor/league/plates/src/Template/Name.php
@@ -0,0 +1,202 @@
+setEngine($engine);
+ $this->setName($name);
+ }
+
+ /**
+ * Set the engine.
+ * @param Engine $engine
+ * @return Name
+ */
+ public function setEngine(Engine $engine)
+ {
+ $this->engine = $engine;
+
+ return $this;
+ }
+
+ /**
+ * Get the engine.
+ * @return Engine
+ */
+ public function getEngine()
+ {
+ return $this->engine;
+ }
+
+ /**
+ * Set the original name and parse it.
+ * @param string $name
+ * @return Name
+ */
+ public function setName($name)
+ {
+ $this->name = $name;
+
+ $parts = explode('::', $this->name);
+
+ if (count($parts) === 1) {
+ $this->setFile($parts[0]);
+ } elseif (count($parts) === 2) {
+ $this->setFolder($parts[0]);
+ $this->setFile($parts[1]);
+ } else {
+ throw new LogicException(
+ 'The template name "' . $this->name . '" is not valid. ' .
+ 'Do not use the folder namespace separator "::" more than once.'
+ );
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get the original name.
+ * @return string
+ */
+ public function getName()
+ {
+ return $this->name;
+ }
+
+ /**
+ * Set the parsed template folder.
+ * @param string $folder
+ * @return Name
+ */
+ public function setFolder($folder)
+ {
+ $this->folder = $this->engine->getFolders()->get($folder);
+
+ return $this;
+ }
+
+ /**
+ * Get the parsed template folder.
+ * @return string
+ */
+ public function getFolder()
+ {
+ return $this->folder;
+ }
+
+ /**
+ * Set the parsed template file.
+ * @param string $file
+ * @return Name
+ */
+ public function setFile($file)
+ {
+ if ($file === '') {
+ throw new LogicException(
+ 'The template name "' . $this->name . '" is not valid. ' .
+ 'The template name cannot be empty.'
+ );
+ }
+
+ $this->file = $file;
+
+ if (!is_null($this->engine->getFileExtension())) {
+ $this->file .= '.' . $this->engine->getFileExtension();
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get the parsed template file.
+ * @return string
+ */
+ public function getFile()
+ {
+ return $this->file;
+ }
+
+ /**
+ * Resolve template path.
+ * @return string
+ */
+ public function getPath()
+ {
+ if (is_null($this->folder)) {
+ return $this->getDefaultDirectory() . DIRECTORY_SEPARATOR . $this->file;
+ }
+
+ $path = $this->folder->getPath() . DIRECTORY_SEPARATOR . $this->file;
+
+ if (!is_file($path) and $this->folder->getFallback() and is_file($this->getDefaultDirectory() . DIRECTORY_SEPARATOR . $this->file)) {
+ $path = $this->getDefaultDirectory() . DIRECTORY_SEPARATOR . $this->file;
+ }
+
+ return $path;
+ }
+
+ /**
+ * Check if template path exists.
+ * @return boolean
+ */
+ public function doesPathExist()
+ {
+ return is_file($this->getPath());
+ }
+
+ /**
+ * Get the default templates directory.
+ * @return string
+ */
+ protected function getDefaultDirectory()
+ {
+ $directory = $this->engine->getDirectory();
+
+ if (is_null($directory)) {
+ throw new LogicException(
+ 'The template name "' . $this->name . '" is not valid. '.
+ 'The default directory has not been defined.'
+ );
+ }
+
+ return $directory;
+ }
+}
diff --git a/vendor/league/plates/src/Template/Template.php b/vendor/league/plates/src/Template/Template.php
new file mode 100644
index 00000000..0a88c8cf
--- /dev/null
+++ b/vendor/league/plates/src/Template/Template.php
@@ -0,0 +1,346 @@
+engine = $engine;
+ $this->name = new Name($engine, $name);
+
+ $this->data($this->engine->getData($name));
+ }
+
+ /**
+ * Magic method used to call extension functions.
+ * @param string $name
+ * @param array $arguments
+ * @return mixed
+ */
+ public function __call($name, $arguments)
+ {
+ return $this->engine->getFunction($name)->call($this, $arguments);
+ }
+
+ /**
+ * Alias for render() method.
+ * @throws \Throwable
+ * @throws \Exception
+ * @return string
+ */
+ public function __toString()
+ {
+ return $this->render();
+ }
+
+ /**
+ * Assign or get template data.
+ * @param array $data
+ * @return mixed
+ */
+ public function data(array $data = null)
+ {
+ if (is_null($data)) {
+ return $this->data;
+ }
+
+ $this->data = array_merge($this->data, $data);
+ }
+
+ /**
+ * Check if the template exists.
+ * @return boolean
+ */
+ public function exists()
+ {
+ return $this->name->doesPathExist();
+ }
+
+ /**
+ * Get the template path.
+ * @return string
+ */
+ public function path()
+ {
+ return $this->name->getPath();
+ }
+
+ /**
+ * Render the template and layout.
+ * @param array $data
+ * @throws \Throwable
+ * @throws \Exception
+ * @return string
+ */
+ public function render(array $data = array())
+ {
+ $this->data($data);
+ unset($data);
+ extract($this->data);
+
+ if (!$this->exists()) {
+ throw new LogicException(
+ 'The template "' . $this->name->getName() . '" could not be found at "' . $this->path() . '".'
+ );
+ }
+
+ try {
+ $level = ob_get_level();
+ ob_start();
+
+ include $this->path();
+
+ $content = ob_get_clean();
+
+ if (isset($this->layoutName)) {
+ $layout = $this->engine->make($this->layoutName);
+ $layout->sections = array_merge($this->sections, array('content' => $content));
+ $content = $layout->render($this->layoutData);
+ }
+
+ return $content;
+ } catch (Throwable $e) {
+ while (ob_get_level() > $level) {
+ ob_end_clean();
+ }
+
+ throw $e;
+ } catch (Exception $e) {
+ while (ob_get_level() > $level) {
+ ob_end_clean();
+ }
+
+ throw $e;
+ }
+ }
+
+ /**
+ * Set the template's layout.
+ * @param string $name
+ * @param array $data
+ * @return null
+ */
+ public function layout($name, array $data = array())
+ {
+ $this->layoutName = $name;
+ $this->layoutData = $data;
+ }
+
+ /**
+ * Start a new section block.
+ * @param string $name
+ * @return null
+ */
+ public function start($name)
+ {
+ if ($name === 'content') {
+ throw new LogicException(
+ 'The section name "content" is reserved.'
+ );
+ }
+
+ if ($this->sectionName) {
+ throw new LogicException('You cannot nest sections within other sections.');
+ }
+
+ $this->sectionName = $name;
+
+ ob_start();
+ }
+
+ /**
+ * Start a new append section block.
+ * @param string $name
+ * @return null
+ */
+ public function push($name)
+ {
+ $this->appendSection = true;
+
+ $this->start($name);
+ }
+
+ /**
+ * Stop the current section block.
+ * @return null
+ */
+ public function stop()
+ {
+ if (is_null($this->sectionName)) {
+ throw new LogicException(
+ 'You must start a section before you can stop it.'
+ );
+ }
+
+ if (!isset($this->sections[$this->sectionName])) {
+ $this->sections[$this->sectionName] = '';
+ }
+
+ $this->sections[$this->sectionName] = $this->appendSection ? $this->sections[$this->sectionName] . ob_get_clean() : ob_get_clean();
+ $this->sectionName = null;
+ $this->appendSection = false;
+ }
+
+ /**
+ * Alias of stop().
+ * @return null
+ */
+ public function end()
+ {
+ $this->stop();
+ }
+
+ /**
+ * Returns the content for a section block.
+ * @param string $name Section name
+ * @param string $default Default section content
+ * @return string|null
+ */
+ public function section($name, $default = null)
+ {
+ if (!isset($this->sections[$name])) {
+ return $default;
+ }
+
+ return $this->sections[$name];
+ }
+
+ /**
+ * Fetch a rendered template.
+ * @param string $name
+ * @param array $data
+ * @return string
+ */
+ public function fetch($name, array $data = array())
+ {
+ return $this->engine->render($name, $data);
+ }
+
+ /**
+ * Output a rendered template.
+ * @param string $name
+ * @param array $data
+ * @return null
+ */
+ public function insert($name, array $data = array())
+ {
+ echo $this->engine->render($name, $data);
+ }
+
+ /**
+ * Apply multiple functions to variable.
+ * @param mixed $var
+ * @param string $functions
+ * @return mixed
+ */
+ public function batch($var, $functions)
+ {
+ foreach (explode('|', $functions) as $function) {
+ if ($this->engine->doesFunctionExist($function)) {
+ $var = call_user_func(array($this, $function), $var);
+ } elseif (is_callable($function)) {
+ $var = call_user_func($function, $var);
+ } else {
+ throw new LogicException(
+ 'The batch function could not find the "' . $function . '" function.'
+ );
+ }
+ }
+
+ return $var;
+ }
+
+ /**
+ * Escape string.
+ * @param string $string
+ * @param null|string $functions
+ * @return string
+ */
+ public function escape($string, $functions = null)
+ {
+ static $flags;
+
+ if (!isset($flags)) {
+ $flags = ENT_QUOTES | (defined('ENT_SUBSTITUTE') ? ENT_SUBSTITUTE : 0);
+ }
+
+ if ($functions) {
+ $string = $this->batch($string, $functions);
+ }
+
+ return htmlspecialchars($string, $flags, 'UTF-8');
+ }
+
+ /**
+ * Alias to escape function.
+ * @param string $string
+ * @param null|string $functions
+ * @return string
+ */
+ public function e($string, $functions = null)
+ {
+ return $this->escape($string, $functions);
+ }
+}
diff --git a/vendor/sergeytsalkov/meekrodb/.gitignore b/vendor/sergeytsalkov/meekrodb/.gitignore
new file mode 100644
index 00000000..55317fd6
--- /dev/null
+++ b/vendor/sergeytsalkov/meekrodb/.gitignore
@@ -0,0 +1 @@
+simpletest/test_setup.php
diff --git a/vendor/sergeytsalkov/meekrodb/COPYING b/vendor/sergeytsalkov/meekrodb/COPYING
new file mode 100644
index 00000000..94a9ed02
--- /dev/null
+++ b/vendor/sergeytsalkov/meekrodb/COPYING
@@ -0,0 +1,674 @@
+ GNU GENERAL PUBLIC LICENSE
+ Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc.
+ Copyright (C)
+
+ This program is free software: you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation, either version 3 of the License, or
+ (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with this program. If not, see Copyright (C)
+ This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+ This is free software, and you are welcome to redistribute it
+ under certain conditions; type `show c' for details.
+
+The hypothetical commands `show w' and `show c' should show the appropriate
+parts of the General Public License. Of course, your program's commands
+might be different; for a GUI interface, you would use an "about box".
+
+ You should also get your employer (if you work as a programmer) or school,
+if any, to sign a "copyright disclaimer" for the program, if necessary.
+For more information on this, and how to apply and follow the GNU GPL, see
+.
diff --git a/vendor/sergeytsalkov/meekrodb/COPYING.LESSER b/vendor/sergeytsalkov/meekrodb/COPYING.LESSER
new file mode 100644
index 00000000..65c5ca88
--- /dev/null
+++ b/vendor/sergeytsalkov/meekrodb/COPYING.LESSER
@@ -0,0 +1,165 @@
+ GNU LESSER GENERAL PUBLIC LICENSE
+ Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc.
\n", $out);
+ }
+
+ die;
+}
+
+function meekrodb_debugmode_handler($params) {
+ echo "QUERY: " . $params['query'] . " [" . $params['runtime'] . " ms]";
+ if (php_sapi_name() == 'cli' && empty($_SERVER['REMOTE_ADDR'])) {
+ echo "\n";
+ } else {
+ echo "
\n";
+ }
+}
+
+class MeekroDBEval {
+ public $text = '';
+
+ function __construct($text) {
+ $this->text = $text;
+ }
+}
+
+?>
diff --git a/vendor/sergeytsalkov/meekrodb/simpletest/BasicTest.php b/vendor/sergeytsalkov/meekrodb/simpletest/BasicTest.php
new file mode 100644
index 00000000..f924c90a
--- /dev/null
+++ b/vendor/sergeytsalkov/meekrodb/simpletest/BasicTest.php
@@ -0,0 +1,420 @@
+assert($mysqli->server_info === null);
+ }
+
+ function test_1_5_empty_table() {
+ $counter = DB::queryFirstField("SELECT COUNT(*) FROM accounts");
+ $this->assert($counter === strval(0));
+
+ $row = DB::queryFirstRow("SELECT * FROM accounts");
+ $this->assert($row === null);
+
+ $field = DB::queryFirstField("SELECT * FROM accounts");
+ $this->assert($field === null);
+
+ $field = DB::queryOneField('nothere', "SELECT * FROM accounts");
+ $this->assert($field === null);
+
+ $column = DB::queryFirstColumn("SELECT * FROM accounts");
+ $this->assert(is_array($column) && count($column) === 0);
+
+ $column = DB::queryOneColumn('nothere', "SELECT * FROM accounts"); //TODO: is this what we want?
+ $this->assert(is_array($column) && count($column) === 0);
+ }
+
+ function test_2_insert_row() {
+ $true = DB::insert('accounts', array(
+ 'username' => 'Abe',
+ 'password' => 'hello'
+ ));
+
+ $this->assert($true === true);
+ $this->assert(DB::affectedRows() === 1);
+
+ $counter = DB::queryFirstField("SELECT COUNT(*) FROM accounts");
+ $this->assert($counter === strval(1));
+ }
+
+ function test_3_more_inserts() {
+ DB::insert('`accounts`', array(
+ 'username' => 'Bart',
+ 'password' => 'hello',
+ 'age' => 15,
+ 'height' => 10.371
+ ));
+ $dbname = DB::$dbName;
+ DB::insert("`$dbname`.`accounts`", array(
+ 'username' => 'Charlie\'s Friend',
+ 'password' => 'goodbye',
+ 'age' => 30,
+ 'height' => 155.23,
+ 'favorite_word' => null,
+ ));
+
+ $this->assert(DB::insertId() === 3);
+ $counter = DB::queryFirstField("SELECT COUNT(*) FROM accounts");
+ $this->assert($counter === strval(3));
+
+ DB::insert('`accounts`', array(
+ 'username' => 'Deer',
+ 'password' => '',
+ 'age' => 15,
+ 'height' => 10.371
+ ));
+
+ $username = DB::queryFirstField("SELECT username FROM accounts WHERE password=%s0", null);
+ $this->assert($username === 'Deer');
+
+ $password = DB::queryFirstField("SELECT password FROM accounts WHERE favorite_word IS NULL");
+ $this->assert($password === 'goodbye');
+
+ DB::$usenull = false;
+ DB::insertUpdate('accounts', array(
+ 'id' => 3,
+ 'favorite_word' => null,
+ ));
+
+ $password = DB::queryFirstField("SELECT password FROM accounts WHERE favorite_word=%s AND favorite_word=%s", null, '');
+ $this->assert($password === 'goodbye');
+
+ DB::$usenull = true;
+ DB::insertUpdate('accounts', array(
+ 'id' => 3,
+ 'favorite_word' => null,
+ ));
+
+ DB::$param_char = '###';
+ $bart = DB::queryFirstRow("SELECT * FROM accounts WHERE age IN ###li AND height IN ###ld AND username IN ###ls",
+ array(15, 25), array(10.371, 150.123), array('Bart', 'Barts'));
+ $this->assert($bart['username'] === 'Bart');
+ DB::insert('accounts', array('username' => 'f_u'));
+ DB::query("DELETE FROM accounts WHERE username=###s", 'f_u');
+ DB::$param_char = '%';
+
+ $charlie_password = DB::queryFirstField("SELECT password FROM accounts WHERE username IN %ls AND username = %s",
+ array('Charlie', 'Charlie\'s Friend'), 'Charlie\'s Friend');
+ $this->assert($charlie_password === 'goodbye');
+
+ $charlie_password = DB::queryOneField('password', "SELECT * FROM accounts WHERE username IN %ls AND username = %s",
+ array('Charlie', 'Charlie\'s Friend'), 'Charlie\'s Friend');
+ $this->assert($charlie_password === 'goodbye');
+
+ $passwords = DB::queryFirstColumn("SELECT password FROM accounts WHERE username=%s", 'Bart');
+ $this->assert(count($passwords) === 1);
+ $this->assert($passwords[0] === 'hello');
+
+ $username = $password = $age = null;
+ list($age, $username, $password) = DB::queryOneList("SELECT age,username,password FROM accounts WHERE username=%s", 'Bart');
+ $this->assert($username === 'Bart');
+ $this->assert($password === 'hello');
+ $this->assert($age == 15);
+
+ $mysqli_result = DB::queryRaw("SELECT * FROM accounts WHERE favorite_word IS NULL");
+ $this->assert($mysqli_result instanceof MySQLi_Result);
+ $row = $mysqli_result->fetch_assoc();
+ $this->assert($row['password'] === 'goodbye');
+ $this->assert($mysqli_result->fetch_assoc() === null);
+ }
+
+ function test_4_query() {
+ DB::update('accounts', array(
+ 'birthday' => new DateTime('10 September 2000 13:13:13')
+ ), 'username=%s', 'Charlie\'s Friend');
+
+ $results = DB::query("SELECT * FROM accounts WHERE username=%s AND birthday IN %lt", 'Charlie\'s Friend', array('September 10 2000 13:13:13'));
+ $this->assert(count($results) === 1);
+ $this->assert($results[0]['age'] === '30' && $results[0]['password'] === 'goodbye');
+ $this->assert($results[0]['birthday'] == '2000-09-10 13:13:13');
+
+ $results = DB::query("SELECT * FROM accounts WHERE username!=%s", "Charlie's Friend");
+ $this->assert(count($results) === 3);
+
+ $columnlist = DB::columnList('accounts');
+ $this->assert(count($columnlist) === 8);
+ $this->assert($columnlist[0] === 'id');
+ $this->assert($columnlist[5] === 'height');
+
+ $tablelist = DB::tableList();
+ $this->assert(count($tablelist) === 2);
+ $this->assert($tablelist[0] === 'accounts');
+
+ $tablelist = null;
+ $tablelist = DB::tableList(DB::$dbName);
+ $this->assert(count($tablelist) === 2);
+ $this->assert($tablelist[0] === 'accounts');
+ }
+
+ function test_4_1_query() {
+ DB::insert('accounts', array(
+ 'username' => 'newguy',
+ 'password' => DB::sqleval("REPEAT('blah', %i)", '3'),
+ 'age' => DB::sqleval('171+1'),
+ 'height' => 111.15
+ ));
+
+ $row = DB::queryOneRow("SELECT * FROM accounts WHERE password=%s", 'blahblahblah');
+ $this->assert($row['username'] === 'newguy');
+ $this->assert($row['age'] === '172');
+
+ $true = DB::update('accounts', array(
+ 'password' => DB::sqleval("REPEAT('blah', %i)", 4),
+ 'favorite_word' => null,
+ ), 'username=%s', 'newguy');
+
+ $row = null;
+ $row = DB::queryOneRow("SELECT * FROM accounts WHERE username=%s", 'newguy');
+ $this->assert($true === true);
+ $this->assert($row['password'] === 'blahblahblahblah');
+ $this->assert($row['favorite_word'] === null);
+
+ $row = DB::query("SELECT * FROM accounts WHERE password=%s_mypass AND (password=%s_mypass) AND username=%s_myuser",
+ array('myuser' => 'newguy', 'mypass' => 'blahblahblahblah')
+ );
+ $this->assert(count($row) === 1);
+ $this->assert($row[0]['username'] === 'newguy');
+ $this->assert($row[0]['age'] === '172');
+
+ $true = DB::query("DELETE FROM accounts WHERE password=%s", 'blahblahblahblah');
+ $this->assert($true === true);
+ $this->assert(DB::affectedRows() === 1);
+ }
+
+ function test_4_2_delete() {
+ DB::insert('accounts', array(
+ 'username' => 'gonesoon',
+ 'password' => 'something',
+ 'age' => 61,
+ 'height' => 199.194
+ ));
+
+ $ct = DB::queryFirstField("SELECT COUNT(*) FROM accounts WHERE username=%s AND height=%d", 'gonesoon', 199.194);
+ $this->assert(intval($ct) === 1);
+
+ $ct = DB::queryFirstField("SELECT COUNT(*) FROM accounts WHERE username=%s1 AND height=%d0 AND height=%d", 199.194, 'gonesoon');
+ $this->assert(intval($ct) === 1);
+
+ DB::delete('accounts', 'username=%s AND age=%i AND height=%d', 'gonesoon', '61', '199.194');
+ $this->assert(DB::affectedRows() === 1);
+
+ $ct = DB::queryFirstField("SELECT COUNT(*) FROM accounts WHERE username=%s AND height=%d", 'gonesoon', '199.194');
+ $this->assert(intval($ct) === 0);
+ }
+
+ function test_4_3_insertmany() {
+ $ins[] = array(
+ 'username' => '1ofmany',
+ 'password' => 'something',
+ 'age' => 23,
+ 'height' => 190.194
+ );
+ $ins[] = array(
+ 'password' => 'somethingelse',
+ 'username' => '2ofmany',
+ 'age' => 25,
+ 'height' => 190.194
+ );
+ $ins[] = array(
+ 'password' => NULL,
+ 'username' => '3ofmany',
+ 'age' => 15,
+ 'height' => 111.951
+ );
+
+ DB::insert('accounts', $ins);
+ $this->assert(DB::affectedRows() === 3);
+
+ $rows = DB::query("SELECT * FROM accounts WHERE height=%d ORDER BY age ASC", 190.194);
+ $this->assert(count($rows) === 2);
+ $this->assert($rows[0]['username'] === '1ofmany');
+ $this->assert($rows[0]['age'] === '23');
+ $this->assert($rows[1]['age'] === '25');
+ $this->assert($rows[1]['password'] === 'somethingelse');
+ $this->assert($rows[1]['username'] === '2ofmany');
+
+ $nullrow = DB::queryOneRow("SELECT * FROM accounts WHERE username LIKE %ss", '3ofman');
+ $this->assert($nullrow['password'] === NULL);
+ $this->assert($nullrow['age'] === '15');
+ }
+
+
+
+ function test_5_insert_blobs() {
+ DB::query("CREATE TABLE `store data` (
+ `id` INT NOT NULL AUTO_INCREMENT PRIMARY KEY ,
+ `picture` BLOB
+ ) ENGINE = InnoDB");
+
+ $columns = DB::columnList('store data');
+ $this->assert(count($columns) === 2);
+ $this->assert($columns[1] === 'picture');
+
+
+ $smile = file_get_contents('smile1.jpg');
+ DB::insert('store data', array(
+ 'picture' => $smile,
+ ));
+ DB::queryOneRow("INSERT INTO %b (picture) VALUES (%s)", 'store data', $smile);
+
+ $getsmile = DB::queryFirstField("SELECT picture FROM %b WHERE id=1", 'store data');
+ $getsmile2 = DB::queryFirstField("SELECT picture FROM %b WHERE id=2", 'store data');
+ $this->assert($smile === $getsmile);
+ $this->assert($smile === $getsmile2);
+ }
+
+ function test_6_insert_ignore() {
+ DB::insertIgnore('accounts', array(
+ 'id' => 1, //duplicate primary key
+ 'username' => 'gonesoon',
+ 'password' => 'something',
+ 'age' => 61,
+ 'height' => 199.194
+ ));
+ }
+
+ function test_7_insert_update() {
+ $true = DB::insertUpdate('accounts', array(
+ 'id' => 2, //duplicate primary key
+ 'username' => 'gonesoon',
+ 'password' => 'something',
+ 'age' => 61,
+ 'height' => 199.194
+ ), 'age = age + %i', 1);
+
+ $this->assert($true === true);
+ $this->assert(DB::affectedRows() === 2); // a quirk of MySQL, even though only 1 row was updated
+
+ $result = DB::query("SELECT * FROM accounts WHERE age = %i", 16);
+ $this->assert(count($result) === 1);
+ $this->assert($result[0]['height'] === '10.371');
+
+ DB::insertUpdate('accounts', array(
+ 'id' => 2, //duplicate primary key
+ 'username' => 'blahblahdude',
+ 'age' => 233,
+ 'height' => 199.194
+ ));
+
+ $result = DB::query("SELECT * FROM accounts WHERE age = %i", 233);
+ $this->assert(count($result) === 1);
+ $this->assert($result[0]['height'] === '199.194');
+ $this->assert($result[0]['username'] === 'blahblahdude');
+
+ DB::insertUpdate('accounts', array(
+ 'id' => 2, //duplicate primary key
+ 'username' => 'gonesoon',
+ 'password' => 'something',
+ 'age' => 61,
+ 'height' => 199.194
+ ), array(
+ 'age' => 74,
+ ));
+
+ $result = DB::query("SELECT * FROM accounts WHERE age = %i", 74);
+ $this->assert(count($result) === 1);
+ $this->assert($result[0]['height'] === '199.194');
+ $this->assert($result[0]['username'] === 'blahblahdude');
+
+ $multiples[] = array(
+ 'id' => 3, //duplicate primary key
+ 'username' => 'gonesoon',
+ 'password' => 'something',
+ 'age' => 61,
+ 'height' => 199.194
+ );
+ $multiples[] = array(
+ 'id' => 1, //duplicate primary key
+ 'username' => 'gonesoon',
+ 'password' => 'something',
+ 'age' => 61,
+ 'height' => 199.194
+ );
+
+ DB::insertUpdate('accounts', $multiples, array('age' => 914));
+ $this->assert(DB::affectedRows() === 4);
+
+ $result = DB::query("SELECT * FROM accounts WHERE age=914 ORDER BY id ASC");
+ $this->assert(count($result) === 2);
+ $this->assert($result[0]['username'] === 'Abe');
+ $this->assert($result[1]['username'] === 'Charlie\'s Friend');
+
+ $true = DB::query("UPDATE accounts SET age=15, username='Bart' WHERE age=%i", 74);
+ $this->assert($true === true);
+ $this->assert(DB::affectedRows() === 1);
+ }
+
+ function test_8_lb() {
+ $data = array(
+ 'username' => 'vookoo',
+ 'password' => 'dookoo',
+ );
+
+ $true = DB::query("INSERT into accounts %lb VALUES %ls", array_keys($data), array_values($data));
+ $result = DB::query("SELECT * FROM accounts WHERE username=%s", 'vookoo');
+ $this->assert($true === true);
+ $this->assert(count($result) === 1);
+ $this->assert($result[0]['password'] === 'dookoo');
+ }
+
+ function test_9_fullcolumns() {
+ $true = DB::insert('profile', array(
+ 'id' => 1,
+ 'signature' => 'u_suck'
+ ));
+ DB::query("UPDATE accounts SET profile_id=1 WHERE id=2");
+
+ $r = DB::queryFullColumns("SELECT accounts.*, profile.*, 1+1 FROM accounts
+ INNER JOIN profile ON accounts.profile_id=profile.id");
+
+ $this->assert($true === true);
+ $this->assert(count($r) === 1);
+ $this->assert($r[0]['accounts.id'] === '2');
+ $this->assert($r[0]['profile.id'] === '1');
+ $this->assert($r[0]['profile.signature'] === 'u_suck');
+ $this->assert($r[0]['1+1'] === '2');
+ }
+
+ function test_901_updatewithspecialchar() {
+ $data = 'www.mysite.com/product?s=t-%s-%%3d%%3d%i&RCAID=24322';
+ DB::update('profile', array('signature' => $data), 'id=%i', 1);
+ $signature = DB::queryFirstField("SELECT signature FROM profile WHERE id=%i", 1);
+ $this->assert($signature === $data);
+
+ DB::update('profile',array('signature'=> "%li "),"id = %d",1);
+ $signature = DB::queryFirstField("SELECT signature FROM profile WHERE id=%i", 1);
+ $this->assert($signature === "%li ");
+
+ }
+
+
+
+}
+
+
+?>
diff --git a/vendor/sergeytsalkov/meekrodb/simpletest/CallTest.php b/vendor/sergeytsalkov/meekrodb/simpletest/CallTest.php
new file mode 100644
index 00000000..cd82e6fa
--- /dev/null
+++ b/vendor/sergeytsalkov/meekrodb/simpletest/CallTest.php
@@ -0,0 +1,17 @@
+assert($r[0]['username'] === 'Abe');
+ $this->assert($r[2]['age'] === '914');
+ }
+
+}
\ No newline at end of file
diff --git a/vendor/sergeytsalkov/meekrodb/simpletest/ErrorTest.php b/vendor/sergeytsalkov/meekrodb/simpletest/ErrorTest.php
new file mode 100644
index 00000000..b2309808
--- /dev/null
+++ b/vendor/sergeytsalkov/meekrodb/simpletest/ErrorTest.php
@@ -0,0 +1,83 @@
+assert($error_callback_worked === 1);
+
+ DB::$error_handler = array('ErrorTest', 'static_error_callback');
+ DB::query("SELET * FROM accounts");
+ $this->assert($static_error_callback_worked === 1);
+
+ DB::$error_handler = array($this, 'nonstatic_error_callback');
+ DB::query("SELET * FROM accounts");
+ $this->assert($nonstatic_error_callback_worked === 1);
+
+ }
+
+ public static function static_error_callback($params) {
+ global $static_error_callback_worked;
+ if (substr_count($params['error'], 'You have an error in your SQL syntax')) $static_error_callback_worked = 1;
+ }
+
+ public function nonstatic_error_callback($params) {
+ global $nonstatic_error_callback_worked;
+ if (substr_count($params['error'], 'You have an error in your SQL syntax')) $nonstatic_error_callback_worked = 1;
+ }
+
+ function test_2_exception_catch() {
+ $dbname = DB::$dbName;
+ DB::$error_handler = '';
+ DB::$throw_exception_on_error = true;
+ try {
+ DB::query("SELET * FROM accounts");
+ } catch(MeekroDBException $e) {
+ $this->assert(substr_count($e->getMessage(), 'You have an error in your SQL syntax'));
+ $this->assert($e->getQuery() === 'SELET * FROM accounts');
+ $exception_was_caught = 1;
+ }
+ $this->assert($exception_was_caught === 1);
+
+ try {
+ DB::insert("`$dbname`.`accounts`", array(
+ 'id' => 2,
+ 'username' => 'Another Dude\'s \'Mom"',
+ 'password' => 'asdfsdse',
+ 'age' => 35,
+ 'height' => 555.23
+ ));
+ } catch(MeekroDBException $e) {
+ $this->assert(substr_count($e->getMessage(), 'Duplicate entry'));
+ $exception_was_caught = 2;
+ }
+ $this->assert($exception_was_caught === 2);
+ }
+
+ function test_3_debugmode_handler() {
+ global $debug_callback_worked;
+
+ DB::debugMode('my_debug_handler');
+ DB::query("SELECT * FROM accounts WHERE username!=%s", "Charlie's Friend");
+
+ $this->assert($debug_callback_worked === 1);
+
+ DB::debugMode(false);
+ }
+
+}
+
+?>
diff --git a/vendor/sergeytsalkov/meekrodb/simpletest/ErrorTest_53.php b/vendor/sergeytsalkov/meekrodb/simpletest/ErrorTest_53.php
new file mode 100644
index 00000000..8aafe093
--- /dev/null
+++ b/vendor/sergeytsalkov/meekrodb/simpletest/ErrorTest_53.php
@@ -0,0 +1,19 @@
+assert($anonymous_error_callback_worked === 1);
+
+ }
+
+
+}
+
+?>
diff --git a/vendor/sergeytsalkov/meekrodb/simpletest/HelperTest.php b/vendor/sergeytsalkov/meekrodb/simpletest/HelperTest.php
new file mode 100644
index 00000000..496c4062
--- /dev/null
+++ b/vendor/sergeytsalkov/meekrodb/simpletest/HelperTest.php
@@ -0,0 +1,51 @@
+assert(count($names) === 5);
+ $this->assert($names[0] === 'Abe');
+
+ $ages = DBHelper::verticalSlice($all, 'age', 'username');
+ $this->assert(count($ages) === 5);
+ $this->assert($ages['Abe'] === '700');
+ }
+
+ function test_2_reindex() {
+ $all = DB::query("SELECT * FROM accounts ORDER BY id ASC");
+ $names = DBHelper::reIndex($all, 'username');
+ $this->assert(count($names) === 5);
+ $this->assert($names['Bart']['username'] === 'Bart');
+ $this->assert($names['Bart']['age'] === '15');
+
+ $names = DBHelper::reIndex($all, 'username', 'age');
+ $this->assert($names['Bart']['15']['username'] === 'Bart');
+ $this->assert($names['Bart']['15']['age'] === '15');
+ }
+
+ function test_3_empty() {
+ $none = DB::query("SELECT * FROM accounts WHERE username=%s", 'doesnotexist');
+ $this->assert(is_array($none) && count($none) === 0);
+ $names = DBHelper::verticalSlice($none, 'username', 'age');
+ $this->assert(is_array($names) && count($names) === 0);
+
+ $names_other = DBHelper::reIndex($none, 'username', 'age');
+ $this->assert(is_array($names_other) && count($names_other) === 0);
+ }
+
+ function test_4_null() {
+ DB::query("UPDATE accounts SET password = NULL WHERE username=%s", 'Bart');
+
+ $all = DB::query("SELECT * FROM accounts ORDER BY id ASC");
+ $ages = DBHelper::verticalSlice($all, 'age', 'password');
+ $this->assert(count($ages) === 5);
+ $this->assert($ages[''] === '15');
+
+ $passwords = DBHelper::reIndex($all, 'password');
+ $this->assert(count($passwords) === 5);
+ $this->assert($passwords['']['username'] === 'Bart');
+ $this->assert($passwords['']['password'] === NULL);
+ }
+
+}
+?>
diff --git a/vendor/sergeytsalkov/meekrodb/simpletest/ObjectTest.php b/vendor/sergeytsalkov/meekrodb/simpletest/ObjectTest.php
new file mode 100644
index 00000000..87c82bb7
--- /dev/null
+++ b/vendor/sergeytsalkov/meekrodb/simpletest/ObjectTest.php
@@ -0,0 +1,312 @@
+mdb = new MeekroDB();
+
+ foreach ($this->mdb->tableList() as $table) {
+ $this->mdb->query("DROP TABLE %b", $table);
+ }
+ }
+
+
+ function test_1_create_table() {
+ $this->mdb->query("CREATE TABLE `accounts` (
+ `id` INT NOT NULL AUTO_INCREMENT PRIMARY KEY ,
+ `username` VARCHAR( 255 ) NOT NULL ,
+ `password` VARCHAR( 255 ) NULL ,
+ `age` INT NOT NULL DEFAULT '10',
+ `height` DOUBLE NOT NULL DEFAULT '10.0',
+ `favorite_word` VARCHAR( 255 ) NULL DEFAULT 'hi'
+ ) ENGINE = InnoDB");
+ }
+
+ function test_1_5_empty_table() {
+ $counter = $this->mdb->queryFirstField("SELECT COUNT(*) FROM accounts");
+ $this->assert($counter === strval(0));
+
+ $row = $this->mdb->queryFirstRow("SELECT * FROM accounts");
+ $this->assert($row === null);
+
+ $field = $this->mdb->queryFirstField("SELECT * FROM accounts");
+ $this->assert($field === null);
+
+ $field = $this->mdb->queryOneField('nothere', "SELECT * FROM accounts");
+ $this->assert($field === null);
+
+ $column = $this->mdb->queryFirstColumn("SELECT * FROM accounts");
+ $this->assert(is_array($column) && count($column) === 0);
+
+ $column = $this->mdb->queryOneColumn('nothere', "SELECT * FROM accounts"); //TODO: is this what we want?
+ $this->assert(is_array($column) && count($column) === 0);
+ }
+
+ function test_2_insert_row() {
+ $this->mdb->insert('accounts', array(
+ 'username' => 'Abe',
+ 'password' => 'hello'
+ ));
+
+ $this->assert($this->mdb->affectedRows() === 1);
+
+ $counter = $this->mdb->queryFirstField("SELECT COUNT(*) FROM accounts");
+ $this->assert($counter === strval(1));
+ }
+
+ function test_3_more_inserts() {
+ $this->mdb->insert('`accounts`', array(
+ 'username' => 'Bart',
+ 'password' => 'hello',
+ 'age' => 15,
+ 'height' => 10.371
+ ));
+ $dbname = $this->mdb->dbName;
+ $this->mdb->insert("`$dbname`.`accounts`", array(
+ 'username' => 'Charlie\'s Friend',
+ 'password' => 'goodbye',
+ 'age' => 30,
+ 'height' => 155.23,
+ 'favorite_word' => null,
+ ));
+
+ $this->assert($this->mdb->insertId() === 3);
+
+ $counter = $this->mdb->queryFirstField("SELECT COUNT(*) FROM accounts");
+ $this->assert($counter === strval(3));
+
+ $password = $this->mdb->queryFirstField("SELECT password FROM accounts WHERE favorite_word IS NULL");
+ $this->assert($password === 'goodbye');
+
+ $this->mdb->param_char = '###';
+ $bart = $this->mdb->queryFirstRow("SELECT * FROM accounts WHERE age IN ###li AND height IN ###ld AND username IN ###ls",
+ array(15, 25), array(10.371, 150.123), array('Bart', 'Barts'));
+ $this->assert($bart['username'] === 'Bart');
+ $this->mdb->param_char = '%';
+
+ $charlie_password = $this->mdb->queryFirstField("SELECT password FROM accounts WHERE username IN %ls AND username = %s",
+ array('Charlie', 'Charlie\'s Friend'), 'Charlie\'s Friend');
+ $this->assert($charlie_password === 'goodbye');
+
+ $charlie_password = $this->mdb->queryOneField('password', "SELECT * FROM accounts WHERE username IN %ls AND username = %s",
+ array('Charlie', 'Charlie\'s Friend'), 'Charlie\'s Friend');
+ $this->assert($charlie_password === 'goodbye');
+
+ $passwords = $this->mdb->queryFirstColumn("SELECT password FROM accounts WHERE username=%s", 'Bart');
+ $this->assert(count($passwords) === 1);
+ $this->assert($passwords[0] === 'hello');
+
+ $username = $password = $age = null;
+ list($age, $username, $password) = $this->mdb->queryOneList("SELECT age,username,password FROM accounts WHERE username=%s", 'Bart');
+ $this->assert($username === 'Bart');
+ $this->assert($password === 'hello');
+ $this->assert($age == 15);
+
+ $mysqli_result = $this->mdb->queryRaw("SELECT * FROM accounts WHERE favorite_word IS NULL");
+ $this->assert($mysqli_result instanceof MySQLi_Result);
+ $row = $mysqli_result->fetch_assoc();
+ $this->assert($row['password'] === 'goodbye');
+ $this->assert($mysqli_result->fetch_assoc() === null);
+ }
+
+ function test_4_query() {
+ $results = $this->mdb->query("SELECT * FROM accounts WHERE username=%s", 'Charlie\'s Friend');
+ $this->assert(count($results) === 1);
+ $this->assert($results[0]['age'] == 30 && $results[0]['password'] == 'goodbye');
+
+ $results = $this->mdb->query("SELECT * FROM accounts WHERE username!=%s", "Charlie's Friend");
+ $this->assert(count($results) === 2);
+
+ $columnlist = $this->mdb->columnList('accounts');
+ $this->assert(count($columnlist) === 6);
+ $this->assert($columnlist[0] === 'id');
+ $this->assert($columnlist[4] === 'height');
+
+ $tablelist = $this->mdb->tableList();
+ $this->assert(count($tablelist) === 1);
+ $this->assert($tablelist[0] === 'accounts');
+
+ $tablelist = null;
+ $tablelist = $this->mdb->tableList($this->mdb->dbName);
+ $this->assert(count($tablelist) === 1);
+ $this->assert($tablelist[0] === 'accounts');
+ }
+
+ function test_4_1_query() {
+ $this->mdb->insert('accounts', array(
+ 'username' => 'newguy',
+ 'password' => $this->mdb->sqleval("REPEAT('blah', %i)", '3'),
+ 'age' => $this->mdb->sqleval('171+1'),
+ 'height' => 111.15
+ ));
+
+ $row = $this->mdb->queryOneRow("SELECT * FROM accounts WHERE password=%s", 'blahblahblah');
+ $this->assert($row['username'] === 'newguy');
+ $this->assert($row['age'] === '172');
+
+ $this->mdb->update('accounts', array(
+ 'password' => $this->mdb->sqleval("REPEAT('blah', %i)", 4),
+ 'favorite_word' => null,
+ ), 'username=%s', 'newguy');
+
+ $row = null;
+ $row = $this->mdb->queryOneRow("SELECT * FROM accounts WHERE username=%s", 'newguy');
+ $this->assert($row['password'] === 'blahblahblahblah');
+ $this->assert($row['favorite_word'] === null);
+
+ $this->mdb->query("DELETE FROM accounts WHERE password=%s", 'blahblahblahblah');
+ $this->assert($this->mdb->affectedRows() === 1);
+ }
+
+ function test_4_2_delete() {
+ $this->mdb->insert('accounts', array(
+ 'username' => 'gonesoon',
+ 'password' => 'something',
+ 'age' => 61,
+ 'height' => 199.194
+ ));
+
+ $ct = $this->mdb->queryFirstField("SELECT COUNT(*) FROM accounts WHERE username=%s AND height=%d", 'gonesoon', 199.194);
+ $this->assert(intval($ct) === 1);
+
+ $ct = $this->mdb->queryFirstField("SELECT COUNT(*) FROM accounts WHERE username=%s1 AND height=%d0 AND height=%d", 199.194, 'gonesoon');
+ $this->assert(intval($ct) === 1);
+
+ $this->mdb->delete('accounts', 'username=%s AND age=%i AND height=%d', 'gonesoon', '61', '199.194');
+ $this->assert($this->mdb->affectedRows() === 1);
+
+ $ct = $this->mdb->queryFirstField("SELECT COUNT(*) FROM accounts WHERE username=%s AND height=%d", 'gonesoon', '199.194');
+ $this->assert(intval($ct) === 0);
+ }
+
+ function test_4_3_insertmany() {
+ $ins[] = array(
+ 'username' => '1ofmany',
+ 'password' => 'something',
+ 'age' => 23,
+ 'height' => 190.194
+ );
+ $ins[] = array(
+ 'password' => 'somethingelse',
+ 'username' => '2ofmany',
+ 'age' => 25,
+ 'height' => 190.194
+ );
+
+ $this->mdb->insert('accounts', $ins);
+ $this->assert($this->mdb->affectedRows() === 2);
+
+ $rows = $this->mdb->query("SELECT * FROM accounts WHERE height=%d ORDER BY age ASC", 190.194);
+ $this->assert(count($rows) === 2);
+ $this->assert($rows[0]['username'] === '1ofmany');
+ $this->assert($rows[0]['age'] === '23');
+ $this->assert($rows[1]['age'] === '25');
+ $this->assert($rows[1]['password'] === 'somethingelse');
+ $this->assert($rows[1]['username'] === '2ofmany');
+
+ }
+
+
+
+ function test_5_insert_blobs() {
+ $this->mdb->query("CREATE TABLE `storedata` (
+ `id` INT NOT NULL AUTO_INCREMENT PRIMARY KEY ,
+ `picture` BLOB
+ ) ENGINE = InnoDB");
+
+
+ $smile = file_get_contents('smile1.jpg');
+ $this->mdb->insert('storedata', array(
+ 'picture' => $smile,
+ ));
+ $this->mdb->query("INSERT INTO storedata (picture) VALUES (%s)", $smile);
+
+ $getsmile = $this->mdb->queryFirstField("SELECT picture FROM storedata WHERE id=1");
+ $getsmile2 = $this->mdb->queryFirstField("SELECT picture FROM storedata WHERE id=2");
+ $this->assert($smile === $getsmile);
+ $this->assert($smile === $getsmile2);
+ }
+
+ function test_6_insert_ignore() {
+ $this->mdb->insertIgnore('accounts', array(
+ 'id' => 1, //duplicate primary key
+ 'username' => 'gonesoon',
+ 'password' => 'something',
+ 'age' => 61,
+ 'height' => 199.194
+ ));
+ }
+
+ function test_7_insert_update() {
+ $this->mdb->insertUpdate('accounts', array(
+ 'id' => 2, //duplicate primary key
+ 'username' => 'gonesoon',
+ 'password' => 'something',
+ 'age' => 61,
+ 'height' => 199.194
+ ), 'age = age + %i', 1);
+
+ $this->assert($this->mdb->affectedRows() === 2); // a quirk of MySQL, even though only 1 row was updated
+
+ $result = $this->mdb->query("SELECT * FROM accounts WHERE age = %i", 16);
+ $this->assert(count($result) === 1);
+ $this->assert($result[0]['height'] === '10.371');
+
+ $this->mdb->insertUpdate('accounts', array(
+ 'id' => 2, //duplicate primary key
+ 'username' => 'blahblahdude',
+ 'age' => 233,
+ 'height' => 199.194
+ ));
+
+ $result = $this->mdb->query("SELECT * FROM accounts WHERE age = %i", 233);
+ $this->assert(count($result) === 1);
+ $this->assert($result[0]['height'] === '199.194');
+ $this->assert($result[0]['username'] === 'blahblahdude');
+
+ $this->mdb->insertUpdate('accounts', array(
+ 'id' => 2, //duplicate primary key
+ 'username' => 'gonesoon',
+ 'password' => 'something',
+ 'age' => 61,
+ 'height' => 199.194
+ ), array(
+ 'age' => 74,
+ ));
+
+ $result = $this->mdb->query("SELECT * FROM accounts WHERE age = %i", 74);
+ $this->assert(count($result) === 1);
+ $this->assert($result[0]['height'] === '199.194');
+ $this->assert($result[0]['username'] === 'blahblahdude');
+
+ $multiples[] = array(
+ 'id' => 3, //duplicate primary key
+ 'username' => 'gonesoon',
+ 'password' => 'something',
+ 'age' => 61,
+ 'height' => 199.194
+ );
+ $multiples[] = array(
+ 'id' => 1, //duplicate primary key
+ 'username' => 'gonesoon',
+ 'password' => 'something',
+ 'age' => 61,
+ 'height' => 199.194
+ );
+
+ $this->mdb->insertUpdate('accounts', $multiples, array('age' => 914));
+ $this->assert($this->mdb->affectedRows() === 4);
+
+ $result = $this->mdb->query("SELECT * FROM accounts WHERE age=914 ORDER BY id ASC");
+ $this->assert(count($result) === 2);
+ $this->assert($result[0]['username'] === 'Abe');
+ $this->assert($result[1]['username'] === 'Charlie\'s Friend');
+
+ $this->mdb->query("UPDATE accounts SET age=15, username='Bart' WHERE age=%i", 74);
+ $this->assert($this->mdb->affectedRows() === 1);
+ }
+
+}
+
+
+?>
diff --git a/vendor/sergeytsalkov/meekrodb/simpletest/TransactionTest.php b/vendor/sergeytsalkov/meekrodb/simpletest/TransactionTest.php
new file mode 100644
index 00000000..76f1f231
--- /dev/null
+++ b/vendor/sergeytsalkov/meekrodb/simpletest/TransactionTest.php
@@ -0,0 +1,30 @@
+assert($depth === 1);
+
+ DB::query("UPDATE accounts SET age=%i WHERE username=%s", 700, 'Abe');
+ $depth = DB::startTransaction();
+ $this->assert($depth === 1);
+
+ DB::query("UPDATE accounts SET age=%i WHERE username=%s", 800, 'Abe');
+ $depth = DB::rollback();
+ $this->assert($depth === 0);
+
+ $age = DB::queryFirstField("SELECT age FROM accounts WHERE username=%s", 'Abe');
+ $this->assert($age == 700);
+
+ $depth = DB::rollback();
+ $this->assert($depth === 0);
+
+ $age = DB::queryFirstField("SELECT age FROM accounts WHERE username=%s", 'Abe');
+ $this->assert($age == 700);
+ }
+
+}
+?>
diff --git a/vendor/sergeytsalkov/meekrodb/simpletest/TransactionTest_55.php b/vendor/sergeytsalkov/meekrodb/simpletest/TransactionTest_55.php
new file mode 100644
index 00000000..a4090984
--- /dev/null
+++ b/vendor/sergeytsalkov/meekrodb/simpletest/TransactionTest_55.php
@@ -0,0 +1,85 @@
+assert($depth === 1);
+ DB::query("UPDATE accounts SET age=%i WHERE username=%s", 700, 'Abe');
+
+ $depth = DB::startTransaction();
+ $this->assert($depth === 2);
+ DB::query("UPDATE accounts SET age=%i WHERE username=%s", 800, 'Abe');
+
+ $depth = DB::startTransaction();
+ $this->assert($depth === 3);
+ $this->assert(DB::transactionDepth() === 3);
+ DB::query("UPDATE accounts SET age=%i WHERE username=%s", 500, 'Abe');
+ $depth = DB::commit();
+
+ $this->assert($depth === 2);
+
+ $age = DB::queryFirstField("SELECT age FROM accounts WHERE username=%s", 'Abe');
+ $this->assert($age == 500);
+
+ $depth = DB::rollback();
+ $this->assert($depth === 1);
+
+ $age = DB::queryFirstField("SELECT age FROM accounts WHERE username=%s", 'Abe');
+ $this->assert($age == 700);
+
+ $depth = DB::commit();
+ $this->assert($depth === 0);
+
+ $age = DB::queryFirstField("SELECT age FROM accounts WHERE username=%s", 'Abe');
+ $this->assert($age == 700);
+
+
+ DB::$nested_transactions = false;
+ }
+
+ function test_2_transactions() {
+ DB::$nested_transactions = true;
+
+ DB::query("UPDATE accounts SET age=%i WHERE username=%s", 600, 'Abe');
+
+ DB::startTransaction();
+ DB::query("UPDATE accounts SET age=%i WHERE username=%s", 700, 'Abe');
+ DB::startTransaction();
+ DB::query("UPDATE accounts SET age=%i WHERE username=%s", 800, 'Abe');
+ DB::rollback();
+
+ $age = DB::queryFirstField("SELECT age FROM accounts WHERE username=%s", 'Abe');
+ $this->assert($age == 700);
+
+ DB::rollback();
+
+ $age = DB::queryFirstField("SELECT age FROM accounts WHERE username=%s", 'Abe');
+ $this->assert($age == 600);
+
+ DB::$nested_transactions = false;
+ }
+
+ function test_3_transaction_rollback_all() {
+ DB::$nested_transactions = true;
+
+ DB::query("UPDATE accounts SET age=%i WHERE username=%s", 200, 'Abe');
+
+ $depth = DB::startTransaction();
+ $this->assert($depth === 1);
+ DB::query("UPDATE accounts SET age=%i WHERE username=%s", 300, 'Abe');
+ $depth = DB::startTransaction();
+ $this->assert($depth === 2);
+
+ DB::query("UPDATE accounts SET age=%i WHERE username=%s", 400, 'Abe');
+ $depth = DB::rollback(true);
+ $this->assert($depth === 0);
+
+ $age = DB::queryFirstField("SELECT age FROM accounts WHERE username=%s", 'Abe');
+ $this->assert($age == 200);
+
+ DB::$nested_transactions = false;
+ }
+
+}
+?>
diff --git a/vendor/sergeytsalkov/meekrodb/simpletest/WhereClauseTest.php b/vendor/sergeytsalkov/meekrodb/simpletest/WhereClauseTest.php
new file mode 100644
index 00000000..45843d16
--- /dev/null
+++ b/vendor/sergeytsalkov/meekrodb/simpletest/WhereClauseTest.php
@@ -0,0 +1,73 @@
+add('username=%s', 'Bart');
+ $where->add('password=%s', 'hello');
+
+ $result = DB::query("SELECT * FROM accounts WHERE %l", $where->text());
+ $this->assert(count($result) === 1);
+ $this->assert($result[0]['age'] === '15');
+ }
+
+ function test_2_simple_grouping() {
+ $where = new WhereClause('and');
+ $where->add('password=%s', 'hello');
+ $subclause = $where->addClause('or');
+ $subclause->add('age=%i', 15);
+ $subclause->add('age=%i', 14);
+
+ $result = DB::query("SELECT * FROM accounts WHERE %l", $where->text());
+ $this->assert(count($result) === 1);
+ $this->assert($result[0]['age'] === '15');
+ }
+
+ function test_3_negate_last() {
+ $where = new WhereClause('and');
+ $where->add('password=%s', 'hello');
+ $subclause = $where->addClause('or');
+ $subclause->add('username!=%s', 'Bart');
+ $subclause->negateLast();
+
+ $result = DB::query("SELECT * FROM accounts WHERE %l", $where->text());
+ $this->assert(count($result) === 1);
+ $this->assert($result[0]['age'] === '15');
+ }
+
+ function test_4_negate_last_query() {
+ $where = new WhereClause('and');
+ $where->add('password=%s', 'hello');
+ $subclause = $where->addClause('or');
+ $subclause->add('username!=%s', 'Bart');
+ $where->negateLast();
+
+ $result = DB::query("SELECT * FROM accounts WHERE %l", $where);
+ $this->assert(count($result) === 1);
+ $this->assert($result[0]['age'] === '15');
+ }
+
+ function test_5_negate() {
+ $where = new WhereClause('and');
+ $where->add('password=%s', 'hello');
+ $subclause = $where->addClause('or');
+ $subclause->add('username!=%s', 'Bart');
+ $subclause->negate();
+
+ $result = DB::query("SELECT * FROM accounts WHERE %l", $where);
+ $this->assert(count($result) === 1);
+ $this->assert($result[0]['age'] === '15');
+ }
+
+ function test_6_or() {
+ $where = new WhereClause('or');
+ $where->add('username=%s', 'Bart');
+ $where->add('username=%s', 'Abe');
+
+ $result = DB::query("SELECT * FROM accounts WHERE %l", $where);
+ $this->assert(count($result) === 2);
+ }
+
+
+}
+
+?>
diff --git a/vendor/sergeytsalkov/meekrodb/simpletest/smile1.jpg b/vendor/sergeytsalkov/meekrodb/simpletest/smile1.jpg
new file mode 100644
index 00000000..67264965
Binary files /dev/null and b/vendor/sergeytsalkov/meekrodb/simpletest/smile1.jpg differ
diff --git a/vendor/sergeytsalkov/meekrodb/simpletest/test.php b/vendor/sergeytsalkov/meekrodb/simpletest/test.php
new file mode 100644
index 00000000..654e9ae2
--- /dev/null
+++ b/vendor/sergeytsalkov/meekrodb/simpletest/test.php
@@ -0,0 +1,86 @@
+#!/usr/bin/php
+fail();
+ }
+
+ protected function fail($msg = '') {
+ echo "FAILURE! $msg\n";
+ debug_print_backtrace();
+ die;
+ }
+
+
+}
+
+function microtime_float()
+{
+ list($usec, $sec) = explode(" ", microtime());
+ return ((float)$usec + (float)$sec);
+}
+
+if (phpversion() >= '5.3') $is_php_53 = true;
+else $is_php_53 = false;
+
+ini_set('date.timezone', 'America/Los_Angeles');
+
+error_reporting(E_ALL | E_STRICT);
+require_once '../db.class.php';
+include 'test_setup.php'; //test config values go here
+DB::$user = $set_db_user;
+DB::$password = $set_password;
+DB::$dbName = $set_db;
+DB::$host = $set_host;
+DB::get(); //connect to mysql
+
+require_once 'BasicTest.php';
+require_once 'CallTest.php';
+require_once 'ObjectTest.php';
+require_once 'WhereClauseTest.php';
+require_once 'ErrorTest.php';
+require_once 'TransactionTest.php';
+require_once 'HelperTest.php';
+
+$classes_to_test = array(
+ 'BasicTest',
+ 'CallTest',
+ 'WhereClauseTest',
+ 'ObjectTest',
+ 'ErrorTest',
+ 'TransactionTest',
+ 'HelperTest',
+);
+
+if ($is_php_53) {
+ require_once 'ErrorTest_53.php';
+ $classes_to_test[] = 'ErrorTest_53';
+} else {
+ echo "PHP 5.3 not detected, skipping 5.3 tests..\n";
+}
+
+$mysql_version = DB::serverVersion();
+if ($mysql_version >= '5.5') {
+ require_once 'TransactionTest_55.php';
+ $classes_to_test[] = 'TransactionTest_55';
+} else {
+ echo "MySQL 5.5 not available (version is $mysql_version) -- skipping MySQL 5.5 tests\n";
+}
+
+$time_start = microtime_float();
+foreach ($classes_to_test as $class) {
+ $object = new $class();
+
+ foreach (get_class_methods($object) as $method) {
+ if (substr($method, 0, 4) != 'test') continue;
+ echo "Running $class::$method..\n";
+ $object->$method();
+ }
+}
+$time_end = microtime_float();
+$time = round($time_end - $time_start, 2);
+
+echo "Completed in $time seconds\n";
+
+
+?>
+