File ManagerCurrent Directory: wp-content/plugins/google-site-kit/third-party/phpseclib/phpseclib/phpseclib/Common/FunctionsLinux appserver-0d5e4f1e-php-cc8da225320a42ba9b7d66cba40b1f03 6.6.123+ #1 SMP PREEMPT_DYNAMIC Wed Mar 11 09:04:28 UTC 2026 x86_64Edit File: Strings.php <?php /** * Common String Functions * * PHP version 5 * * @author Jim Wigginton <terrafrost@php.net> * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace Google\Site_Kit_Dependencies\phpseclib3\Common\Functions; use Google\Site_Kit_Dependencies\ParagonIE\ConstantTime\Base64; use Google\Site_Kit_Dependencies\ParagonIE\ConstantTime\Base64UrlSafe; use Google\Site_Kit_Dependencies\ParagonIE\ConstantTime\Hex; use Google\Site_Kit_Dependencies\phpseclib3\Math\BigInteger; use Google\Site_Kit_Dependencies\phpseclib3\Math\Common\FiniteField; /** * Common String Functions * * @author Jim Wigginton <terrafrost@php.net> */ abstract class Strings { /** * String Shift * * Inspired by array_shift * * @param string $string * @param int $index * @return string */ public static function shift(&$string, $index = 1) { $substr = \substr($string, 0, $index); $string = \substr($string, $index); return $substr; } /** * String Pop * * Inspired by array_pop * * @param string $string * @param int $index * @return string */ public static function pop(&$string, $index = 1) { $substr = \substr($string, -$index); $string = \substr($string, 0, -$index); return $substr; } /** * Parse SSH2-style string * * Returns either an array or a boolean if $data is malformed. * * Valid characters for $format are as follows: * * C = byte * b = boolean (true/false) * N = uint32 * Q = uint64 * s = string * i = mpint * L = name-list * * uint64 is not supported. * * @param string $format * @param string $data * @return mixed */ public static function unpackSSH2($format, &$data) { $format = self::formatPack($format); $result = []; for ($i = 0; $i < \strlen($format); $i++) { switch ($format[$i]) { case 'C': case 'b': if (!\strlen($data)) { throw new \LengthException('At least one byte needs to be present for successful C / b decodes'); } break; case 'N': case 'i': case 's': case 'L': if (\strlen($data) < 4) { throw new \LengthException('At least four byte needs to be present for successful N / i / s / L decodes'); } break; case 'Q': if (\strlen($data) < 8) { throw new \LengthException('At least eight byte needs to be present for successful N / i / s / L decodes'); } break; default: throw new \InvalidArgumentException('$format contains an invalid character'); } switch ($format[$i]) { case 'C': $result[] = \ord(self::shift($data)); continue 2; case 'b': $result[] = \ord(self::shift($data)) != 0; continue 2; case 'N': list(, $temp) = \unpack('N', self::shift($data, 4)); $result[] = $temp; continue 2; case 'Q': // pack() added support for Q in PHP 5.6.3 and PHP 5.6 is phpseclib 3's minimum version // so in theory we could support this BUT, "64-bit format codes are not available for // 32-bit versions" and phpseclib works on 32-bit installs. on 32-bit installs // 64-bit floats can be used to get larger numbers then 32-bit signed ints would allow // for. sure, you're not gonna get the full precision of 64-bit numbers but just because // you need > 32-bit precision doesn't mean you need the full 64-bit precision \extract(\unpack('Nupper/Nlower', self::shift($data, 8))); $temp = $upper ? 4294967296 * $upper : 0; $temp += $lower < 0 ? ($lower & 0x7ffffffff) + 0x80000000 : $lower; // $temp = hexdec(bin2hex(self::shift($data, 8))); $result[] = $temp; continue 2; } list(, $length) = \unpack('N', self::shift($data, 4)); if (\strlen($data) < $length) { throw new \LengthException("{$length} bytes needed; " . \strlen($data) . ' bytes available'); } $temp = self::shift($data, $length); switch ($format[$i]) { case 'i': $result[] = new \Google\Site_Kit_Dependencies\phpseclib3\Math\BigInteger($temp, -256); break; case 's': $result[] = $temp; break; case 'L': $result[] = \explode(',', $temp); } } return $result; } /** * Create SSH2-style string * * @param string $format * @param string|int|float|array|bool ...$elements * @return string */ public static function packSSH2($format, ...$elements) { $format = self::formatPack($format); if (\strlen($format) != \count($elements)) { throw new \InvalidArgumentException('There must be as many arguments as there are characters in the $format string'); } $result = ''; for ($i = 0; $i < \strlen($format); $i++) { $element = $elements[$i]; switch ($format[$i]) { case 'C': if (!\is_int($element)) { throw new \InvalidArgumentException('Bytes must be represented as an integer between 0 and 255, inclusive.'); } $result .= \pack('C', $element); break; case 'b': if (!\is_bool($element)) { throw new \InvalidArgumentException('A boolean parameter was expected.'); } $result .= $element ? "\x01" : "\x00"; break; case 'Q': if (!\is_int($element) && !\is_float($element)) { throw new \InvalidArgumentException('An integer was expected.'); } // 4294967296 == 1 << 32 $result .= \pack('NN', $element / 4294967296, $element); break; case 'N': if (\is_float($element)) { $element = (int) $element; } if (!\is_int($element)) { throw new \InvalidArgumentException('An integer was expected.'); } $result .= \pack('N', $element); break; case 's': if (!self::is_stringable($element)) { throw new \InvalidArgumentException('A string was expected.'); } $result .= \pack('Na*', \strlen($element), $element); break; case 'i': if (!$element instanceof \Google\Site_Kit_Dependencies\phpseclib3\Math\BigInteger && !$element instanceof \Google\Site_Kit_Dependencies\phpseclib3\Math\Common\FiniteField\Integer) { throw new \InvalidArgumentException('A phpseclib3\\Math\\BigInteger or phpseclib3\\Math\\Common\\FiniteField\\Integer object was expected.'); } $element = $element->toBytes(\true); $result .= \pack('Na*', \strlen($element), $element); break; case 'L': if (!\is_array($element)) { throw new \InvalidArgumentException('An array was expected.'); } $element = \implode(',', $element); $result .= \pack('Na*', \strlen($element), $element); break; default: throw new \InvalidArgumentException('$format contains an invalid character'); } } return $result; } /** * Expand a pack string * * Converts C5 to CCCCC, for example. * * @param string $format * @return string */ private static function formatPack($format) { $parts = \preg_split('#(\\d+)#', $format, -1, \PREG_SPLIT_DELIM_CAPTURE); $format = ''; for ($i = 1; $i < \count($parts); $i += 2) { $format .= \substr($parts[$i - 1], 0, -1) . \str_repeat(\substr($parts[$i - 1], -1), $parts[$i]); } $format .= $parts[$i - 1]; return $format; } /** * Convert binary data into bits * * bin2hex / hex2bin refer to base-256 encoded data as binary, whilst * decbin / bindec refer to base-2 encoded data as binary. For the purposes * of this function, bin refers to base-256 encoded data whilst bits refers * to base-2 encoded data * * @param string $x * @return string */ public static function bits2bin($x) { /* // the pure-PHP approach is faster than the GMP approach if (function_exists('gmp_export')) { return strlen($x) ? gmp_export(gmp_init($x, 2)) : gmp_init(0); } */ if (\preg_match('#[^01]#', $x)) { throw new \RuntimeException('The only valid characters are 0 and 1'); } if (!\defined('PHP_INT_MIN')) { \define('PHP_INT_MIN', ~\PHP_INT_MAX); } $length = \strlen($x); if (!$length) { return ''; } $block_size = \PHP_INT_SIZE << 3; $pad = $block_size - $length % $block_size; if ($pad != $block_size) { $x = \str_repeat('0', $pad) . $x; } $parts = \str_split($x, $block_size); $str = ''; foreach ($parts as $part) { $xor = $part[0] == '1' ? \PHP_INT_MIN : 0; $part[0] = '0'; $str .= \pack(\PHP_INT_SIZE == 4 ? 'N' : 'J', $xor ^ eval('return 0b' . $part . ';')); } return \ltrim($str, "\x00"); } /** * Convert bits to binary data * * @param string $x * @return string */ public static function bin2bits($x, $trim = \true) { /* // the pure-PHP approach is slower than the GMP approach BUT // i want to the pure-PHP version to be easily unit tested as well if (function_exists('gmp_import')) { return gmp_strval(gmp_import($x), 2); } */ $len = \strlen($x); $mod = $len % \PHP_INT_SIZE; if ($mod) { $x = \str_pad($x, $len + \PHP_INT_SIZE - $mod, "\x00", \STR_PAD_LEFT); } $bits = ''; if (\PHP_INT_SIZE == 4) { $digits = \unpack('N*', $x); foreach ($digits as $digit) { $bits .= \sprintf('%032b', $digit); } } else { $digits = \unpack('J*', $x); foreach ($digits as $digit) { $bits .= \sprintf('%064b', $digit); } } return $trim ? \ltrim($bits, '0') : $bits; } /** * Switch Endianness Bit Order * * @param string $x * @return string */ public static function switchEndianness($x) { $r = ''; for ($i = \strlen($x) - 1; $i >= 0; $i--) { $b = \ord($x[$i]); if (\PHP_INT_SIZE === 8) { // 3 operations // from http://graphics.stanford.edu/~seander/bithacks.html#ReverseByteWith64BitsDiv $r .= \chr(($b * 0x202020202 & 0x10884422010) % 1023); } else { // 7 operations // from http://graphics.stanford.edu/~seander/bithacks.html#ReverseByteWith32Bits $p1 = $b * 0x802 & 0x22110; $p2 = $b * 0x8020 & 0x88440; $r .= \chr(($p1 | $p2) * 0x10101 >> 16); } } return $r; } /** * Increment the current string * * @param string $var * @return string */ public static function increment_str(&$var) { if (\function_exists('sodium_increment')) { $var = \strrev($var); \sodium_increment($var); $var = \strrev($var); return $var; } for ($i = 4; $i <= \strlen($var); $i += 4) { $temp = \substr($var, -$i, 4); switch ($temp) { case "\xff\xff\xff\xff": $var = \substr_replace($var, "\x00\x00\x00\x00", -$i, 4); break; case "\xff\xff\xff": $var = \substr_replace($var, "\x80\x00\x00\x00", -$i, 4); return $var; default: $temp = \unpack('Nnum', $temp); $var = \substr_replace($var, \pack('N', $temp['num'] + 1), -$i, 4); return $var; } } $remainder = \strlen($var) % 4; if ($remainder == 0) { return $var; } $temp = \unpack('Nnum', \str_pad(\substr($var, 0, $remainder), 4, "\x00", \STR_PAD_LEFT)); $temp = \substr(\pack('N', $temp['num'] + 1), -$remainder); $var = \substr_replace($var, $temp, 0, $remainder); return $var; } /** * Find whether the type of a variable is string (or could be converted to one) * * @param mixed $var * @return bool * @psalm-assert-if-true string|\Stringable $var */ public static function is_stringable($var) { return \is_string($var) || \is_object($var) && \method_exists($var, '__toString'); } /** * Constant Time Base64-decoding * * ParagoneIE\ConstantTime doesn't use libsodium if it's available so we'll do so * ourselves. see https://github.com/paragonie/constant_time_encoding/issues/39 * * @param string $data * @return string */ public static function base64_decode($data) { return \function_exists('sodium_base642bin') ? \sodium_base642bin($data, \SODIUM_BASE64_VARIANT_ORIGINAL_NO_PADDING, '=') : \Google\Site_Kit_Dependencies\ParagonIE\ConstantTime\Base64::decode($data); } /** * Constant Time Base64-decoding (URL safe) * * @param string $data * @return string */ public static function base64url_decode($data) { // return self::base64_decode(str_replace(['-', '_'], ['+', '/'], $data)); return \function_exists('sodium_base642bin') ? \sodium_base642bin($data, \SODIUM_BASE64_VARIANT_URLSAFE_NO_PADDING, '=') : \Google\Site_Kit_Dependencies\ParagonIE\ConstantTime\Base64UrlSafe::decode($data); } /** * Constant Time Base64-encoding * * @param string $data * @return string */ public static function base64_encode($data) { return \function_exists('sodium_bin2base64') ? \sodium_bin2base64($data, \SODIUM_BASE64_VARIANT_ORIGINAL) : \Google\Site_Kit_Dependencies\ParagonIE\ConstantTime\Base64::encode($data); } /** * Constant Time Base64-encoding (URL safe) * * @param string $data * @return string */ public static function base64url_encode($data) { // return str_replace(['+', '/'], ['-', '_'], self::base64_encode($data)); return \function_exists('sodium_bin2base64') ? \sodium_bin2base64($data, \SODIUM_BASE64_VARIANT_URLSAFE_NO_PADDING) : \Google\Site_Kit_Dependencies\ParagonIE\ConstantTime\Base64UrlSafe::encode($data); } /** * Constant Time Hex Decoder * * @param string $data * @return string */ public static function hex2bin($data) { return \function_exists('sodium_hex2bin') ? \sodium_hex2bin($data) : \Google\Site_Kit_Dependencies\ParagonIE\ConstantTime\Hex::decode($data); } /** * Constant Time Hex Encoder * * @param string $data * @return string */ public static function bin2hex($data) { return \function_exists('sodium_bin2hex') ? \sodium_bin2hex($data) : \Google\Site_Kit_Dependencies\ParagonIE\ConstantTime\Hex::encode($data); } } Upload File Directory Listing NameTypeSizeActions.. (Parent Directory)DirStrings.phpFile16.35 KB Rename | Delete | Edit