Shell e meio ambiente

Comando source

Executar arquivo na sessão shell atual

Linux · Exemplos de Bash · comandos executados no servidor selecionado

Quando usar source

Use source apenas com código shell confiável. Ele executa o arquivo no shell atual e pode alterar variáveis, funções, diretório de trabalho e outros estados; não é um analisador de arquivos de dados inofensivo.

Sintaxe

source FILE [ARGUMENTS...]

Colchetes marcam argumentos opcionais; uma reticência significa repetição. Substitua exemplos de nomes de arquivos, nomes de usuários e endereços de servidores por seus próprios valores.

Opções e argumentos comuns

FILE
Caminho para o script em execução no shell atual.
. FILE
Sintaxe compatível com POSIX para obter um arquivo.

Exemplos de uso

Obtenha um arquivo de configurações confiável

source ./project.env

O script de ambiente é executado no shell atual, com todas as ações permitidas para essa conta.

Use a sintaxe POSIX

. ./project.env

O comando dot executa a operação de sourcing do shell usando o arquivo selecionado.

Verifique a sintaxe antes de adquirir

bash -n ./project.env

Bash verifica a sintaxe sem executar o script; a sintaxe bem-sucedida não prova que é segura.

Notas e limitações

  • source executa comandos; ele não apenas lê pares de valores-chave. Somente arquivos confiáveis ​​do source.
  • As alterações de variáveis, diretórios e funções permanecem no shell atual. Nem todo /bin/sh suporta source.

Perguntas comuns e solução de problemas

É seguro source um arquivo de ambiente baixado?

Somente se você confiar e tiver revisado. O código Shell pode executar comandos arbitrários mesmo quando o nome do arquivo sugere que ele contém apenas configurações.

Por que as variáveis não ficam disponíveis para programas infantis posteriormente?

O Sourcing atribui variáveis, mas não exporta automaticamente todas as atribuições. Exporte apenas os valores que os processos filhos realmente precisam.

Mais ajuda

As opções variam de acordo com a versão e distribuição. Verifique a documentação instalada com este comando: help source.