include/utils/sugar_file_utils.php

   1 <?php
   2 if(!defined('sugarEntry') || !sugarEntry) die('Not A Valid Entry Point');
   3 /*********************************************************************************
   4  * SugarCRM Community Edition is a customer relationship management program developed by
   5  * SugarCRM, Inc. Copyright (C) 2004-2012 SugarCRM Inc.
   6  *
   7  * This program is free software; you can redistribute it and/or modify it under
   8  * the terms of the GNU Affero General Public License version 3 as published by the
   9  * Free Software Foundation with the addition of the following permission added
  10  * to Section 15 as permitted in Section 7(a): FOR ANY PART OF THE COVERED WORK
  11  * IN WHICH THE COPYRIGHT IS OWNED BY SUGARCRM, SUGARCRM DISCLAIMS THE WARRANTY
  12  * OF NON INFRINGEMENT OF THIRD PARTY RIGHTS.
  13  *
  14  * This program is distributed in the hope that it will be useful, but WITHOUT
  15  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
  16  * FOR A PARTICULAR PURPOSE.  See the GNU Affero General Public License for more
  17  * details.
  18  *
  19  * You should have received a copy of the GNU Affero General Public License along with
  20  * this program; if not, see http://www.gnu.org/licenses or write to the Free
  21  * Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
  22  * 02110-1301 USA.
  23  *
  24  * You can contact SugarCRM, Inc. headquarters at 10050 North Wolfe Road,
  25  * SW2-130, Cupertino, CA 95014, USA. or at email address contact@sugarcrm.com.
  26  *
  27  * The interactive user interfaces in modified source and object code versions
  28  * of this program must display Appropriate Legal Notices, as required under
  29  * Section 5 of the GNU Affero General Public License version 3.
  30  *
  31  * In accordance with Section 7(b) of the GNU Affero General Public License version 3,
  32  * these Appropriate Legal Notices must retain the display of the "Powered by
  33  * SugarCRM" logo. If the display of the logo is not reasonably feasible for
  34  * technical reasons, the Appropriate Legal Notices must display the words
  35  * "Powered by SugarCRM".
  36  ********************************************************************************/
  37
  38
  39 /**
  40  * sugar_mkdir
  41  * Call this function instead of mkdir to apply preconfigured permission
  42  * settings when creating the directory.  This method is basically
  43  * a wrapper to the PHP mkdir function except that it supports setting
  44  * the mode value by using the configuration file (if set).  The mode is
  45  * 0777 by default.
  46  *
  47  * @param $pathname - String value of the directory to create
  48  * @param $mode - The integer value of the permissions mode to set the created directory to
  49  * @param $recursive - boolean value indicating whether or not to create recursive directories if needed
  50  * @param $context
  51  * @return boolean - Returns true on success false on failure
  52  */
  53 function sugar_mkdir($pathname, $mode=null, $recursive=false, $context='') {
  54         $mode = get_mode('dir_mode', $mode);
  55
  56         if ( sugar_is_dir($pathname,$mode) )
  57             return true;
  58
  59         $result = false;
  60         if(empty($mode))
  61                 $mode = 0777;
  62         if(empty($context)) {
  63                 $result = @mkdir($pathname, $mode, $recursive);
  64         } else {
  65                 $result = @mkdir($pathname, $mode, $recursive, $context);
  66         }
  67
  68         if($result){
  69                 if(!sugar_chmod($pathname, $mode)){
  70                         return false;
  71                 }
  72                 if(!empty($GLOBALS['sugar_config']['default_permissions']['user'])){
  73                         if(!sugar_chown($pathname)){
  74                                 return false;
  75                         }
  76                 }
  77                 if(!empty($GLOBALS['sugar_config']['default_permissions']['group'])){
  78                         if(!sugar_chgrp($pathname)) {
  79                                 return false;
  80                         }
  81                 }
  82         }
  83         else {
  84             $GLOBALS['log']->error("Cannot create directory $pathname cannot be touched");
  85         }
  86
  87         return $result;
  88 }
  89
  90 /**
  91  * sugar_fopen
  92  * Call this function instead of fopen to apply preconfigured permission
  93  * settings when creating the the file.  This method is basically
  94  * a wrapper to the PHP fopen function except that it supports setting
  95  * the mode value by using the configuration file (if set).  The mode is
  96  * 0777 by default.
  97  *
  98  * @param $filename - String value of the file to create
  99  * @param $mode - The integer value of the permissions mode to set the created file to
 100  * @param $$use_include_path - boolean value indicating whether or not to search the the included_path
 101  * @param $context
 102  * @return boolean - Returns a file pointer on success, false otherwise
 103  */
 104 function sugar_fopen($filename, $mode, $use_include_path=false, $context=null){
 105         //check to see if the file exists, if not then use touch to create it.
 106         if(!file_exists($filename)){
 107                 sugar_touch($filename);
 108         }
 109
 110         if(empty($context)) {
 111                 return fopen($filename, $mode, $use_include_path);
 112         } else {
 113                 return fopen($filename, $mode, $use_include_path, $context);
 114         }
 115 }
 116
 117 /**
 118  * sugar_file_put_contents
 119  * Call this function instead of file_put_contents to apply preconfigured permission
 120  * settings when creating the the file.  This method is basically
 121  * a wrapper to the PHP file_put_contents function except that it supports setting
 122  * the mode value by using the configuration file (if set).  The mode is
 123  * 0777 by default.
 124  *
 125  * @param $filename - String value of the file to create
 126  * @param $data - The data to be written to the file
 127  * @param $flags - int as specifed by file_put_contents parameters
 128  * @param $context
 129  * @return int - Returns the number of bytes written to the file, false otherwise.
 130  */
 131 function sugar_file_put_contents($filename, $data, $flags=null, $context=null){
 132         //check to see if the file exists, if not then use touch to create it.
 133         if(!file_exists($filename)){
 134                 sugar_touch($filename);
 135         }
 136
 137         if ( !is_writable($filename) ) {
 138             $GLOBALS['log']->error("File $filename cannot be written to");
 139             return false;
 140         }
 141
 142         if(empty($flags)) {
 143                 return file_put_contents($filename, $data);
 144         } elseif(empty($context)) {
 145                 return file_put_contents($filename, $data, $flags);
 146         } else{
 147                 return file_put_contents($filename, $data, $flags, $context);
 148         }
 149 }
 150
 151
 152 /**
 153  * sugar_file_put_contents_atomic
 154  * This is an atomic version of sugar_file_put_contents.  It attempts to circumvent the shortcomings of file_put_contents
 155  * by creating a temporary unique file and then doing an atomic rename operation.
 156  *
 157  * @param $filename - String value of the file to create
 158  * @param $data - The data to be written to the file
 159  * @param string $mode String value of the parameter to specify the type of access you require to the file stream
 160  * @param boolean $use_include_path set to '1' or TRUE if you want to search for the file in the include_path too
 161  * @param context $context Context to pass into fopen operation
 162  * @return boolean - Returns true if $filename was created, false otherwise.
 163  */
 164 function sugar_file_put_contents_atomic($filename, $data, $mode='wb', $use_include_path=false, $context=null){
 165
 166     $dir = dirname($filename);
 167     $temp = tempnam($dir, 'temp');
 168
 169     if (!($f = @fopen($temp, $mode))) {
 170         $temp =  $dir . DIRECTORY_SEPARATOR . uniqid('temp');
 171         if (!($f = @fopen($temp, $mode))) {
 172             trigger_error("sugar_file_put_contents_atomic() : error writing temporary file '$temp'", E_USER_WARNING);
 173             return false;
 174         }
 175     }
 176
 177     fwrite($f, $data);
 178     fclose($f);
 179
 180     if (!@rename($temp, $filename)) {
 181         @unlink($filename);
 182         @rename($temp, $filename);
 183     }
 184
 185     if(file_exists($filename))
 186     {
 187        return sugar_chmod($filename, 0655);
 188     }
 189
 190     return false;
 191 }
 192
 193
 194
 195 /**
 196  * sugar_file_get_contents
 197  *
 198  * @param $filename - String value of the file to create
 199  * @param $use_include_path - boolean value indicating whether or not to search the the included_path
 200  * @param $context
 201  * @return string|boolean - Returns a file data on success, false otherwise
 202  */
 203 function sugar_file_get_contents($filename, $use_include_path=false, $context=null){
 204         //check to see if the file exists, if not then use touch to create it.
 205         if(!file_exists($filename)){
 206                 sugar_touch($filename);
 207         }
 208
 209         if ( !is_readable($filename) ) {
 210             $GLOBALS['log']->error("File $filename cannot be read");
 211             return false;
 212         }
 213
 214         if(empty($context)) {
 215                 return file_get_contents($filename, $use_include_path);
 216         } else {
 217                 return file_get_contents($filename, $use_include_path, $context);
 218         }
 219 }
 220
 221 /**
 222  * sugar_touch
 223  * Attempts to set the access and modification times of the file named in the filename
 224  * parameter to the value given in time . Note that the access time is always modified,
 225  * regardless of the number of parameters.  If the file does not exist it will be created.
 226  * This method is basically a wrapper to the PHP touch method except that created files
 227  * may be set with the permissions specified in the configuration file (if set).
 228  *
 229  * @param $filename - The name of the file being touched.
 230  * @param $time - The touch time. If time  is not supplied, the current system time is used.
 231  * @param $atime - If present, the access time of the given filename is set to the value of atime
 232  * @return boolean - Returns TRUE on success or FALSE on failure.
 233  *
 234  */
 235 function sugar_touch($filename, $time=null, $atime=null) {
 236
 237    $result = false;
 238
 239    if(!empty($atime) && !empty($time)) {
 240           $result = @touch($filename, $time, $atime);
 241    } else if(!empty($time)) {
 242           $result = @touch($filename, $time);
 243    } else {
 244           $result = @touch($filename);
 245    }
 246
 247    if(!$result) {
 248        $GLOBALS['log']->error("File $filename cannot be touched");
 249        return $result;
 250    }
 251         if(!empty($GLOBALS['sugar_config']['default_permissions']['file_mode'])){
 252                 sugar_chmod($filename, $GLOBALS['sugar_config']['default_permissions']['file_mode']);
 253         }
 254         if(!empty($GLOBALS['sugar_config']['default_permissions']['user'])){
 255                 sugar_chown($filename);
 256         }
 257         if(!empty($GLOBALS['sugar_config']['default_permissions']['group'])){
 258                 sugar_chgrp($filename);
 259         }
 260
 261    return true;
 262 }
 263
 264 /**
 265  * sugar_chmod
 266  * Attempts to change the permission of the specified filename to the mode value specified in the
 267  * default_permissions configuration; otherwise, it will use the mode value.
 268  *
 269  * @param  string    filename - Path to the file
 270  * @param  int $mode The integer value of the permissions mode to set the created directory to
 271  * @return boolean   Returns TRUE on success or FALSE on failure.
 272  */
 273 function sugar_chmod($filename, $mode=null) {
 274     if ( !is_int($mode) )
 275         $mode = (int) $mode;
 276         if(!is_windows()){
 277                 if(!isset($mode)){
 278                         $mode = get_mode('file_mode', $mode);
 279                 }
 280         if(isset($mode) && $mode > 0){
 281                    return @chmod($filename, $mode);
 282                 }else{
 283                 return false;
 284                 }
 285         }
 286         return true;
 287 }
 288
 289 /**
 290  * sugar_chown
 291  * Attempts to change the owner of the file filename to the user specified in the
 292  * default_permissions configuration; otherwise, it will use the user value.
 293  *
 294  * @param filename - Path to the file
 295  * @param user - A user name or number
 296  * @return boolean - Returns TRUE on success or FALSE on failure.
 297  */
 298 function sugar_chown($filename, $user='') {
 299         if(!is_windows()){
 300                 if(strlen($user)){
 301                         return chown($filename, $user);
 302                 }else{
 303                         if(strlen($GLOBALS['sugar_config']['default_permissions']['user'])){
 304                                 $user = $GLOBALS['sugar_config']['default_permissions']['user'];
 305                                 return chown($filename, $user);
 306                         }else{
 307                                 return false;
 308                         }
 309                 }
 310         }
 311         return true;
 312 }
 313
 314 /**
 315  * sugar_chgrp
 316  * Attempts to change the group of the file filename to the group specified in the
 317  * default_permissions configuration; otherwise it will use the group value.
 318  *
 319  * @param filename - Path to the file
 320  * @param group - A group name or number
 321  * @return boolean - Returns TRUE on success or FALSE on failure.
 322  */
 323 function sugar_chgrp($filename, $group='') {
 324         if(!is_windows()){
 325                 if(!empty($group)){
 326                         return chgrp($filename, $group);
 327                 }else{
 328                         if(!empty($GLOBALS['sugar_config']['default_permissions']['group'])){
 329                                 $group = $GLOBALS['sugar_config']['default_permissions']['group'];
 330                                 return chgrp($filename, $group);
 331                         }else{
 332                                 return false;
 333                         }
 334                 }
 335         }
 336         return true;
 337 }
 338
 339 /**
 340  * get_mode
 341  *
 342  * Will check to see if there is a default mode defined in the config file, otherwise return the
 343  * $mode given as input
 344  *
 345  * @param int $mode - the mode being passed by the calling function. This value will be overridden by a value
 346  * defined in the config file.
 347  * @return int - the mode either found in the config file or passed in via the input parameter
 348  */
 349 function get_mode($key = 'dir_mode', $mode=null) {
 350         if ( !is_int($mode) )
 351         $mode = (int) $mode;
 352     if(!class_exists('SugarConfig', true)) {
 353                 require 'include/SugarObjects/SugarConfig.php';
 354         }
 355         if(!is_windows()){
 356                 $conf_inst=SugarConfig::getInstance();
 357                 $mode = $conf_inst->get('default_permissions.'.$key, $mode);
 358         }
 359         return $mode;
 360 }
 361
 362 function sugar_is_dir($path, $mode='r'){
 363                 if(defined('TEMPLATE_URL'))return is_dir($path, $mode);
 364                 return is_dir($path);
 365 }
 366
 367 function sugar_is_file($path, $mode='r'){
 368                 if(defined('TEMPLATE_URL'))return is_file($path, $mode);
 369                 return is_file($path);
 370 }
 371
 372 /**
 373  * Get filename in cache directory
 374  * @api
 375  * @param string $file
 376  */
 377 function sugar_cached($file)
 378 {
 379     static $cdir = null;
 380     if(empty($cdir) && !empty($GLOBALS['sugar_config']['cache_dir'])) {
 381         $cdir = rtrim($GLOBALS['sugar_config']['cache_dir'], '/\\');
 382     }
 383     if(empty($cdir)) {
 384         $cdir = "cache";
 385     }
 386     return "$cdir/$file";
 387 }