diff options
Diffstat (limited to 'vendor/mtdowling/jmespath.php/src/Env.php')
-rw-r--r-- | vendor/mtdowling/jmespath.php/src/Env.php | 91 |
1 files changed, 91 insertions, 0 deletions
diff --git a/vendor/mtdowling/jmespath.php/src/Env.php b/vendor/mtdowling/jmespath.php/src/Env.php new file mode 100644 index 0000000..b22cf25 --- /dev/null +++ b/vendor/mtdowling/jmespath.php/src/Env.php @@ -0,0 +1,91 @@ +<?php +namespace JmesPath; + +/** + * Provides a simple environment based search. + * + * The runtime utilized by the Env class can be customized via environment + * variables. If the JP_PHP_COMPILE environment variable is specified, then the + * CompilerRuntime will be utilized. If set to "on", JMESPath expressions will + * be cached to the system's temp directory. Set the environment variable to + * a string to cache expressions to a specific directory. + */ +final class Env +{ + const COMPILE_DIR = 'JP_PHP_COMPILE'; + + /** + * Returns data from the input array that matches a JMESPath expression. + * + * @param string $expression JMESPath expression to evaluate + * @param mixed $data JSON-like data to search + * + * @return mixed Returns the matching data or null + */ + public static function search($expression, $data) + { + static $runtime; + + if (!$runtime) { + $runtime = Env::createRuntime(); + } + + return $runtime($expression, $data); + } + + /** + * Creates a JMESPath runtime based on environment variables and extensions + * available on a system. + * + * @return callable + */ + public static function createRuntime() + { + switch ($compileDir = self::getEnvVariable(self::COMPILE_DIR)) { + case false: return new AstRuntime(); + case 'on': return new CompilerRuntime(); + default: return new CompilerRuntime($compileDir); + } + } + + /** + * Delete all previously compiled JMESPath files from the JP_COMPILE_DIR + * directory or sys_get_temp_dir(). + * + * @return int Returns the number of deleted files. + */ + public static function cleanCompileDir() + { + $total = 0; + $compileDir = self::getEnvVariable(self::COMPILE_DIR) ?: sys_get_temp_dir(); + + foreach (glob("{$compileDir}/jmespath_*.php") as $file) { + $total++; + unlink($file); + } + + return $total; + } + + /** + * Reads an environment variable from $_SERVER, $_ENV or via getenv(). + * + * @param string $name + * + * @return string|null + */ + private static function getEnvVariable($name) + { + if (array_key_exists($name, $_SERVER)) { + return $_SERVER[$name]; + } + + if (array_key_exists($name, $_ENV)) { + return $_ENV[$name]; + } + + $value = getenv($name); + + return $value === false ? null : $value; + } +} |