From 9e774ad7989f7fea33312407a8e25a2724f2ce8b Mon Sep 17 00:00:00 2001
From: admin <devnull@localhost>
Date: Fri, 27 Oct 2006 21:58:04 +0000
Subject:

---
 user_guide/libraries/ftp.html | 71 ++++++++++++++++++++++++++++++++++---------
 1 file changed, 56 insertions(+), 15 deletions(-)

(limited to 'user_guide')

diff --git a/user_guide/libraries/ftp.html b/user_guide/libraries/ftp.html
index 4df9c545b..1fc82b499 100644
--- a/user_guide/libraries/ftp.html
+++ b/user_guide/libraries/ftp.html
@@ -63,8 +63,10 @@ FTP Class
 
 <h1>FTP Class</h1>
 
-<p>Code Igniter's FTP Class permits files to be uploaded via FTP to your server.  It also includes a "mirroring" function
-that permits an local directory to be recreated remotely via FTP.</p>
+<p>Code Igniter's FTP Class permits files to be uploaded, moved, renamed, and deleted on your server.  It also includes a "mirroring" function
+that permits a local directory to be recreated remotely via FTP.</p>
+
+<p class="important"><strong>Note:</strong>&nbsp; SFTP and SSL FTP protocols are not supported, only standard FTP.</p>
 
 <h2>Initializing the Class</h2>
 
@@ -176,10 +178,6 @@ array in that file. Then save the file at <var>config/ftp.php</var> and it will
 </ul>
 
 
-<h2>$this->ftp->sconnect()</h2>
-
-<p>Secure FTP connect.  This function is identical to the function above, except that it initiates a secure connection.</p>
-
 
 <h2>$this->ftp->upload()</h2>
 
@@ -195,26 +193,46 @@ Example:</p>
 <p>Permissions are available if you are running PHP 5 and can be passed as an <kbd>octal</kbd> value in the fourth parameter.</p>
 
 
-<h2>$this->ftp->mkdir()</h2>
+<h2>$this->ftp->rename()</h2>
+<p>Permits you to rename a file.  Supply the source file name/path and the new file name/path.</p>
+
+<code>
+// Renames green.html to blue.html<br />
+$this->ftp->rename('/public_html/foo/green.html', '/public_html/foo/blue.html');
+</code>
 
-<p>Lets you create a directory on your server.  Supply the path ending in the folder name you wish to create, with a trailing slash:</p>
+<h2>$this->ftp->move()</h2>
+<p>Lets you move a file.  Supply the source and destination paths:</p>
 
 <code>
-// Creates a folder named "bar"<br />
-$this->ftp->mkdir('/public_html/foo/bar/');
+// Moves blog.html from "joe" to "fred"<br />
+$this->ftp->move('/public_html/joe/blog.html', '/public_html/fred/blog.html');
 </code>
 
+<p>Note: if the destination file name is different the file will be renamed.</p>
 
-<h2>$this->ftp->chmod()</h2>
 
-<p>Permits you to set file permissions.  Supply the path to the file or folder you wish to alter permissions on:</p>
+<h2>$this->ftp->delete_file()</h2>
+<p>Lets you delete a file.  Supply the source path with the file name.</p>
 
 <code>
-// Chmod "bar" to 777<br />
-$this->ftp->chmod('/public_html/foo/bar/', 0777);
+$this->ftp->delete_file('/public_html/joe/blog.html');
+</code>
+
+
+<h2>$this->ftp->delete_dir()</h2>
+<p>Lets you delete a directory and everything it contains.  Supply the source path to the directory with a trailing slash.</p>
+
+<p class="important"><strong>Important</strong>&nbsp; Be VERY careful with this function.  It will recursively delete 
+<b>everything</b> within the supplied path, including sub-folders and all files.  Make absolutely sure your path is correct.
+Try using the <kbd>list_files()</kbd> function first to verify that your path is correct.</p>
+
+<code>
+$this->ftp->delete_dir('/public_html/path/to/folder/');
 </code>
 
 
+
 <h2>$this->ftp->list_files()</h2>
 <p>Permits you to retrieve a list of files on your server returned as an <dfn>array</dfn>.  You must supply 
 the path to the desired directory.</p>
@@ -228,7 +246,7 @@ print_r($list);
 
 <h2>$this->ftp->mirror()</h2>
 
-<p>Recursively reads a folder and everything it contains (including sub-folders) and creates a 
+<p>Recursively reads a local folder and everything it contains (including sub-folders) and creates a 
 mirror via FTP based on it.  Whatever the directory structure of the original file path will be recreated on the server.
 You must supply a source path and a destination path:</p>
 
@@ -238,6 +256,29 @@ $this->ftp->mirror('/path/to/myfolder/', '/public_html/myfolder/');
 
 
 
+<h2>$this->ftp->mkdir()</h2>
+
+<p>Lets you create a directory on your server.  Supply the path ending in the folder name you wish to create, with a trailing slash.
+Permissions can be set by passed an <kbd>octal</kbd> value in the second parameter (if you are running PHP 5).</p>
+
+<code>
+// Creates a folder named "bar"<br />
+$this->ftp->mkdir('/public_html/foo/bar/', 0777);
+</code>
+
+
+<h2>$this->ftp->chmod()</h2>
+
+<p>Permits you to set file permissions.  Supply the path to the file or folder you wish to alter permissions on:</p>
+
+<code>
+// Chmod "bar" to 777<br />
+$this->ftp->chmod('/public_html/foo/bar/', 0777);
+</code>
+
+
+
+
 <h2>$this->ftp->close();</h2>
 <p>Closes the connection to your server.  It's recommended that you use this when you are finished uploading.</p>
 
-- 
cgit v1.2.3-24-g4f1b