parse_ini_*(): Add warning that the functions are unsafe with untrusted inputs

php/doc-en@bb54309

Author: mumumu

reference/filesystem/functions/parse-ini-file.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: a5346daf2bb2fab250fa03f0f6639a408d0b2240 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: bb54309eff8a7d75ead0fdf48cc6dae99dd00367 Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka,mumumu -->
 <refentry xml:id="function.parse-ini-file" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -24,6 +24,15 @@
   <para>
    ini ファイルの構造は、&php.ini; の構造と同じです。
   </para>
+  <warning>
+   <simpara>
+    この関数は、信頼できない入力に対して使用してはいけません。
+    ただし、<parameter>scanner_mode</parameter> が
+    <constant>INI_SCANNER_RAW</constant> の場合を除きます。
+    パース済みの出力には、データベースパスワードを保持する定数など、
+    機密性の高い定数の値が含まれる可能性があるためです。
+   </simpara>
+  </warning>
  </refsect1>
 
  <refsect1 role="parameters">

reference/filesystem/functions/parse-ini-string.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd160f9057429a Maintainer: takagi Status: ready -->
+<!-- EN-Revision: bb54309eff8a7d75ead0fdf48cc6dae99dd00367 Maintainer: takagi Status: ready -->
 <!-- Credits: mumumu -->
 <refentry xml:id="function.parse-ini-string" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -23,6 +23,15 @@
   <para>
    文字列の構造は、&php.ini; の構造と同じです。
   </para>
+  <warning>
+   <simpara>
+    この関数は、信頼できない入力に対して使用してはいけません。
+    ただし、<parameter>scanner_mode</parameter> が
+    <constant>INI_SCANNER_RAW</constant> の場合を除きます。
+    パース済みの出力には、データベースパスワードを保持する定数など、
+    機密性の高い定数の値が含まれる可能性があるためです。
+   </simpara>
+  </warning>
  </refsect1>
 
  <refsect1 role="parameters">