yaml_parse_url
(PECL yaml >= 0.4.0)
yaml_parse_url — URL からの YAML ストリームをパースする
説明
$url
[, int $pos = 0
[, int &$ndocs
[, array $callbacks = NULL
]]] ) : mixed指定した URL から読み込んだ YAML ドキュメントストリーム全体あるいはその一部を、PHP の変数に変換します。
パラメータ
-
url -
urlは "scheme://..." 形式でなければなりません。 PHP は、このスキームを見てプロトコルハンドラ (ラッパー) を探します。 対応するラッパーが登録されていない場合は notice を発し、 そのまま通常のファイルとみなして処理を続けます。 -
pos -
ストリームから取り出すドキュメント (-1 はすべてのドキュメント、0 は最初のドキュメント、...)。
-
ndocs -
ndocsを渡すと、 ストリーム内で見つかったドキュメントの数がそこに格納されます。 -
callbacks -
YAML ノードのコンテンツハンドラ。 YAML タグ => callable 形式の連想配列となります。 詳細はパースコールバック を参照ください。
返り値
適切な PHP の型に変換した結果を返します。
失敗した場合に FALSE を返します。
pos が -1 の場合は配列を返します。
配列の各要素が、ストリーム内で見つかった個々のドキュメントとなります。
注意
!php/object タグを使ったノードの unserialize() を有効にしている場合に、 ユーザーからの信頼できない入力を yaml_parse_url() で処理するのは危険です。 この挙動を無効にするには、ini 設定の yaml.decode_php を利用します。
参考
- yaml_parse() - YAML ストリームをパースする
- yaml_parse_file() - ファイルからの YAML ストリームをパースする
- yaml_emit() - YAML 形式にした値を返す