シェルスクリプトに複数の機能を持たせるサブコマンド設計｜引数から関数を安全に呼び分けて1本にまとめる構成

この記事のポイント

・bash 関数呼び出しは関数名を変数に入れて `"$func" "$@"` の形で動的実行できる
・`declare -f 関数名` で関数の存在を確認してから呼ぶのが安全な設計
・サブコマンドと関数を `cmd_start` 形式でプレフィックス対応させる
・未定義サブコマンドは `declare -f` で検出し、明示的にエラーを返す

$ ./backup.sh start          # バックアップを開始する
$ ./backup.sh status         # 状態を確認する
$ ./backup.sh restore 日付   # 指定日時から復元する
$ ./backup.sh cleanup        # 古いバックアップを削除する

cmd_start() {
    local dest="${BACKUP_DIR}/$(date '+%Y%m%d_%H%M%S')"
    mkdir -p "$dest"
    rsync -av /var/data/ "$dest/"
    echo "完了: $dest"
}

cmd_status() {
    echo "=== 最近のバックアップ（5件）==="
    ls -lh "${BACKUP_DIR}" | tail -5
}

cmd_restore() {
    local target="${1:-}"
    if [[ -z "$target" ]]; then
        echo "使い方: $(basename "$0") restore <バックアップ名>" >&2
        exit 1
    fi
    rsync -av "${BACKUP_DIR}/${target}/" /var/data/
    echo "復元完了: $target"
}

cmd_cleanup() {
    find "${BACKUP_DIR}" -maxdepth 1 -type d -mtime +30 -exec rm -rf {} +
    echo "30日超えのバックアップを削除しました"
}

dispatch() {
    local subcmd="${1:-}"
    shift    # $1（サブコマンド）を消費して残りの引数を $@ に残す

    local func="cmd_${subcmd}"

    # declare -f で関数の存在を確認してから呼ぶ（安全なbash 関数呼び出し）
    if declare -f "$func" > /dev/null 2>&1; then
        "$func" "$@"
    else
        echo "エラー: 不明なサブコマンド '${subcmd}'" >&2
        usage
        exit 1
    fi
}

dispatch() {
    local subcmd="${1:-}"

    # 引数なしで呼ばれた場合
    if [[ -z "$subcmd" ]]; then
        echo "エラー: サブコマンドを指定してください" >&2
        usage
        exit 1
    fi

    shift

    # 定義されていない関数名は弾く
    local func="cmd_${subcmd}"
    if ! declare -f "$func" > /dev/null 2>&1; then
        echo "エラー: 不明なサブコマンド '${subcmd}'" >&2
        usage
        exit 1
    fi

    "$func" "$@"
}

#!/bin/bash
set -euo pipefail

# ==== 設定 ====
BACKUP_DIR="/var/backup/data"

# ==== サブコマンド関数 ====
cmd_start() {
    local dest="${BACKUP_DIR}/$(date '+%Y%m%d_%H%M%S')"
    mkdir -p "$dest"
    rsync -av /var/data/ "$dest/"
    echo "完了: $dest"
}

cmd_status() {
    echo "=== 最近のバックアップ（5件）==="
    ls -lh "${BACKUP_DIR}" | tail -5
}

cmd_restore() {
    local target="${1:-}"
    if [[ -z "$target" ]]; then
        echo "使い方: $(basename "$0") restore <バックアップ名>" >&2
        exit 1
    fi
    rsync -av "${BACKUP_DIR}/${target}/" /var/data/
    echo "復元完了: $target"
}

cmd_cleanup() {
    find "${BACKUP_DIR}" -maxdepth 1 -type d -mtime +30 -exec rm -rf {} +
    echo "30日超えのバックアップを削除しました"
}

# ==== ヘルプ ====
usage() {
    cat <<'HELP'
使い方: backup.sh <サブコマンド> [オプション]

サブコマンド:
  start              バックアップを開始する
  status             バックアップ一覧を表示する
  restore <バックアップ名>  指定バックアップから復元する
  cleanup            30日超えのバックアップを削除する
HELP
}

# ==== ディスパッチ ====
dispatch() {
    local subcmd="${1:-}"

    if [[ -z "$subcmd" ]]; then
        echo "エラー: サブコマンドを指定してください" >&2
        usage
        exit 1
    fi

    shift

    local func="cmd_${subcmd}"
    if ! declare -f "$func" > /dev/null 2>&1; then
        echo "エラー: 不明なサブコマンド '${subcmd}'" >&2
        usage
        exit 1
    fi

    "$func" "$@"
}

# ==== エントリーポイント ====
dispatch "$@"

# バックアップ開始
$ ./backup.sh start
sending incremental file list
./
config/
config/app.conf
data/
data/records.db
sent 4,280,192 bytes  received 84 bytes  1,712,110.40 bytes/sec
total size is 4,280,064  speedup is 1.00
完了: /var/backup/data/20260912_143022

# 状態確認
$ ./backup.sh status
=== 最近のバックアップ（5件）===
drwxr-xr-x 4 root root 4.0K Sep 10 08:15 20260910_081512
drwxr-xr-x 4 root root 4.0K Sep 11 08:15 20260911_081503
drwxr-xr-x 4 root root 4.0K Sep 12 14:30 20260912_143022

# 存在しないサブコマンドを指定した場合
$ ./backup.sh upgrade
エラー: 不明なサブコマンド 'upgrade'
使い方: backup.sh <サブコマンド> [オプション]

サブコマンド:
  start              バックアップを開始する
  status             バックアップ一覧を表示する
  restore <バックアップ名>  指定バックアップから復元する
  cleanup            30日超えのバックアップを削除する

# サブコマンドなしで呼んだ場合
$ ./backup.sh
エラー: サブコマンドを指定してください
使い方: backup.sh <サブコマンド> [オプション]
...