標準入力におけるSTDINと"php://stdin"の違いについて

Question

標準入力の説明でfgets(STDIN)を良く見ます。
標準入力については何となく理解できました。
メール等からソースを読み込む際にfile_get_contents("php://stdin")を良く見ます。
これも標準入力だと思うのですが、STDINと"php://stdin"はどう違うのでしょうか。
素人にも分かり易くどなたかご説明頂けますと助かります。

Answer 1

技術的な面については回答があるので，端的に使い分けだけを示しますと

• "php://stdin" はストリームラッパー形式の単なる文字列表現である。 fopen() に渡すとストリームハンドラを取得できる。 但し， PHP_SAPI === 'cli' 以外の環境では 何も読み取れないストリーム という扱いになる。エラーになるわけではない。
• STDIN は PHP_SAPI === 'cli' の場合のみ存在している定数であり，中身はストリームハンドラ。既に fopen() で開かれた状態で存在しているようなもの。 Web サーバとして動いている PHP_SAPI === 'fpm-fcgi' などの環境で参照すると存在しない定数としてエラーとなる。fclose(STDIN) されていた場合はもう使えない状態になっている。

より，ぶっちゃけどっちでもいいですが， PHP_SAPI === 'cli' のチェックをせずに STDIN を参照するのはやめたほうがいいかなーというぐらいです。チェックしてるなら本当にどっちでもいいです。 fclose(STDIN) に関しても書くほうが悪いでしょ、って感じなので

Answer 2

fgets(STDIN)

もともと参考にしたC言語の書き方を真似して使えるようにしたから、でしょうか。
PHP: fgets - Manualを参照するとわかるように、
fgets()の引数にファイルポインタとしてresource型の値を指定するのですが、
PHP: I/O ストリーム - Manualにあるように STDIN は

stdin へのオープン済みのストリーム。

として扱えるようになっています。

一方、

file_get_contents("php://stdin")

については
PHP: file_get_contents - Manualにあるようにファイル名を与えることで読み込む関数であるところを、
PHP: サポートするプロトコル/ラッパー - ManualにあるURL風の表記のプロトコル/ラッパーも受け付けるように拡張してあるからです。

まぁ、いろんな経緯でこうなってるから、これを踏まえて使いましょうとしか。