ライブラリの単体実行

Question

いつもお世話になっております。

PHPでPythonでいうところの下記の実装方法についてお伺いさせてください。

if __name__ == "__main__":

ライブラリの作成をしています（大したものではございませんが）。
ライブラリそのものを実行した場合のみ、コードの実行を可能にしておきたいです。
（requireなどでは実行されないように）
できれば、今後のデバッグのため、コードそのものは残しておきたいのですが、コメントアウト以外の手法があれば採用したいしたいです。
いったん以下のように書いてみて、それなりに動いているのですが心配になり、お知恵を拝借したく、質問させていただきました。

if(realpath($argv[0]) === __FILE__){
}

よろしくお願いいたします m(__)m

Answer 1

定番の方法があるかどうかわかりませんが、わたしは昔このように書いていました。

if (!debug_backtrace(false)) {
    // main なコード
}

ただし、PHP の場合シェバング #!/usr/bin/php を書いたソースファイルを require や include すると、それが出力されることを回避できないと思うので、そのような実装自体があまりオススメできないと思います。

PSR でも、実行用のソースファイルと、クラスや関数定義のソースファイルは分けることが奨励されていたと思います。

---

なお、PHP では、php コマンドから直接実行されたファイルでのみ先頭の #! で始まる行が無視されるようになっているようです。

それ以外の php ファイルではシェバングっぽい記述も通常の php のコードと同じく、単に出力されます。