1	<?php
2
3	declare(strict_types=1);
4
5	/**
6	* Fast Forward Development Tools for PHP projects.
7	*
8	* This file is part of fast-forward/dev-tools project.
9	*
10	* @author   Felipe Sayão Lobato Abreu <github@mentordosnerds.com>
11	* @license  https://opensource.org/licenses/MIT MIT License
12	*
13	* @see      https://github.com/php-fast-forward/
14	* @see      https://github.com/php-fast-forward/dev-tools
15	* @see      https://github.com/php-fast-forward/dev-tools/issues
16	* @see      https://php-fast-forward.github.io/dev-tools/
17	* @see      https://datatracker.ietf.org/doc/html/rfc2119
18	*/
19
20	namespace FastForward\DevTools\Environment;
21
22	/**
23	* Reads process environment variables without binding callers to Composer APIs.
24	*/
25	interface EnvironmentInterface
26	{
27	/**
28	* Reads an environment variable or, when no name is provided, the current environment map.
29	*
30	* @param string|null $name the environment variable name, or null to read the current environment map
31	* @param string|null $default the value returned when the named variable is not defined
32	*
33	* @return array<string, string>|string|null the environment map, variable value, or default fallback
34	*/
35	public function get(?string $name = null, ?string $default = null): array|string|null;
36	}