【Shell-Tips】getoptsとusageを実装してみる。

シェルには、コマンドのオプシヨンを解析したリチェックしたりするための、getoptsというコマンドが用意されています。

レビュー時にいつも思うのは、この「getOpts」を使用するエンジニアが少ないこと・・

「getOpts」コマンドは、シェルに対して「-」と"アルファベット１文字"でオプションを指定された場合、それを解析するコマンドです。オプションによって挙動を変えたい時にcase文と共に用います。

実際には習うより慣れろが正しいため、下記にサンプルを実装します。

「getOpts」コマンド

「getOptsコマンドを使うと何がうれしいの？」とよく聞かれることがあります。特にうれしいことはありませんが（笑う・・楽です

もし、シェルスクリプトの引数処理で何かの制御をおなう場合、一番初めに考えれらるのが「if」文だと思いますが、「if」文で引数を制御する場合はパラメータの順番に気を遣わなければならなくなります。

仮にバックアップ用のシェルスクリプト「backup.sh」を作成した場合、必要となる要素は「バックアップ対象」と「バックアップ格納先」になると思います。

ハードコーディング（ソースべた書き）でも良いのですが、それだと「backup.sh」が汎用的に使用できないモノになってしまうため、通常はまず引数で情報の受け渡しを考えるはずです。

if文の場合

# バックアップシェル実行形式
$ backup.sh ＜バックアップ対象＞ ＜バックアップ先パス＞

# 「backup.sh」内部の引数チェックロジック
#!/bin/sh
checkArgs() {
  if [ -f ${1} ]; then
    src=＜バックアップ対象＞
  fi
  if [ -d ${2} ]: then
    dst=＜バックアップ先パス＞
  fi
}

上記がその際に考えられる実行形式になると思います。

この場合、もし第一引数の＜バックアップ対象＞に値がはいっていなかった場合どうなるでしょう。値が空であるため、第二引数の＜バックアップ先＞が第一引数として実行されてしまうのです。

# バックアップシェル実行形式
$ backup.sh ＜バックアップ対象（空）＞ ＜バックアップ先パス＞

# 「backup.sh」内部の引数チェックロジック
#!/bin/sh
checkArgs() {
  if [ -f ${1} ]; then
    src=＜バックアップ先パス＞
  fi
  if [ -d ${2} ]: then
    dst=
  fi
}

チェックが甘くて正常終了してしまった場合、あるはずのバックアップが存在しないことになってしまいます。

getOptsの場合

判り易くバックアップ対象を「-s（source）」、バックアップ先パスを「-d（destination）」としておきます。

# バックアップシェル実行形式
$ backup.sh -s ＜バックアップ対象＞ -d ＜バックアップ先パス＞

#!/bin/sh
#-s /-d オプションを指定した場合に出すメッセージを変更する
while getopts s:d: opts
do
  case $opts in
    s ) src=$OPTARG ;;
    d) dst=$OPTARG ;;
    * ) usage
       exitLog ${JOB_WR} ;;
  esac
done;

「while」文の隣に「getOpts」コマンドを記述します。getoptsの次に書かなくてはならない引数は、このシェルスクリプトで処理させようとするオプションを並べたものになります。

もしそのオプションが値を必要とするものならば、その直後に「：(コロン)」を付けます。つまり「while getopts s:d: opts」となります。

「：(コロン)」を付けたオプションの値は、$OPTARGと言いう変数に自動的に格納されます。よって「while」文直下の「case」文の処理では、$OPTARGに代入された値をスクリプト内の変数へ代入します。「src=$OPTARG」

上記のロジックの場合、「-s（source）」、バックアップ先パスを「-d（destination）」何方でもないオプション（例えば[ r ]など）が引数と渡された場合、「case」文の「＊）」でキャッチされます。

上記の例では「usage」がコールされ、処理が「exitLog」へ引き渡されます。

「Usege」関数

この「Usage」関数は、特にシェルに用意されているモノでありません。「ヒアドキュメント」を使用して、作成したシェルの実行方法や引数などを表示する自作関数です。

記述方法は簡単で、「ヒアドキュメント」を関数かしただけです。

実際に作成してみます。

usage() {
cat <<EOUSAGE
-----------------------------------------------------------------
Usage: $0 [< options >]
Options:
-s backup_target : Specifies the target file or target to backcup.
-d destination_path : Specify the backup storage directory path.
------------------------------------------------------------------
EOUSAGE
}

これだけです。「$0」は実行しているスクリプト名を表示します。つまり自分の名前です。

EOUSAGEは「End Of Usage」の略です。特に制約等はありませんので開始と終了が同じ文字列なら「EOF」でもなんでもかまいません。

このように「ヒアドキュメント」以外に、特にロジックというロジックはありません。（笑

上記「usage」は、「case」文の「＊）」でキャッチされ、実行されます。つまり間違えた引数を指定してシェルを実行した場合、エラーと一緒に出力される自作ヘルプメッセージです。

「usage」の実行結果

[root@CentOS7 bin]# sh func.sh -s /src -r /dst
[root@CentOS7 bin]# cd ../log
[root@CentOS7 log]# cat func.log
2020-05-12 16:42:13 [ pre ] SCRIPT:[ func.sh ] PID:[ 11858 ] STARTED LOG.
func.sh: 不正なオプションです -- r
-----------------------------------------------------------------
Usage: func.sh [< options >]
Options:
-s backup_target : Specifies the target file or target to backcup.
-d destination_path : Specify the backup storage directory path.
------------------------------------------------------------------
2020-05-12 16:42:13 [ pre ] SCRIPT:[ func.sh ] PID:[ 11858 ] ENDED LOG with ERROR.

どうでしょう？　それなりに見えませんか？

「オレ（ワタシ）って意外といけるんじゃね？」と思っていただけると嬉しいです。

最後に、上記を実行したシェルスクリプトを載せておきます。

実行シェルスクリプトを作成する

getOptsを使用したシェルスクリプトを作成します。

このサンプルでは、getopts の基本動作を理解しやすくするために、最低限の引数チェックのみを行っています。実務スクリプトでは、必須オプションの有無や入力値の妥当性をさらに厳密に検証する処理を追加してください。

なお、ログの出力には下記の共通ログ出力クラスおよび共通関数定義クラスを使用しています。

Beエンジニア

1 Pocket

【Shellの基礎知識】簡単なログ出力ロジックを作ってみました。

https://www.pmi-sfbac.org/append_log

商用プロジェクトは1から100に至るまで、すべてエビデンスの世界です。システムに障害は付きものですので、障害報告を行う際には、必ず「1次報告」「中間報告」「最終報告」をエビデンス付きで提出しなければなりません。シェルスクリプトを作成する場合、予め障害が発生することを念頭に入れて設計を進めていきます。基盤として挙げるなら「CPU」や「メモリ」、「ディスク」など、リソース周りの障害は約束されていることです。では、そのエビデンスとして必要になるものは何でしょう？エビデンスとして必ず必要になるものとは、ずば...

Beエンジニア

【Shellの基礎知識】共通関数定義クラスの完全ガイド！設計から実践まで徹底解説

https://www.pmi-sfbac.org/shell-utils

共通関数定義クラスの概要と役割共通関数定義クラス（utils.shrc）は、シェルスクリプト開発において頻繁に使用される汎用的な関数をまとめたスクリプトです。これを活用することで、スクリプトごとに重複したコードを書く必要がなくなり、開発の効率化や保守性の向上を実現できます。特に、シェルスクリプトはプロジェクトが大規模になるにつれて管理が複雑になりがちです。utils.shrcを導入することで、スクリプト間の一貫性を保ちつつ、共通機能を統一した形式で提供できます。共通関数定義クラスの目的共通関数定義クラスの主な目...

前提となる実行環境

Beエンジニアでシェルスクリプトを実行する環境は下記の通りとします。

引数なしで実行

引数なしで実行すると、checkArgs()関数で引数がないためusageが出力されます。

sh func.sh

【出力例:】

2025-10-17 08:43:22 [ INFO ] [ pre ] SCRIPT:[func.sh] PID:[293526] STARTED LOG.
2025-10-17 08:43:22 [ ERROR ] [ pre ] no arguments specified.
-----------------------------------------------------------------
Usage: func.sh [< options >]
Options:
-b backup_target : Specifies the target file or target to backcup.
-m destination_path : Specify the backup storage directory path.
------------------------------------------------------------------
2025-10-17 08:43:22 [ WARNING ] [ pre ] SCRIPT:[func.sh] PID:[293526] ENDED LOG.

引数ありで実行

引数をつけて実行すると、getOptsによって適切な変数へ引数が格納され、ログに出力されます。

sh func.sh -s /src -d /dst

【出力例:】

2025-10-17 08:50:18 [ INFO ] [ pre ] SCRIPT:[func.sh] PID:[298173] STARTED LOG.
src=/src dst=/dst
2025-10-17 08:50:18 [ INFO ] [ post ] SCRIPT:[func.sh] PID:[298173] ENDED LOG.

実践環境を整える

ここまで学んだ知識を実際に試すには、Linuxを動かす環境が必要です。手軽に始めるならVPSを利用するのがおすすめです。
→ VPS徹底比較！ConoHa・さくら・Xserverの選び方

Beエンジニア

VPS徹底比較！ConoHa・さくら・Xserverの選び方

https://www.pmi-sfbac.org/vps-comparison-conoha-xserver-sakura

国内で人気の高いVPSサービス「ConoHa VPS」「さくらのVPS」「エックスサーバーVPS」。どれも高性能で魅力的な選択肢ですが、用途や重視ポイントによって最適な選び方は変わってきます。この記事では、料金、スペック、操作性、サポート体制などを徹底比較しながら、あなたにぴったりのVPSを見つけるためのヒントをわかりやすく紹介します。それでももし、VPSをどれにするか迷っているなら、まずは ConoHa VPS を選べば間違いありません。料金・使いやすさ・安定性のバランスが良く、初心者から実務利用まで幅広く対応できます。主要3...

VPSを利用してLinux環境を準備したら、実際の設定は下記の記事が参考になります。
→ VPSに開発環境を自動構築する方法｜Apache＋Tomcat＋PostgreSQL

Beエンジニア

VPSにJavaアプリの開発環境を自動で構築する方法：Apache＋Tomcat＋PostgreSQL

https://www.pmi-sfbac.org/rhel-server-setup

開発環境を整えるとき、いきなり細かい設定から入ってしまうと、構築の全体像が見えず混乱しがちです。本シリーズでは、5つのパートに分けて順を追って開発環境を構築していきます。この構成は、構築に必要な順序でステップを並べ（クラウド → Web → AP → DB → 保守）、各パートは独立して読めるようにし、スクリプトによる自動化を前提に操作負担を極力減らす方針に基づいています。ただし、手動で対応すべき設定も明示的に解説します。構築する環境のイメージ最終的に以下のような構成になります。Webサーバ → アプリサーバ → データ...