Shell e ambiente

Comando source

Executar ficheiro na sessão shell atual

Linux · Exemplos de Bash · comandos executados no servidor seleccionado

Quando utilizar source

Utilize source apenas com código shell fidedigno. Executa o ficheiro na shell atual e pode alterar variáveis, funções, diretório de trabalho e outros estados; não é um analisador de ficheiros de dados inofensivo.

Sintaxe

source FILE [ARGUMENTS...]

Os colchetes marcam argumentos opcionais; uma reticência significa repetição. Substitua exemplos de nomes de ficheiros, nomes de utilizadores e endereços de servidores pelos seus próprios valores.

Opções e argumentos comuns

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

Exemplos de uso

Obtenha um ficheiro de configurações fiável

source ./project.env

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

Utilize a sintaxe POSIX

. ./project.env

O comando dot executa a operação de sourcing do shell utilizando o ficheiro selecionado.

Verifique a sintaxe antes de adquirir

bash -n ./project.env

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

Notas e limitações

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

Perguntas comuns e resolução de problemas

É seguro source um ficheiro de ambiente descarregado?

Só se confiar e tiver revisto. O código Shell pode executar comandos arbitrários mesmo quando o nome do ficheiro sugere que contém apenas definições.

Porque é 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 necessitam.

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.