bashで関数を定義して再利用する方法｜シェルスクリプトのライブラリ化と実践例

この記事のポイント

・bash の関数は function 名 { } または 名 () { } の2通りで定義できる
・引数は $1 $2 ... で受け取り、return で整数の終了ステータスを返す
・local 宣言でローカル変数にすればグローバル変数との衝突を防げる
・source（.コマンド）でライブラリ化し、複数スクリプトから共有する

# function キーワードを使った定義
function greet {
    echo "Hello, $1"
}

# 呼び出し
greet "Linux"

Hello, Linux

# POSIX互換の書き方
greet() {
    echo "Hello, $1"
}

# 定義済み関数の一覧確認
declare -F

# 特定の関数の定義を確認
declare -f greet

# 関数の削除
unset -f greet

greet ()
{
    echo "Hello, $1"
}

#!/bin/bash

# ファイルが存在するか確認する関数
check_file() {
    local filepath="$1"
    if [ -z "$filepath" ]; then
        echo "エラー: ファイルパスが指定されていません" >&2
        return 1
    fi
    if [ -f "$filepath" ]; then
        echo "OK: $filepath は存在します"
        return 0
    else
        echo "NG: $filepath が見つかりません" >&2
        return 2
    fi
}

# 呼び出し
check_file "/etc/hosts"
check_file "/etc/存在しないファイル"

OK: /etc/hosts は存在します
NG: /etc/存在しないファイル が見つかりません

#!/bin/bash

# 複数のサービスをまとめて起動確認する関数
check_services() {
    echo "--- サービス確認 ---"
    for svc in "$@"; do
        if systemctl is-active --quiet "$svc"; then
            echo "  [起動中] $svc"
        else
            echo "  [停止中] $svc"
        fi
    done
    echo "--------------------"
}

# 複数サービスを一括確認
check_services sshd crond firewalld

--- サービス確認 ---
  [起動中] sshd
  [起動中] crond
  [起動中] firewalld
--------------------

#!/bin/bash

# ディスク使用率が閾値を超えたらエラーを返す
check_disk_usage() {
    local mount_point="${1:-/}"
    local threshold="${2:-80}"

    # dfの出力からUse%の数値だけ取得
    local usage
    usage=$(df --output=pcent "$mount_point" 2>/dev/null | tail -1 | tr -d '% ')

    if [ -z "$usage" ]; then
        echo "エラー: $mount_point のディスク情報を取得できません" >&2
        return 1
    fi

    echo "$mount_point の使用率: ${usage}%"

    if [ "$usage" -ge "$threshold" ]; then
        echo "警告: 使用率が ${threshold}% を超えています" >&2
        return 2
    fi

    return 0
}

# 呼び出しと戻り値の確認
check_disk_usage "/" 70
exit_code=$?
echo "終了コード: $exit_code"

/ の使用率: 45%
終了コード: 0

#!/bin/bash

# タイムスタンプ付きのログファイル名を生成して返す
generate_logname() {
    local prefix="${1:-backup}"
    local timestamp
    timestamp=$(date '+%Y%m%d_%H%M%S')
    echo "${prefix}_${timestamp}.log"
}

# コマンド置換で受け取る
LOGFILE=$(generate_logname "deploy")
echo "ログファイル名: $LOGFILE"

ログファイル名: deploy_20260626_143022.log

#!/bin/bash

counter=10  # グローバル変数

bad_func() {
    counter=99  # local なし → グローバルを上書きしてしまう
    echo "関数内: counter=$counter"
}

echo "呼び出し前: counter=$counter"
bad_func
echo "呼び出し後: counter=$counter"   # 99 になってしまう

呼び出し前: counter=10
関数内: counter=99
呼び出し後: counter=99

#!/bin/bash

counter=10  # グローバル変数

good_func() {
    local counter=99  # ローカルスコープ
    echo "関数内: counter=$counter"
}

echo "呼び出し前: counter=$counter"
good_func
echo "呼び出し後: counter=$counter"   # 元の値を保持

呼び出し前: counter=10
関数内: counter=99
呼び出し後: counter=10

# /usr/local/lib/bash/common_lib.sh として保存する例

#!/bin/bash
# common_lib.sh — 共通ライブラリ

# ログ出力（タイムスタンプ＋レベル付き）
log_info() {
    echo "[$(date '+%Y-%m-%d %H:%M:%S')] [INFO]  $*"
}

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

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

# ファイル存在確認（なければ即エラー終了）
require_file() {
    local path="$1"
    if [ ! -f "$path" ]; then
        log_error "必須ファイルが存在しません: $path"
        return 1
    fi
}

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

#!/bin/bash
# deploy.sh — デプロイスクリプト

# ライブラリを読み込む（source または "." コマンド）
LIB_DIR="/usr/local/lib/bash"
# shellcheck source=/usr/local/lib/bash/common_lib.sh
source "${LIB_DIR}/common_lib.sh" || {
    echo "ライブラリの読み込みに失敗しました: ${LIB_DIR}/common_lib.sh" >&2
    exit 1
}

DEPLOY_DIR="/var/www/html/app"
BACKUP_DIR="/var/backup/app"

log_info "デプロイ開始"
ensure_dir "$BACKUP_DIR"
require_file "/etc/app/config.yml" || exit 1

log_info "デプロイ完了"

[2026-06-26 14:30:01] [INFO]  デプロイ開始
[2026-06-26 14:30:01] [INFO]  ディレクトリを作成しました: /var/backup/app
[2026-06-26 14:30:01] [INFO]  デプロイ完了

# common_lib.sh の先頭に追加
# 二重読み込み防止
[ -n "${_COMMON_LIB_LOADED:-}" ] && return 0
_COMMON_LIB_LOADED=1

#!/bin/bash

# 引数が省略されたらデフォルト値を使う
create_backup() {
    local src="${1:-/var/www/html}"
    local dest="${2:-/var/backup}"
    local filename="${3:-backup_$(date '+%Y%m%d').tar.gz}"

    echo "バックアップ: $src → $dest/$filename"
    tar -czf "${dest}/${filename}" "$src" 2>/dev/null
}

# 引数なしで呼び出し → デフォルト値が使われる
create_backup

# 引数を指定して呼び出し
create_backup /etc /tmp "etc_backup.tar.gz"

#!/bin/bash

is_integer() {
    local val="$1"
    [[ "$val" =~ ^-?[0-9]+$ ]]
}

# 使用例
for val in "42" "-5" "3.14" "abc" ""; do
    if is_integer "$val"; then
        echo "'$val' は整数です"
    else
        echo "'$val' は整数ではありません"
    fi
done

'42' は整数です
'-5' は整数です
'3.14' は整数ではありません
'abc' は整数ではありません
'' は整数ではありません

# NG: 定義より前に呼び出している
my_func  # ← command not found

my_func() {
    echo "hello"
}

# OK: 先に定義してから呼び出す
my_func() {
    echo "hello"
}

my_func  # ← 正常に実行される

# スクリプト自身のディレクトリを基準にライブラリを読み込む
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
source "${SCRIPT_DIR}/common_lib.sh"

#!/bin/bash
set -e

# NG: ファイルが存在しないと set -e でスクリプトが終了する
check_optional_file() {
    local path="$1"
    [ -f "$path" ]  # 存在しない場合、終了ステータス1で set -e が発動
}

# OK: || true で set -e の影響を抑制する
check_optional_file() {
    local path="$1"
    [ -f "$path" ] || true
}