| CFFTP: 接続 : ファイルおよびディレクトリのオペレーション | |||||||||||||
| 説明
cfftp を使用してファイルおよびディレクトリのオペレーションを行うには、この形式の cfftp タグを使用します。 | |||||||||||||
シンタックス<cfftp action = "action" username = "name" password = "password" name = "query_name" server = "server" ASCIIExtensionList = "extensions" transferMode = "mode" failIfExists = "yes"、"no" directory = "directory name" localFile = "filename" remoteFile = "filename" item = "directory"、"file" existing = "file"、"directory name" new = "file"、"directory name" proxyServer = "proxy server" passive = "yes"、"no"> result = "result_name" |
|||||||||||||
| 関連項目
cfhttp、cfldap、cfmail、cfpop
|
|||||||||||||
| 使用方法
アクティブな FTP 接続への接続キャッシュを使用する場合は、username、password、または server 接続属性を再指定する必要はありません。 キャッシュされている接続を変更するときには (retryCount 値や timeout 値を変更する場合など)、接続の再確立が必要になることがあります。 action = "listDir" の場合、attributes 列には directory または normal が返されます。その他の hidden や system といったプラットフォーム特有の値は、現在はサポートされていません。 action = "listDir" の場合は、mode 列が返されます。この列には、UNIX アクセス許可を表す 8 進数の文字列表記が含まれています (例 : "777")。 cfftp.returnValue 変数は、次のアクションについての戻り値を返します。
詳細については、『ColdFusion MX 開発ガイド』 を参照してください。
|
|||||||||||||
| アクションと cfftp.ReturnValue 変数
アクションの結果によって、returnValue 変数の値が次の表のように決まります。
returnValue 変数にアクセスするには、result 属性で指定される値 (その値が設定されている場合) または cfftp を変数の前に付ける必要があります。result 属性は、複数のページから同時に行われる可能性がある cfftp 呼び出しについて、一方の呼び出しの結果が他方の呼び出しの結果を上書きしないようにするための方法を提供します。result 属性を myResult に設定した場合は、たとえば myResult.returnVariable として returnVariable 変数にアクセスします。あるいは、cfftp.returnVariable としてこの変数にアクセスします。 |
|||||||||||||
| 例
次の例では、接続を開き、ファイルリストを取得し、ファイル名、ディレクトリ名、パス、URL、長さ、および修正日を表示します。 <p>接続を開きます。
<cfftp connection = "myConnection"
username = "myUserName"
password = "myUserName@allaire.com"
server = "ftp.allaire.com"
action = "open"
stopOnError = "Yes">
<p>成功しましたか? <cfoutput>#cfftp.succeeded#</cfoutput>
<cfftp connection = "myConnection"
action = "LISTDIR"
stopOnError = "Yes"
name = "ListDirs"
directory = "/">
<p>FTP ディレクトリリスト<br>
<cftable query = "ListDirs" HTMLTable = "Yes" colHeaders = "Yes">
<cfcol header = "<b>名前</b>" text = "#name#">
<cfcol header = "<b>パス</b>" text = "#path#">
<cfcol header = "<b>URL</b>" text = "#url#">
<cfcol header = "<b>長さ</b>" text = "#length#">
<cfcol header = "<b>最終修正日</b>"
text = "#DateFormat(lastmodified)#">
<cfcol header = "<b>IsDirectory</b>" text = "#isdirectory#">
</cftable>
<p>イメージファイルをリモートサーバーに移動します。<br></p>
<!--- 特記なき限り、イメージは FTP サーバーのルートディレクトリに配置
されます。
例 : remoteFile = "somewhere_put.jpg" vs remoteFile = "/support/somewhere_put.jpg"
--->
<cfftp
connection = "myConnection"
action = "putFile"
name = "uploadFile"
transferMode = "binary"
localFile = "C:filesuploadsomewhere.jpg"
remoteFile = "somewhere_put.jpg"
>
<p>成功しましたか? <cfoutput>#cfftp.succeeded#</cfoutput>
<p>接続を閉じます。
<cfftp connection = "myConnection"
action = "close"
stopOnError = "Yes">
<p>成功しましたか? <cfoutput>#cfftp.succeeded#</cfoutput>
|
|||||||||||||