Quellcode durchsuchen

sync Japanese document with r17685.

git-svn-id: http://framework.zend.com/svn/framework/standard/trunk@17703 44c647ce-9c0f-0410-b52a-842ac1e357ba
takagi vor 16 Jahren
Ursprung
Commit
4c7f7efc13

+ 47 - 1
documentation/manual/ja/module_specs/Zend_File_Transfer-Migration.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 17618 -->
+<!-- EN-Revision: 17685 -->
 <sect1 id="zend.file.transfer.migration">
 
     <title>以前のバージョンからの移行</title>
@@ -12,6 +12,52 @@
         新しい <acronym>API</acronym> にあわせましょう。
     </para>
 
+    <sect2 id="zend.file.transfer.migration.fromonenineonetooneten">
+        <title>1.9 から 1.10 以降への移行</title>
+        <sect3 id="zend.file.transfer.migration.fromonenineonetooneten.mimetype">
+            <title>MimeType の検証</title>
+
+            <para>
+                セキュリティ上の理由から、
+                <classname>MimeType</classname>、<classname>ExcludeMimeType</classname>、
+                <classname>IsCompressed</classname> および <classname>IsImage</classname>
+                バリデータにおけるデフォルトのフォールバック機能を無効にしました。
+                つまり、<emphasis>fileInfo</emphasis> 拡張モジュールあるいは
+                <emphasis>magicMime</emphasis> 拡張モジュールがなければ、
+                検証が常に失敗するようになるということです。
+            </para>
+
+            <para>
+                ユーザ側から渡された <acronym>HTTP</acronym> フィールドを使用して入力を検証する必要がある場合は、
+                <methodname>enableHeaderCheck()</methodname> メソッドを使用すればこの機能を有効にできます。
+            </para>
+
+            <note>
+                <title>セキュリティに関するヒント</title>
+
+                <para>
+                    ユーザ側から渡された <acronym>HTTP</acronym>
+                    フィールドに依存するのはセキュリティ上のリスクとなることに注意しましょう。
+                    これは簡単に改ざんすることができ、悪意のあるファイルを受け取る可能性があります。
+                    ユーザ側から渡された <acronym>HTTP</acronym> フィールドを使用して入力を検証する必要がある場合は、
+                    <methodname>enableHeaderCheck()</methodname> メソッドを使用すればこの機能を有効にできます。
+                </para>
+            </note>
+
+            <example id="zend.file.transfer.migration.fromonenineonetooneten.example">
+                <title>HTTP フィールドの使用を許可する</title>
+
+                <programlisting language="php"><![CDATA[
+// 初期化時に
+$valid = new Zend_File_Transfer_Adapter_Http(array('headerCheck' => true);
+
+// あるいは後から
+$valid->enableHeaderCheck();
+]]></programlisting>
+        </example>
+        </sect3>
+    </sect2>
+
     <sect2 id="zend.file.transfer.migration.fromonesixtooneseven">
         <title>1.6 から 1.7 以降への移行</title>
         <sect3 id="zend.file.transfer.migration.fromonesixtooneseven.validators">

+ 21 - 1
documentation/manual/ja/module_specs/Zend_File_Transfer-Validators.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 17618 -->
+<!-- EN-Revision: 17685 -->
 <sect1 id="zend.file.transfer.validators">
 
     <title>Zend_File_Transfer 用のバリデータ</title>
@@ -565,6 +565,16 @@ $upload->addValidator('ExcludeExtension',
                     このオプションで、許可したくないファイルの <acronym>MIME</acronym> 型を定義することができます。
                 </para>
             </listitem>
+
+            <listitem>
+                <para>
+                    <code>headerCheck</code>: <constant>TRUE</constant> に設定すると、
+                    <emphasis>fileInfo</emphasis> あるいは <emphasis>mimeMagic</emphasis>
+                    拡張モジュールがない場合にも <acronym>HTTP</acronym>
+                    情報からファイルタイプをチェックします。このオプションのデフォルト値は
+                    <constant>FALSE</constant> です。
+                </para>
+            </listitem>
         </itemizedlist>
 
         <para>
@@ -1103,6 +1113,16 @@ $upload->addValidator('Md5',
 
             <listitem>
                 <para>
+                    <code>headerCheck</code>: <constant>TRUE</constant> に設定すると、
+                    <emphasis>fileInfo</emphasis> あるいは <emphasis>mimeMagic</emphasis>
+                    拡張モジュールがない場合にも <acronym>HTTP</acronym>
+                    情報からファイルタイプをチェックします。このオプションのデフォルト値は
+                    <constant>FALSE</constant> です。
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
                     <code>magicfile</code>: 使用する magicfile。
                 </para>