Uso da função getenv () em PHP

Variáveis ​​de ambiente são usadas em PHP para configurar o aplicativo e recuperar os diferentes tipos de dados dinamicamente do servidor. As credenciais do banco de dados, chaves de API, etc., são visíveis para o código por meio da variável de ambiente em vez de usar qualquer arquivo de configuração. Quando qualquer script PHP é executado, ele herda todas as variáveis ​​de ambiente necessárias do servidor. Existem duas maneiras de ler variáveis ​​de ambiente em PHP. Um é getenv () função e outra é $ _ENV variedade. Os usos da função getenv () são mostrados neste tutorial.

Sintaxe:

A função getenv () pode ser usada com ou sem um argumento. Quando esta função usa os argumentos, ela retorna o valor da string, e quando a função não usa nenhum argumento, ela retorna uma matriz. Ambas as sintaxes desta função são mostradas abaixo:

string getenv (string $ varname [, bool $ local_only = false])

De acordo com a sintaxe acima, a função getenv () pode receber dois argumentos. O primeiro argumento é obrigatório e é usado para pegar o nome da variável de ambiente que é necessária para ler. O segundo argumento é opcional com um valor padrão de FALSE. Quando TRUE é usado no segundo argumento, esta função retornará apenas as variáveis ​​de ambiente local.

array getenv ()

De acordo com a sintaxe acima, a função getenv () pode ser chamada sem nenhum argumento.

Exemplo 1: Uso da variável getenv () sem argumento

O exemplo a seguir mostrará a lista de variáveis ​​de ambiente da versão instalada do PHP. Crie um arquivo PHP com o seguinte script para obter a lista de variáveis ​​de ambiente usando a função getenv ().

A função getenv () é chamada sem nenhum argumento no script, e os valores retornados são armazenados em uma matriz chamada $ env_array. Os valores desta matriz são impressos usando o foreach ciclo.

// Chama a função getenv () sem argumento
$ env_array = getenv ();
echo "

A lista de variáveis ​​de ambiente com valores são:

";
// Imprime todos os nomes de variáveis ​​de ambiente com valores
foreach ($ env_array as $ key => $ value)

echo "$ key => $ value
";

?>

Resultado:

A seguinte saída aparecerá após a execução do script do servidor. Mostra a lista de todas as variáveis ​​de ambiente do PHP. Esta saída pode variar com base na versão do PHP e no sistema operacional, em que o PHP está sendo executado.

Exemplo 2: leia as variáveis ​​de ambiente específicas

O exemplo a seguir mostra a maneira de ler os valores de ambiente específicos. Crie um arquivo PHP com o seguinte script.

As quatro variáveis ​​de ambiente são impressas usando a função getenv (). "LÍNGUA" é usado na função getenv () para ler qual linguagem está atualmente configurada para o script PHP. “LC_TIME” é usado na função getenv () para ler o nome de formatação de data e hora usado em PHP. “APACHE_LOG_DIR” é usado na função getenv () para ler o diretório de log do Apache. "CAMINHO" é usado na função getenv () para ler os valores armazenados no caminho.

// Imprime o nome do idioma usado
echo " Língua: " . getenv ("LANGUAGE"). "
";
// Imprime o nome de formatação de data e hora usado
echo " Horário local: " . getenv ("LC_TIME"). "
";
// Imprime o nome do diretório de log do servidor apache
echo " Apache Log Directory: " . getenv ("APACHE_LOG_DIR"). "
";
// Imprime os valores da variável PATH
echo " Os valores de PATH são: " . getenv ("PATH");
?>

Resultado:

A seguinte saída aparecerá após a execução do script do servidor. Mostra os valores das quatro variáveis ​​de ambiente.

Exemplo 3: Definir e ler a variável de ambiente

A função getenv () retorna a lista de variáveis ​​de ambiente integradas do PHP. Mas se o codificador precisar criar qualquer nova variável de ambiente para o propósito de programação, ele pode fazer isso. A função putenv () pode ser usada para criar uma nova variável de ambiente com um valor. Para criar uma nova variável de ambiente, o nome da variável, o sinal de igual (=) e o valor da variável são colocados entre as aspas a serem usadas como o valor do argumento da função putenv (). Mas o valor de qualquer variável de ambiente embutida não pode ser alterado usando a função putenv ().

O exemplo a seguir mostra a maneira de criar uma nova variável de ambiente usando a função putenv () e lê a variável de ambiente recém-criada usando a função getenv (). Crie um arquivo PHP com o seguinte script.

“REMOTE_ADDR” é um nome de variável de ambiente embutido com um valor que é impresso no início do script. Em seguida, um novo valor é definido para esta variável e impresso novamente. Uma nova variável de ambiente chamada “MY_ENV_VAR” é criada com um valor e impressa posteriormente.

// Imprime o valor atual de REMOTE_ADDR
echo " O endereço remoto atual é: " . getenv ("REMOTE_ADDR"). "
";
// Tente alterar a variável REMOTE_ADDR integrada
putenv ("REMOTE_ADDR = servidor local");
// Imprime o valor de REMOTE_ADDR após usar putenv ()
echo " O endereço remoto após a mudança é: " . getenv ("REMOTE_ADDR"). "
";
// Defina uma variável de ambiente personalizada
putenv ("MY_ENV_VAR = TestSrver");
// Imprime a variável de ambiente personalizada
echo "O valor de MY_ENV_VAR é: " . getenv ("MY_ENV_VAR");
?>

Resultado:

A seguinte saída aparecerá após a execução do script do servidor. Mostra que o valor padrão de “REMOTE_ADDR” é 127.0.0.1. Quando o valor desta variável de ambiente é alterado e reimpresso, ela mostrará seu valor anterior. Isso significa que o valor das variáveis ​​integradas não pode ser alterado. A variável de ambiente recém-criada é impressa corretamente aqui.

Conclusão

As maneiras de ler variáveis ​​de ambiente integradas e criar uma nova variável de ambiente são mostradas neste tutorial usando diferentes exemplos. Existe uma variável superglobal chamada $ _ENV que também pode ser usada para ler a variável de ambiente do PHP. O conceito de variáveis ​​de ambiente em PHP será esclarecido após a leitura deste tutorial, e os codificadores de PHP serão capazes de usar essas variáveis ​​em seus scripts.