パラメーター
説明
HTTP リクエストでページに送信されたすべてのファイルを、サーバー上のディレクトリにアップロードします。
戻り値
ファイルのアップロードステータスを含む 構造体 の配列。構造体の内容について詳しくは、 cffile action = " uploadAll " の「使用方法」の節を参照してください。
関数のシンタックス
FileUploadAll(destination, accept, nameConflict, strict, continueOnError, errors, allowedExtensions)
履歴
ColdFusion(2018 リリース)アップデート 3、ColdFusion(2016 リリース)アップデート 10、ColdFusion 11 アップデート 18:パラメーター allowedExtensions が追加されました。
ColdFusion 11:continueOnError および errors パラメーターが追加されました。
ColdFusion 9.0.1:この関数が追加されました。
パラメーター
|
必須 |
デフォルト |
説明 |
---|---|---|---|
destination |
必須 |
|
ファイルの アップロード先となる ディレクトリのパスです。絶対パス(ドライブ文字とコロン、あるいはスラッシュまたは円記号から始まるパス)を指定しない場合は、getTempDirectory 関数から返される ColdFusion テンポラリディレクトリを基準とする相対パスを指定します。 |
accept |
オプション |
|
受け入れる MIME タイプを制限します。カンマ区切りリストです。例えば、コード "image/jpg,application/msword" では、JPEG ファイルと Microsoft Word ファイルのアップロードが許可されます。 strict="true" の場合 accept 属性に MIME タイプが指定されている場合、サーバーまたはアプリケーション設定で拡張子がブロックされると、そのファイルはアップロードされません。 strict="false" の場合 accept 属性でファイル拡張子を指定すると、その拡張子はサーバーまたはアプリケーション設定のブロックされた拡張子リストを上書きします。その後、そのファイルはアップロードされます。 アップロードしようとしているファイルの拡張子が管理者/アプリケーションレベルの設定でブロックされている場合で、MIME タイプが accept 属性に指定されている場合、そのファイルはアップロードされません。 次に例を示します。
属性 allowedExtensions で指定した値が、サーバーまたはアプリケーション設定でブロックされた拡張子のリストを上書きします。 |
nameConflict |
オプション |
Error |
ファイル名がディレクトリ内の ファイル と同じ場合に実行するアクションです。
|
continueOnError |
オプション |
False |
デフォルトでは、いずれかのファイルのアップロードに失敗した場合、残りのファイルはアップロードされません。この値を true に設定した場合、アップロードエラーの発生後 も ファイルのアップロードが継続されます。ファイルアップロードエラーは次の理由により発生します。 1. 空のファイル アップロードに失敗した場合、エラーの詳細が errors 属性に格納されます。 |
allowedExtensions |
オプション |
|
ファイル拡張子のカンマ区切りリスト。アップロードを許可されます。 例えば、.png, .jpg または .jpeg です。 「*」(星)を使用して、accept 属性で指定した MIME タイプを除くすべてのファイルを許可します。 属性 allowedExtensions で指定した値が、サーバーまたはアプリケーション設定でブロックされた拡張子のリストを上書きします。 |
strict |
オプション |
True |
strict="false" accept 属性でファイル拡張子を指定すると、その拡張子はサーバーまたはアプリケーション設定のブロックされた拡張子リストを上書きします。その後、そのファイルはアップロードされます。 accept 属性で MIME タイプを指定し、アップロードしようとしているファイルの拡張子が管理者/アプリケーションレベルの設定でブロックされている場合、そのファイルはアップロードされません。 次に例を示します。
strict="true" accept 属性に MIME タイプが指定されている場合、サーバーまたはアプリケーション設定で拡張子がブロックされると、そのファイルはアップロードされません。 例えば、ColdFusion Administrator でファイルタイプ CFM をブロックし、accept="text/x-coldfusion" および strict="true" を指定して CFM ファイルのアップロードを試行すると、ファイルはアップロードされません 属性 allowedExtensions で指定した値が、サーバーまたはアプリケーション設定でブロックされた拡張子のリストを上書きします。 |
errors |
オプション |
cffile .uploadAllErrors |
ファイルアップロードエラーが格納される変数の名前です。continueOnError が true の場合、指定された変数名にエラーが追加されます 。 ファイルのアップロードが完了すると、各アップロードエラーのアップロードエラー情報を含む構造の配列をこのタグが作成します。 アップロード失敗情報のエラー構造体には次のフィールドが含まれます。
|
例
<cfscript> destination=GetDirectoryFromPath(GetCurrentTemplatePath()); acceptMimes="image/png, image/jpeg, text/x-coldfusion, text/plain, application/xml"; onConflict="MakeUnique"; strict = false; continueOnErr = false; errOnOps = ""; acceptExtensions = ".png, .cfm"; fileUploaded = FileUploadAll(destination, acceptMimes, onConflict, strict, continueOnErr, errOnOps, acceptExtensions); writeDump(fileUploaded); </cfscript>