| CFFTP: FTP サーバー接続の確立と切断 | |
| 説明
FTP サーバーとの接続を確立するには、connection 属性に open アクションを指定します。 | |
シンタックス<cfftp action = "action" username = "name" password = "password" server = "server" timeout = "timeout in seconds" port = "port" connection = "name" proxyServer = "proxy server" retryCount = "number" stopOnError = "yes"、"no" passive = "yes"、"no"> |
|
| 関連項目
cfhttp、cfldap、cfmail、cfpop
|
|
| 使用方法
cfftp action="open" で接続を確立するときに connection 属性に名前を指定しておくと、他の FTP オペレーションを実行するときにその接続を再使用できるように、接続がキャッシュされます。キャッシュされた接続を後続の FTP オペレーションで使用する場合、username、password、server といった接続属性を指定する必要はありません。同じ connection 名を使用する FTP オペレーションは、キャッシュされた接続に保管されている情報を自動的に使用します。キャッシュされた接続を使用すると、接続時間を節約し、ファイル転送のパフォーマンスを向上させることができます。 1 つの単純な FTP オペレーション (GetFile や PutFile など) を行うたびに接続を開く必要はありません。 セッションの間またはセッション後も接続を開いたままにするには、その接続名を Session スコープまたは Application スコープに挿入します。たとえば、connection="Session.FTPConnection" を指定します。ただし、この方法を使う場合は、すべての FTP オペレーションで完全な変数名を指定し、終了時に close アクションを使用する必要があります。接続を開いたままにしておくと、他のユーザーが FTP サーバーを使用できません。このため、接続はできるだけ早く閉じるようにしてください。接続名をセッション変数またはアプリケーション変数に割り当てなかった場合は、接続を現在のページのためだけに開いたままになるので、手動で閉じる必要はなくなります。 キャッシュされている接続を変更するときには (retryCount 値や timeout 値を変更する場合など)、接続の再確立が必要になることがあります。 |
|
例<p>cfftp を使用すると、FTP (File Transfer Protocol: ファイル転送プロトコル) オペレーションの実装が
可能になります。
デフォルトでは、cfftp を使用すると、開いている FTP サーバーとの接続がキャッシュされます。
<p>通常、ftp オペレーションには次の 2 種類があります。
<ul>
<li>接続の確立
<li>ファイルとディレクトリのオペレーション
</ul>
<p>この例では、接続を開いて検証し、ディレクトリ内のファイルをリストして、接続を閉じます。
<p>接続を開きます。
<cfftp action = "open"
username = "anonymous"
connection = "My_query"
password = "youremail@email.com"
server = "ftp.tucows.com"
stopOnError = "Yes">
<p>成功しましたか? <cfoutput>#cfftp.succeeded#</cfoutput>
<p>ディレクトリ内のファイルをリストします。
<cfftp action = "LISTDIR"
stopOnError = "Yes"
name = "ListFiles"
directory = "/"
connection = "my_query">
<cfoutput query = "ListFiles">
#name#<br>
</cfoutput>
<p>接続を閉じます。
<cfftp action = "close"
connection = "My_query"
stopOnError = "Yes">
<p>成功しましたか? <cfoutput>#cfftp.succeeded#</cfoutput>
|
|