Revision 68 | Revision 2242 | Zur aktuellen Revision | Blame | Vergleich mit vorheriger | Letzte Änderung | Log anzeigen | RSS feed
<?php/*** CodeIgniter** An open source application development framework for PHP** This content is released under the MIT License (MIT)** Copyright (c) 2014 - 2017, British Columbia Institute of Technology** Permission is hereby granted, free of charge, to any person obtaining a copy* of this software and associated documentation files (the "Software"), to deal* in the Software without restriction, including without limitation the rights* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell* copies of the Software, and to permit persons to whom the Software is* furnished to do so, subject to the following conditions:** The above copyright notice and this permission notice shall be included in* all copies or substantial portions of the Software.** THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN* THE SOFTWARE.** @package CodeIgniter* @author EllisLab Dev Team* @copyright Copyright (c) 2008 - 2014, EllisLab, Inc. (https://ellislab.com/)* @copyright Copyright (c) 2014 - 2017, British Columbia Institute of Technology (http://bcit.ca/)* @license http://opensource.org/licenses/MIT MIT License* @link https://codeigniter.com* @since Version 1.0.0* @filesource*/defined('BASEPATH') OR exit('No direct script access allowed');/*** FTP Class** @package CodeIgniter* @subpackage Libraries* @category Libraries* @author EllisLab Dev Team* @link https://codeigniter.com/user_guide/libraries/ftp.html*/class CI_FTP {/*** FTP Server hostname** @var string*/public $hostname = '';/*** FTP Username** @var string*/public $username = '';/*** FTP Password** @var string*/public $password = '';/*** FTP Server port** @var int*/public $port = 21;/*** Passive mode flag** @var bool*/public $passive = TRUE;/*** Debug flag** Specifies whether to display error messages.** @var bool*/public $debug = FALSE;// --------------------------------------------------------------------/*** Connection ID** @var resource*/protected $conn_id;// --------------------------------------------------------------------/*** Constructor** @param array $config* @return void*/public function __construct($config = array()){empty($config) OR $this->initialize($config);log_message('info', 'FTP Class Initialized');}// --------------------------------------------------------------------/*** Initialize preferences** @param array $config* @return void*/public function initialize($config = array()){foreach ($config as $key => $val){if (isset($this->$key)){$this->$key = $val;}}// Prep the hostname$this->hostname = preg_replace('|.+?://|', '', $this->hostname);}// --------------------------------------------------------------------/*** FTP Connect** @param array $config Connection values* @return bool*/public 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 neededif ($this->passive === TRUE){ftp_pasv($this->conn_id, TRUE);}return TRUE;}// --------------------------------------------------------------------/*** FTP Login** @return bool*/protected function _login(){return @ftp_login($this->conn_id, $this->username, $this->password);}// --------------------------------------------------------------------/*** Validates the connection ID** @return bool*/protected function _is_conn(){if ( ! is_resource($this->conn_id)){if ($this->debug === TRUE){$this->_error('ftp_no_connection');}return FALSE;}return TRUE;}// --------------------------------------------------------------------/*** Change directory** The second parameter lets us momentarily turn off debugging so that* 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 parameter is only used by the "mirror" function below.** @param string $path* @param bool $suppress_debug* @return bool*/public function changedir($path, $suppress_debug = FALSE){if ( ! $this->_is_conn()){return FALSE;}$result = @ftp_chdir($this->conn_id, $path);if ($result === FALSE){if ($this->debug === TRUE && $suppress_debug === FALSE){$this->_error('ftp_unable_to_changedir');}return FALSE;}return TRUE;}// --------------------------------------------------------------------/*** Create a directory** @param string $path* @param int $permissions* @return bool*/public 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_mkdir');}return FALSE;}// Set file permissions if neededif ($permissions !== NULL){$this->chmod($path, (int) $permissions);}return TRUE;}// --------------------------------------------------------------------/*** Upload a file to the server** @param string $locpath* @param string $rempath* @param string $mode* @param int $permissions* @return bool*/public function upload($locpath, $rempath, $mode = 'auto', $permissions = NULL){if ( ! $this->_is_conn()){return FALSE;}if ( ! file_exists($locpath)){$this->_error('ftp_no_source_file');return FALSE;}// Set the mode if not specifiedif ($mode === 'auto'){// Get the file extension so we can set the upload type$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;}// Set file permissions if neededif ($permissions !== NULL){$this->chmod($rempath, (int) $permissions);}return TRUE;}// --------------------------------------------------------------------/*** Download a file from a remote server to the local server** @param string $rempath* @param string $locpath* @param string $mode* @return bool*/public function download($rempath, $locpath, $mode = 'auto'){if ( ! $this->_is_conn()){return FALSE;}// Set the mode if not specifiedif ($mode === 'auto'){// Get the file extension so we can set the upload type$ext = $this->_getext($rempath);$mode = $this->_settype($ext);}$mode = ($mode === 'ascii') ? FTP_ASCII : FTP_BINARY;$result = @ftp_get($this->conn_id, $locpath, $rempath, $mode);if ($result === FALSE){if ($this->debug === TRUE){$this->_error('ftp_unable_to_download');}return FALSE;}return TRUE;}// --------------------------------------------------------------------/*** Rename (or move) a file** @param string $old_file* @param string $new_file* @param bool $move* @return bool*/public function rename($old_file, $new_file, $move = FALSE){if ( ! $this->_is_conn()){return FALSE;}$result = @ftp_rename($this->conn_id, $old_file, $new_file);if ($result === FALSE){if ($this->debug === TRUE){$this->_error('ftp_unable_to_'.($move === FALSE ? 'rename' : 'move'));}return FALSE;}return TRUE;}// --------------------------------------------------------------------/*** Move a file** @param string $old_file* @param string $new_file* @return bool*/public function move($old_file, $new_file){return $this->rename($old_file, $new_file, TRUE);}// --------------------------------------------------------------------/*** Rename (or move) a file** @param string $filepath* @return bool*/public function delete_file($filepath){if ( ! $this->_is_conn()){return FALSE;}$result = @ftp_delete($this->conn_id, $filepath);if ($result === FALSE){if ($this->debug === TRUE){$this->_error('ftp_unable_to_delete');}return FALSE;}return TRUE;}// --------------------------------------------------------------------/*** Delete a folder and recursively delete everything (including sub-folders)* contained within it.** @param string $filepath* @return bool*/public function delete_dir($filepath){if ( ! $this->_is_conn()){return FALSE;}// Add a trailing slash to the file path if needed$filepath = preg_replace('/(.+?)\/*$/', '\\1/', $filepath);$list = $this->list_files($filepath);if ( ! empty($list)){for ($i = 0, $c = count($list); $i < $c; $i++){// If we can't delete the item it's probaly a directory,// so we'll recursively call delete_dir()if ( ! preg_match('#/\.\.?$#', $list[$i]) && ! @ftp_delete($this->conn_id, $list[$i])){$this->delete_dir($filepath.$list[$i]);}}}if (@ftp_rmdir($this->conn_id, $filepath) === FALSE){if ($this->debug === TRUE){$this->_error('ftp_unable_to_delete');}return FALSE;}return TRUE;}// --------------------------------------------------------------------/*** Set file permissions** @param string $path File path* @param int $perm Permissions* @return bool*/public function chmod($path, $perm){if ( ! $this->_is_conn()){return FALSE;}if (@ftp_chmod($this->conn_id, $perm, $path) === FALSE){if ($this->debug === TRUE){$this->_error('ftp_unable_to_chmod');}return FALSE;}return TRUE;}// --------------------------------------------------------------------/*** FTP List files in the specified directory** @param string $path* @return array*/public function list_files($path = '.'){return $this->_is_conn()? ftp_nlist($this->conn_id, $path): FALSE;}// ------------------------------------------------------------------------/*** Read a directory and recreate it remotely** This function recursively reads a 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.** @param string $locpath Path to source with trailing slash* @param string $rempath Path to destination - include the base folder with trailing slash* @return bool*/public function mirror($locpath, $rempath){if ( ! $this->_is_conn()){return FALSE;}// Open the local file pathif ($fp = @opendir($locpath)){// Attempt to open the remote file path and try to create it, if it doesn't existif ( ! $this->changedir($rempath, TRUE) && ( ! $this->mkdir($rempath) OR ! $this->changedir($rempath))){return FALSE;}// Recursively read the local directorywhile (FALSE !== ($file = readdir($fp))){if (is_dir($locpath.$file) && $file[0] !== '.'){$this->mirror($locpath.$file.'/', $rempath.$file.'/');}elseif ($file[0] !== '.'){// 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** @param string $filename* @return string*/protected function _getext($filename){return (($dot = strrpos($filename, '.')) === FALSE)? 'txt': substr($filename, $dot + 1);}// --------------------------------------------------------------------/*** Set the upload type** @param string $ext Filename extension* @return string*/protected function _settype($ext){return in_array($ext, array('txt', 'text', 'php', 'phps', 'php4', 'js', 'css', 'htm', 'html', 'phtml', 'shtml', 'log', 'xml'), TRUE)? 'ascii': 'binary';}// ------------------------------------------------------------------------/*** Close the connection** @return bool*/public function close(){return $this->_is_conn()? @ftp_close($this->conn_id): FALSE;}// ------------------------------------------------------------------------/*** Display error message** @param string $line* @return void*/protected function _error($line){$CI =& get_instance();$CI->lang->load('ftp');show_error($CI->lang->line($line));}}