loader = $loader; } /** * Create a new dotenv instance. * * @param string|string[] $paths * @param string|null $file * @param \Dotenv\Environment\FactoryInterface|null $envFactory * * @return \Dotenv\Dotenv */ public static function create($paths, $file = null, FactoryInterface $envFactory = null) { $loader = new Loader(self::getFilePaths((array) $paths, $file ?: '.env'), $envFactory ?: new DotenvFactory(), \true); return new self($loader); } /** * Returns the full paths to the files. * * @param string[] $paths * @param string $file * * @return string[] */ private static function getFilePaths(array $paths, $file) { return \array_map(function ($path) use($file) { return \rtrim($path, \DIRECTORY_SEPARATOR) . \DIRECTORY_SEPARATOR . $file; }, $paths); } /** * Load environment file in given directory. * * @throws \Dotenv\Exception\InvalidPathException|\Dotenv\Exception\InvalidFileException * * @return array */ public function load() { return $this->loadData(); } /** * Load environment file in given directory, silently failing if it doesn't exist. * * @throws \Dotenv\Exception\InvalidFileException * * @return array */ public function safeLoad() { try { return $this->loadData(); } catch (InvalidPathException $e) { // suppressing exception return []; } } /** * Load environment file in given directory. * * @throws \Dotenv\Exception\InvalidPathException|\Dotenv\Exception\InvalidFileException * * @return array */ public function overload() { return $this->loadData(\true); } /** * Actually load the data. * * @param bool $overload * * @throws \Dotenv\Exception\InvalidPathException|\Dotenv\Exception\InvalidFileException * * @return array */ protected function loadData($overload = \false) { return $this->loader->setImmutable(!$overload)->load(); } /** * Required ensures that the specified variables exist, and returns a new validator object. * * @param string|string[] $variables * * @return \Dotenv\Validator */ public function required($variables) { return new Validator((array) $variables, $this->loader); } /** * Returns a new validator object that won't check if the specified variables exist. * * @param string|string[] $variables * * @return \Dotenv\Validator */ public function ifPresent($variables) { return new Validator((array) $variables, $this->loader, \false); } /** * Get the list of environment variables declared inside the 'env' file. * * @return string[] */ public function getEnvironmentVariableNames() { return $this->loader->getEnvironmentVariableNames(); } }