シェルスクリプトのmain関数パターン｜関数定義と実処理を分けて読み込み時の暴発を防ぐ構成

この記事のポイント

・BASH_SOURCE[0] と $0 を比較する1行で実行ガードを実装できる
・すべての処理を関数化し main() に集約するのが設計の核心
・source で読み込んだ場合は関数定義のみ行われ実行は走らない
・共通処理をライブラリ化して複数スクリプトから再利用できる

#!/bin/bash
# backup.sh（main関数パターンを使っていない例）

BACKUP_SRC="/var/data"
BACKUP_DEST="/backup"

backup() {
    echo "バックアップ開始: $BACKUP_SRC → $BACKUP_DEST"
    rsync -a "$BACKUP_SRC/" "$BACKUP_DEST/"
}

# この行がsourceしただけで即座に実行される
backup

# NG: sourceするとbackup()が即座に実行されてしまう
$ source backup.sh
バックアップ開始: /var/data → /backup

#!/bin/bash
# backup.sh（関数化したバージョン）

BACKUP_SRC="/var/data"
BACKUP_DEST="/backup"

# ユーティリティ関数（ライブラリとして再利用可能）
log() {
    local msg="$1"
    echo "[$(date '+%Y-%m-%d %H:%M:%S')] $msg"
}

validate_dirs() {
    if [[ ! -d "$BACKUP_SRC" ]]; then
        echo "ERROR: バックアップ元が存在しません: $BACKUP_SRC" >&2
        return 1
    fi
    mkdir -p "$BACKUP_DEST"
}

run_backup() {
    log "バックアップ開始: $BACKUP_SRC → $BACKUP_DEST"
    rsync -a --checksum "$BACKUP_SRC/" "$BACKUP_DEST/"
    log "バックアップ完了"
}

# エントリポイント関数
main() {
    validate_dirs || exit 1
    run_backup
}

# ファイルの末尾に追加する実行ガード（全関数定義の後に置く）
if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
    main "$@"
fi

# 直接実行する場合（mainが走る）
$ bash backup.sh
[2026-09-10 10:00:00] バックアップ開始: /var/data → /backup
[2026-09-10 10:00:05] バックアップ完了

# sourceする場合（関数だけが定義され、mainは走らない）
$ source backup.sh
$
# プロンプトが返るだけ。バックアップは実行されていない

# sourceした後、関数を個別に呼び出せる
$ log "テストメッセージ"
[2026-09-10 10:00:10] テストメッセージ

main() {
    local src="${1:-$BACKUP_SRC}"    # 引数があれば使い、なければデフォルト値
    local dest="${2:-$BACKUP_DEST}"

    log "バックアップ開始: $src → $dest"
    rsync -a --checksum "$src/" "$dest/"
    log "バックアップ完了"
}

if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
    main "$@"
fi

# 引数を渡して直接実行する
$ bash backup.sh /var/www /backup/www
[2026-09-10 10:00:00] バックアップ開始: /var/www → /backup/www
[2026-09-10 10:00:08] バックアップ完了

#!/bin/bash
# /usr/local/lib/shell/common.sh — 共通ライブラリ

# ログ出力関数
log_info() {
    echo "[INFO][$(date '+%Y-%m-%d %H:%M:%S')] $*"
}

log_error() {
    echo "[ERROR][$(date '+%Y-%m-%d %H:%M:%S')] $*" >&2
}

# ディレクトリ存在確認（なければ作成する）
ensure_dir() {
    local dir="$1"
    if [[ ! -d "$dir" ]]; then
        mkdir -p "$dir" || {
            log_error "ディレクトリ作成失敗: $dir"
            return 1
        }
    fi
}

# 誤って直接実行された場合に使い方を示す
if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
    echo "このファイルはライブラリです。sourceして使用してください。" >&2
    exit 1
fi

#!/bin/bash
# /usr/local/bin/backup.sh — バックアップスクリプト本体

# ライブラリを絶対パスで読み込む
source "/usr/local/lib/shell/common.sh"

BACKUP_SRC="/var/data"
BACKUP_DEST="/backup/data"

run_backup() {
    ensure_dir "$BACKUP_DEST" || exit 1
    log_info "バックアップ開始: $BACKUP_SRC → $BACKUP_DEST"
    rsync -a --checksum "$BACKUP_SRC/" "$BACKUP_DEST/"
    log_info "バックアップ完了"
}

main() {
    run_backup
}

if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
    main "$@"
fi

$ bash /usr/local/bin/backup.sh
[INFO][2026-09-10 10:30:00] バックアップ開始: /var/data → /backup/data
[INFO][2026-09-10 10:30:12] バックアップ完了

# bash推奨: BASH_SOURCEが使える
#!/bin/bash

# NG: #!/bin/sh ではBASH_SOURCEが未定義になる
# Ubuntu等のdash環境ではBASH_SOURCE[0]が空文字になりガードが機能しない

# NG: 関数定義より前に実行ガードがある
if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
    main "$@"    # この時点でmain()はまだ定義されていない → エラー
fi

main() {
    echo "hello"
}

# OK: 全関数定義の後に実行ガードを配置する
main() {
    echo "hello"
}

if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
    main "$@"
fi

# localで変数スコープを制限する（関数内の変数がシェルに残らない）
log_info() {
    local timestamp
    timestamp="$(date '+%Y-%m-%d %H:%M:%S')"
    echo "[INFO][$timestamp] $*"
}