C/C++ 프로그래밍에서는 __FUNCTION__ 매크로를 사용하여 현재 실행 중인 함수의 이름을 확인하고 로그로 남기는 일이 흔합니다. Bash 쉘 스크립트에서도 이와 유사한 기능을 제공하는 FUNCNAME이라는 환경 변수가 존재합니다. 하지만 FUNCNAME은 단순한 문자열이 아니라 함수 호출 스택을 관리하는 배열 형태라는 차이점이 있습니다.
다음은 FUNCNAME 배열이 어떻게 스택 구조로 동작하는지 보여주는 예제입니다.
#!/bin/bash
function outer_step() {
echo "--- outer_step 시작 ---"
echo "현재 함수명: ${FUNCNAME[0]}"
echo "호출 스택: (${FUNCNAME[@]})"
inner_step
echo "--- outer_step 종료 ---"
}
function inner_step() {
echo "현재 함수명: ${FUNCNAME[0]}"
echo "전체 스택 상태: (${FUNCNAME[@]})"
}
echo "스크립트 실행 직후 스택: (${FUNCNAME[@]})"
outer_step
echo "스크립트 종료 전 스택: (${FUNCNAME[@]})"
위 스크립트를 실행하면 FUNCNAME의 첫 번째 요소(인덱스 0)가 항상 현재 실행 중인 함수를 가리키며, 뒤따르는 요소들은 해당 함수를 호출한 상위 함수들의 이름을 순서대로 담고 있음을 알 수 있습니다. 함수 외부에서 호출될 경우 배열은 비어 있거나 호출 문맥에 따른 정보를 보여줍니다.
FUNCNAME과 함께 가장 자주 사용되는 또 다른 유용한 배열 변수는 BASH_SOURCE입니다. 이 변수는 실행 중인 스크립트 파일의 경로 정보를 담고 있습니다. 특히 source(또는 .) 명령어를 통해 스크립트를 불러올 때 매우 유용합니다. 일반적인 $0 변수는 쉘 자체나 부모 스크립트의 이름을 가리키는 경우가 많지만, BASH_SOURCE[0]은 항상 현재 코드가 작성된 물리적인 파일 경로를 보장하기 때문입니다.
스크립트가 직접 실행되었는지, 아니면 source 명령어로 로드되었는지 판별할 때 다음과 같이 활용할 수 있습니다.
if [[ "${BASH_SOURCE[0]}" != "${0}" ]]; then
echo "이 파일은 외부 스크립트에서 로드(source)되었습니다."
# 라이브러리 초기화 로직
else
echo "이 파일은 독립적으로 실행되었습니다."
# 메인 실행 로직
fi
가장 실무적인 활용 사례 중 하나는 스크립트 파일이 위치한 절대 경로를 알아내는 것입니다. 스크립트 내부에서 다른 설정 파일이나 리소스를 참조할 때, 실행 위치에 상관없이 정확한 경로를 찾기 위해 다음과 같은 패턴을 자주 사용합니다.
# 스크립트 파일이 위치한 디렉토리의 절대 경로 구하기
BASE_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
PROJECT_ROOT="$( cd "$( dirname "${BASH_SOURCE[0]}" )/.." && pwd )"
echo "현재 디렉토리: $BASE_DIR"
echo "상위 프로젝트 루트: $PROJECT_ROOT"
이 기법은 dirname으로 파일의 상대 경로를 추출한 뒤, cd와 pwd를 조합하여 시스템 상의 실제 절대 경로를 반환합니다. 쉘 환경에 따라 ${BASH_SOURCE[0]} 대신 $0을 쓰는 경우도 있지만, 보다 견고한 스크립트 작성을 위해서는 BASH_SOURCE를 사용하는 것이 권장됩니다.
추가로 Bash에서는 변수 조작을 위한 몇 가지 유용한 파라미터 확장(Parameter Expansion) 기법을 제공합니다.
${BASH_SOURCE-$0}:BASH_SOURCE가 정의되어 있지 않으면$0을 대신 사용합니다.${VAR:-default}: 변수VAR가 비어있거나 설정되지 않은 경우 'default'를 값으로 사용합니다.${VAR/old/new}:VAR변수 내에서 첫 번째로 매칭되는 'old' 패턴을 'new'로 치환합니다.