upgrade to codeigniter 1.7.2 for f12
[www-register-wizard.git] / libraries / Ftp.php
index db65877..6fb1704 100644 (file)
@@ -6,7 +6,7 @@
  *
  * @package            CodeIgniter
  * @author             ExpressionEngine Dev Team
- * @copyright  Copyright (c) 2008, EllisLab, Inc.
+ * @copyright  Copyright (c) 2008 - 2009, EllisLab, Inc.
  * @license            http://codeigniter.com/user_guide/license.html
  * @link               http://codeigniter.com
  * @since              Version 1.0
@@ -23,7 +23,7 @@
  * @category   Libraries
  * @author             ExpressionEngine Dev Team
  * @link               http://codeigniter.com/user_guide/libraries/ftp.html
- */ 
+ */
 class CI_FTP {
 
        var $hostname   = '';
@@ -39,13 +39,13 @@ class CI_FTP {
         * Constructor - Sets Preferences
         *
         * The constructor can be passed an array of config values
-        */     
+        */
        function CI_FTP($config = array())
-       {               
+       {
                if (count($config) > 0)
                {
                        $this->initialize($config);
-               }       
+               }
 
                log_message('debug', "FTP Class Initialized");
        }
@@ -58,7 +58,7 @@ class CI_FTP {
         * @access      public
         * @param       array
         * @return      void
-        */     
+        */
        function initialize($config = array())
        {
                foreach ($config as $key => $val)
@@ -68,7 +68,7 @@ class CI_FTP {
                                $this->$key = $val;
                        }
                }
-               
+
                // Prep the hostname
                $this->hostname = preg_replace('|.+?://|', '', $this->hostname);
        }
@@ -81,38 +81,38 @@ class CI_FTP {
         * @access      public
         * @param       array    the connection values
         * @return      bool
-        */     
+        */
        function connect($config = array())
-       {               
+       {
                if (count($config) > 0)
                {
                        $this->initialize($config);
-               }       
-       
+               }
+
                if (FALSE === ($this->conn_id = @ftp_connect($this->hostname, $this->port)))
                {
                        if ($this->debug == TRUE)
                        {
                                $this->_error('ftp_unable_to_connect');
-                       }               
+                       }
                        return FALSE;
                }
-               
+
                if ( ! $this->_login())
                {
                        if ($this->debug == TRUE)
                        {
                                $this->_error('ftp_unable_to_login');
-                       }               
+                       }
                        return FALSE;
                }
-               
+
                // Set passive mode if needed
                if ($this->passive == TRUE)
                {
                        ftp_pasv($this->conn_id, TRUE);
                }
-               
+
                return TRUE;
        }
 
@@ -123,7 +123,7 @@ class CI_FTP {
         *
         * @access      private
         * @return      bool
-        */     
+        */
        function _login()
        {
                return @ftp_login($this->conn_id, $this->username, $this->password);
@@ -136,7 +136,7 @@ class CI_FTP {
         *
         * @access      private
         * @return      bool
-        */     
+        */
        function _is_conn()
        {
                if ( ! is_resource($this->conn_id))
@@ -144,7 +144,7 @@ class CI_FTP {
                        if ($this->debug == TRUE)
                        {
                                $this->_error('ftp_no_connection');
-                       }               
+                       }
                        return FALSE;
                }
                return TRUE;
@@ -154,40 +154,40 @@ class CI_FTP {
 
 
        /**
-        * Change direcotry
+        * Change directory
         *
         * The second parameter lets us momentarily turn off debugging so that
-        * this function can be used to test for the existance of a folder
+        * this function can be used to test for the existence of a folder
         * without throwing an error.  There's no FTP equivalent to is_dir()
-        * so we do it by trying to change to a particular directory.  
-        * Internally, this paramter is only used by the "mirror" function below.
+        * so we do it by trying to change to a particular directory.
+        * Internally, this parameter is only used by the "mirror" function below.
         *
         * @access      public
         * @param       string
         * @param       bool
         * @return      bool
-        */     
+        */
        function changedir($path = '', $supress_debug = FALSE)
        {
                if ($path == '' OR ! $this->_is_conn())
                {
                        return FALSE;
                }
-               
+
                $result = @ftp_chdir($this->conn_id, $path);
-               
+
                if ($result === FALSE)
                {
                        if ($this->debug == TRUE AND $supress_debug == FALSE)
                        {
                                $this->_error('ftp_unable_to_changedir');
-                       }               
-                       return FALSE;           
+                       }
+                       return FALSE;
                }
-               
+
                return TRUE;
        }
-       
+
        // --------------------------------------------------------------------
 
        /**
@@ -196,23 +196,23 @@ class CI_FTP {
         * @access      public
         * @param       string
         * @return      bool
-        */     
+        */
        function mkdir($path = '', $permissions = NULL)
        {
                if ($path == '' OR ! $this->_is_conn())
                {
                        return FALSE;
                }
-       
+
                $result = @ftp_mkdir($this->conn_id, $path);
-               
+
                if ($result === FALSE)
                {
                        if ($this->debug == TRUE)
                        {
                                $this->_error('ftp_unable_to_makdir');
-                       }               
-                       return FALSE;           
+                       }
+                       return FALSE;
                }
 
                // Set file permissions if needed
@@ -220,10 +220,10 @@ class CI_FTP {
                {
                        $this->chmod($path, (int)$permissions);
                }
-               
+
                return TRUE;
        }
-       
+
        // --------------------------------------------------------------------
 
        /**
@@ -234,7 +234,7 @@ class CI_FTP {
         * @param       string
         * @param       string
         * @return      bool
-        */     
+        */
        function upload($locpath, $rempath, $mode = 'auto', $permissions = NULL)
        {
                if ( ! $this->_is_conn())
@@ -247,7 +247,7 @@ class CI_FTP {
                        $this->_error('ftp_no_source_file');
                        return FALSE;
                }
-       
+
                // Set the mode if not specified
                if ($mode == 'auto')
                {
@@ -255,26 +255,26 @@ class CI_FTP {
                        $ext = $this->_getext($locpath);
                        $mode = $this->_settype($ext);
                }
-               
+
                $mode = ($mode == 'ascii') ? FTP_ASCII : FTP_BINARY;
-               
+
                $result = @ftp_put($this->conn_id, $rempath, $locpath, $mode);
-               
+
                if ($result === FALSE)
                {
                        if ($this->debug == TRUE)
                        {
                                $this->_error('ftp_unable_to_upload');
-                       }               
-                       return FALSE;           
+                       }
+                       return FALSE;
                }
-               
+
                // Set file permissions if needed
                if ( ! is_null($permissions))
                {
                        $this->chmod($rempath, (int)$permissions);
                }
-               
+
                return TRUE;
        }
 
@@ -288,7 +288,7 @@ class CI_FTP {
         * @param       string
         * @param       bool
         * @return      bool
-        */     
+        */
        function rename($old_file, $new_file, $move = FALSE)
        {
                if ( ! $this->_is_conn())
@@ -297,21 +297,21 @@ class CI_FTP {
                }
 
                $result = @ftp_rename($this->conn_id, $old_file, $new_file);
-               
+
                if ($result === FALSE)
                {
                        if ($this->debug == TRUE)
                        {
                                $msg = ($move == FALSE) ? 'ftp_unable_to_rename' : 'ftp_unable_to_move';
-                               
+
                                $this->_error($msg);
-                       }               
-                       return FALSE;           
+                       }
+                       return FALSE;
                }
-               
+
                return TRUE;
        }
-       
+
        // --------------------------------------------------------------------
 
        /**
@@ -321,7 +321,7 @@ class CI_FTP {
         * @param       string
         * @param       string
         * @return      bool
-        */     
+        */
        function move($old_file, $new_file)
        {
                return $this->rename($old_file, $new_file, TRUE);
@@ -335,7 +335,7 @@ class CI_FTP {
         * @access      public
         * @param       string
         * @return      bool
-        */     
+        */
        function delete_file($filepath)
        {
                if ( ! $this->_is_conn())
@@ -344,16 +344,16 @@ class CI_FTP {
                }
 
                $result = @ftp_delete($this->conn_id, $filepath);
-               
+
                if ($result === FALSE)
                {
                        if ($this->debug == TRUE)
-                       {                               
+                       {
                                $this->_error('ftp_unable_to_delete');
-                       }               
-                       return FALSE;           
+                       }
+                       return FALSE;
                }
-               
+
                return TRUE;
        }
 
@@ -366,7 +366,7 @@ class CI_FTP {
         * @access      public
         * @param       string
         * @return      bool
-        */     
+        */
        function delete_dir($filepath)
        {
                if ( ! $this->_is_conn())
@@ -376,13 +376,13 @@ class CI_FTP {
 
                // Add a trailing slash to the file path if needed
                $filepath = preg_replace("/(.+?)\/*$/", "\\1/",  $filepath);
-               
+
                $list = $this->list_files($filepath);
-               
+
                if ($list !== FALSE AND count($list) > 0)
                {
                        foreach ($list as $item)
-                       {                       
+                       {
                                // If we can't delete the item it's probaly a folder so
                                // we'll recursively call delete_dir()
                                if ( ! @ftp_delete($this->conn_id, $item))
@@ -391,18 +391,18 @@ class CI_FTP {
                                }
                        }
                }
-       
+
                $result = @ftp_rmdir($this->conn_id, $filepath);
-               
+
                if ($result === FALSE)
                {
                        if ($this->debug == TRUE)
-                       {                               
+                       {
                                $this->_error('ftp_unable_to_delete');
-                       }               
-                       return FALSE;           
+                       }
+                       return FALSE;
                }
-               
+
                return TRUE;
        }
 
@@ -415,7 +415,7 @@ class CI_FTP {
         * @param       string  the file path
         * @param       string  the permissions
         * @return      bool
-        */             
+        */
        function chmod($path, $perm)
        {
                if ( ! $this->_is_conn())
@@ -429,21 +429,21 @@ class CI_FTP {
                        if ($this->debug == TRUE)
                        {
                                $this->_error('ftp_unable_to_chmod');
-                       }               
-                       return FALSE;           
+                       }
+                       return FALSE;
                }
-       
+
                $result = @ftp_chmod($this->conn_id, $perm, $path);
-               
+
                if ($result === FALSE)
                {
                        if ($this->debug == TRUE)
                        {
                                $this->_error('ftp_unable_to_chmod');
-                       }               
-                       return FALSE;           
+                       }
+                       return FALSE;
                }
-               
+
                return TRUE;
        }
 
@@ -454,7 +454,7 @@ class CI_FTP {
         *
         * @access      public
         * @return      array
-        */     
+        */
        function list_files($path = '.')
        {
                if ( ! $this->_is_conn())
@@ -466,7 +466,7 @@ class CI_FTP {
        }
 
        // ------------------------------------------------------------------------
-       
+
        /**
         * Read a directory and recreate it remotely
         *
@@ -478,7 +478,7 @@ class CI_FTP {
         * @param       string  path to source with trailing slash
         * @param       string  path to destination - include the base folder with trailing slash
         * @return      bool
-        */     
+        */
        function mirror($locpath, $rempath)
        {
                if ( ! $this->_is_conn())
@@ -498,12 +498,12 @@ class CI_FTP {
                                        return FALSE;
                                }
                        }
-               
+
                        // Recursively read the local directory
                        while (FALSE !== ($file = readdir($fp)))
                        {
                                if (@is_dir($locpath.$file) && substr($file, 0, 1) != '.')
-                               {                                       
+                               {
                                        $this->mirror($locpath.$file."/", $rempath.$file."/");
                                }
                                elseif (substr($file, 0, 1) != ".")
@@ -511,47 +511,47 @@ class CI_FTP {
                                        // Get the file extension so we can se the upload type
                                        $ext = $this->_getext($file);
                                        $mode = $this->_settype($ext);
-                                       
+
                                        $this->upload($locpath.$file, $rempath.$file, $mode);
                                }
                        }
                        return TRUE;
                }
-               
+
                return FALSE;
        }
 
 
        // --------------------------------------------------------------------
-       
+
        /**
         * Extract the file extension
         *
         * @access      private
         * @param       string
         * @return      string
-        */     
+        */
        function _getext($filename)
        {
                if (FALSE === strpos($filename, '.'))
                {
                        return 'txt';
                }
-       
+
                $x = explode('.', $filename);
                return end($x);
-       }       
+       }
 
 
        // --------------------------------------------------------------------
-       
+
        /**
         * Set the upload type
         *
         * @access      private
         * @param       string
         * @return      string
-        */     
+        */
        function _settype($ext)
        {
                $text_types = array(
@@ -569,13 +569,13 @@ class CI_FTP {
                                                        'log',
                                                        'xml'
                                                        );
-       
-       
+
+
                return (in_array($ext, $text_types)) ? 'ascii' : 'binary';
        }
 
        // ------------------------------------------------------------------------
-       
+
        /**
         * Close the connection
         *
@@ -583,7 +583,7 @@ class CI_FTP {
         * @param       string  path to source
         * @param       string  path to destination
         * @return      bool
-        */     
+        */
        function close()
        {
                if ( ! $this->_is_conn())
@@ -595,19 +595,19 @@ class CI_FTP {
        }
 
        // ------------------------------------------------------------------------
-       
+
        /**
         * Display error message
         *
         * @access      private
         * @param       string
         * @return      bool
-        */     
+        */
        function _error($line)
        {
                $CI =& get_instance();
                $CI->lang->load('ftp');
-               show_error($CI->lang->line($line));             
+               show_error($CI->lang->line($line));
        }