Source for file jFile.class.php

Documentation is available at jFile.class.php

  1. <?php
  2. /**
  3. @package    jelix
  4. @subpackage utils
  5. @author Laurent Jouanneau
  6. @contributor Christophe Thiriot
  7. @contributor Bastien Jaillot
  8. @contributor Loic Mathaud
  9. @contributor Olivier Demah (#733)
  10. @contributor Cedric (fix bug ticket 56)
  11. @contributor Julien Issler
  12. @copyright   2005-2012 Laurent Jouanneau, 2006 Christophe Thiriot, 2006 Loic Mathaud, 2008 Bastien Jaillot, 2008 Olivier Demah, 2009-2010 Julien Issler
  13. @link        http://www.jelix.org
  14. @licence  http://www.gnu.org/licenses/lgpl.html GNU Lesser General Public Licence, see LICENCE file
  15. */
  16.  
  17.  
  18. /**
  19.  * A class helper to read or create files
  20.  * @package    jelix
  21.  * @subpackage utils
  22.  */
  23. class jFile {
  24.     /**
  25.     * Reads the content of a file.
  26.     * @param string $filename the filename we're gonna read
  27.     * @return string the content of the file. false if cannot read the file
  28.     */
  29.     public static function read ($filename){
  30.         return @file_get_contents ($filenamefalse);
  31.     }
  32.  
  33.     /**
  34.     * Write a file to the disk.
  35.     * This function is heavily based on the way smarty process its own files.
  36.     * Is using a temporary file and then rename the file. We guess the file system will be smarter than us, avoiding a writing / reading
  37.     *  while renaming the file.
  38.     * This method comes from CopixFile class of Copix framework
  39.     * @author     GĂ©rald Croes
  40.     * @copyright  2001-2005 CopixTeam
  41.     * @link http://www.copix.org
  42.     */
  43.     public static function write ($file$data){
  44.         $_dirname dirname($file);
  45.  
  46.         //asking to create the directory structure if needed.
  47.         self::createDir ($_dirname);
  48.  
  49.         if(!@is_writable($_dirname)) {
  50.             // cache_dir not writable, see if it exists
  51.             if(!@is_dir($_dirname)) {
  52.                 throw new jException('jelix~errors.file.directory.notexists'array ($_dirname));
  53.             }
  54.             throw new jException('jelix~errors.file.directory.notwritable'array ($file$_dirname));
  55.         }
  56.  
  57.         // write to tmp file, then rename it to avoid
  58.         // file locking race condition
  59.         $_tmp_file tempnam($_dirname'wrt');
  60.  
  61.         if (!($fd @fopen($_tmp_file'wb'))) {
  62.             $_tmp_file $_dirname '/' uniqid('wrt');
  63.             if (!($fd @fopen($_tmp_file'wb'))) {
  64.                 throw new jException('jelix~errors.file.write.error'array ($file$_tmp_file));
  65.             }
  66.         }
  67.  
  68.         fwrite($fd$data);
  69.         fclose($fd);
  70.  
  71.         // Delete the file if it allready exists (this is needed on Win,
  72.         // because it cannot overwrite files with rename()
  73.         if (jApp::config()->isWindows && file_exists($file)) {
  74.             unlink($file);
  75.         }
  76.         rename($_tmp_file$file);
  77.         @chmod($file,  0664);
  78.  
  79.         return true;
  80.     }
  81.  
  82.     /**
  83.     * create a directory
  84.     * It creates also all necessary parent directory
  85.     * @param string $dir the path of the directory
  86.     */
  87.     public static function createDir ($dir){
  88.         // recursive feature on mkdir() is broken with PHP 5.0.4 for Windows
  89.         // so should do own recursion
  90.         if (!file_exists($dir)) {
  91.             self::createDir(dirname($dir));
  92.             mkdir($dir0775);
  93.         }
  94.     }
  95.  
  96.     /**
  97.      * Recursive function deleting a directory
  98.      *
  99.      * @param string $path The path of the directory to remove recursively
  100.      * @param boolean $deleteParent If the path must be deleted too
  101.      * @param array $except  filenames and suffix of filename, for files to NOT delete
  102.      * @since 1.0b1
  103.      * @author Loic Mathaud
  104.      * @return boolean true if all the content has been removed
  105.      */
  106.     public static function removeDir($path$deleteParent=true$except=array()) {
  107.  
  108.         if($path == '' || $path == '/' || $path == DIRECTORY_SEPARATOR)
  109.             throw new jException('jelix~errors.file.directory.cannot.remove.fs.root')//see ticket #840
  110.  
  111.         if (!file_exists($path))
  112.             return true;
  113.  
  114.         $allIsDeleted true;
  115.  
  116.         $dir new DirectoryIterator($path);
  117.         foreach ($dir as $dirContent{
  118.             if (count($except)) {
  119.                 // test if the basename matches one of patterns
  120.                 $exception false;
  121.                 foreach($except as $pattern{
  122.                     if ($pattern[0== '*'// for pattern like *.foo
  123.                         if ($dirContent->getBasename(!= $dirContent->getBasename(substr($pattern1))) {
  124.                             $allIsDeleted false;
  125.                             $exception true;
  126.                             break;
  127.                         }
  128.                     }
  129.                     else if ($pattern == $dirContent->getBasename()) {
  130.                         $allIsDeleted false;
  131.                         $exception true;
  132.                         break;
  133.                     }
  134.                 }
  135.                 if ($exception)
  136.                     continue;
  137.             }
  138.             // file deletion
  139.             if ($dirContent->isFile(|| $dirContent->isLink()) {
  140.                     unlink($dirContent->getPathName());
  141.             else {
  142.                 // recursive directory deletion
  143.                 if (!$dirContent->isDot(&& $dirContent->isDir()) {
  144.                     $removed self::removeDir($dirContent->getPathName()true$except);
  145.                     if (!$removed)
  146.                         $allIsDeleted false;
  147.                 }
  148.             }
  149.         }
  150.         unset($dir)// see bug #733
  151.         unset($dirContent);
  152.  
  153.         // removes the parent directory
  154.         if ($deleteParent && $allIsDeleted{
  155.             rmdir($path);
  156.         }
  157.         return $allIsDeleted;
  158.     }
  159.  
  160.     /**
  161.      * get the MIME Type of a file
  162.      *
  163.      * @param string $file The full path of the file
  164.      * @return string the MIME type of the file
  165.      * @since 1.1.6
  166.      */
  167.     public static function getMimeType($file){
  168.         $finfo finfo_open(FILEINFO_MIME_TYPE);
  169.         $type finfo_file($finfo$file);
  170.         finfo_close($finfo);
  171.         return $type;
  172.     }
  173.  
  174.     /**
  175.      * get the MIME Type of a file, only with its name
  176.      *
  177.      * @param string $fileName the file name
  178.      * @return string the MIME type of the file
  179.      * @since 1.1.10
  180.      */
  181.     public static function getMimeTypeFromFilename($fileName){
  182.         $ext strtolower(pathinfo($fileNamePATHINFO_EXTENSION));
  183.         if (array_key_exists($extself::$mimeTypes)) {
  184.             return self::$mimeTypes[$ext];
  185.         }
  186.         else
  187.             return 'application/octet-stream';
  188.     }
  189.  
  190.     protected static $mimeTypes array(
  191.  
  192.         'txt' => 'text/plain',
  193.         'htm' => 'text/html',
  194.         'html' => 'text/html',
  195.         'xhtml' => 'application/xhtml+xml',
  196.         'xht' => 'application/xhtml+xml',
  197.         'php' => 'text/html',
  198.         'css' => 'text/css',
  199.         'js' => 'application/javascript',
  200.         'json' => 'application/json',
  201.         'xml' => 'application/xml',
  202.         'xslt' => 'application/xslt+xml',
  203.         'xsl' => 'application/xml',
  204.         'dtd' => 'application/xml-dtd',
  205.         'atom'=>'application/atom+xml',
  206.         'mathml'=>'application/mathml+xml',
  207.         'rdf'=>'application/rdf+xml',
  208.         'smi'=>'application/smil',
  209.         'smil'=>'application/smil',
  210.         'vxml'=>'application/voicexml+xml',
  211.         'latex'=>'application/x-latex',
  212.         'tcl'=>'application/x-tcl',
  213.         'tex'=>'application/x-tex',
  214.         'texinfo'=>'application/x-texinfo',
  215.         'wrl'=>'model/vrml',
  216.         'wrml'=>'model/vrml',
  217.         'ics'=>'text/calendar',
  218.         'ifb'=>'text/calendar',
  219.         'sgml'=>'text/sgml',
  220.         'htc'=>'text/x-component',
  221.  
  222.         // images
  223.         'png' => 'image/png',
  224.         'jpe' => 'image/jpeg',
  225.         'jpeg' => 'image/jpeg',
  226.         'jpg' => 'image/jpeg',
  227.         'gif' => 'image/gif',
  228.         'bmp' => 'image/bmp',
  229.         'ico' => 'image/x-icon',
  230.         'tiff' => 'image/tiff',
  231.         'tif' => 'image/tiff',
  232.         'svg' => 'image/svg+xml',
  233.         'svgz' => 'image/svg+xml',
  234.         'djvu' => 'image/vnd.djvu',
  235.         'djv'  => 'image/vnd.djvu',
  236.  
  237.         // archives
  238.         'zip' => 'application/zip',
  239.         'rar' => 'application/x-rar-compressed',
  240.         'exe' => 'application/x-msdownload',
  241.         'msi' => 'application/x-msdownload',
  242.         'cab' => 'application/vnd.ms-cab-compressed',
  243.         'tar' => 'application/x-tar',
  244.         'gz'  => 'application/x-gzip',
  245.         'tgz'  => 'application/x-gzip',
  246.  
  247.         // audio/video
  248.         'mp2' => 'audio/mpeg',
  249.         'mp3' => 'audio/mpeg',
  250.         'qt' => 'video/quicktime',
  251.         'mov' => 'video/quicktime',
  252.         'mpeg' => 'video/mpeg',
  253.         'mpg' => 'video/mpeg',
  254.         'mpe' => 'video/mpeg',
  255.         'wav' => 'audio/wav',
  256.         'aiff' => 'audio/aiff',
  257.         'aif' => 'audio/aiff',
  258.         'avi' => 'video/msvideo',
  259.         'wmv' => 'video/x-ms-wmv',
  260.         'ogg' => 'application/ogg',
  261.         'flv' => 'video/x-flv',
  262.         'dvi' => 'application/x-dvi',
  263.         'au'=> 'audio/basic',
  264.         'snd'=> 'audio/basic',
  265.         'mid' => 'audio/midi',
  266.         'midi' => 'audio/midi',
  267.         'm3u' => 'audio/x-mpegurl',
  268.         'm4u' => 'video/vnd.mpegurl',
  269.         'ram' => 'audio/x-pn-realaudio',
  270.         'ra' => 'audio/x-pn-realaudio',
  271.         'rm' => 'application/vnd.rn-realmedia',
  272.  
  273.         // adobe
  274.         'pdf' => 'application/pdf',
  275.         'psd' => 'image/vnd.adobe.photoshop',
  276.         'ai' => 'application/postscript',
  277.         'eps' => 'application/postscript',
  278.         'ps' => 'application/postscript',
  279.         'swf' => 'application/x-shockwave-flash',
  280.  
  281.         // ms office
  282.         'doc' => 'application/msword',
  283.         'docx' => 'application/msword',
  284.         'rtf' => 'application/rtf',
  285.         'xls' => 'application/vnd.ms-excel',
  286.         'xlm' => 'application/vnd.ms-excel',
  287.         'xla' => 'application/vnd.ms-excel',
  288.         'xld' => 'application/vnd.ms-excel',
  289.         'xlt' => 'application/vnd.ms-excel',
  290.         'xlc' => 'application/vnd.ms-excel',
  291.         'xlw' => 'application/vnd.ms-excel',
  292.         'xll' => 'application/vnd.ms-excel',
  293.         'ppt' => 'application/vnd.ms-powerpoint',
  294.         'pps' => 'application/vnd.ms-powerpoint',
  295.  
  296.         // open office
  297.         'odt' => 'application/vnd.oasis.opendocument.text',
  298.         'ods' => 'application/vnd.oasis.opendocument.spreadsheet',
  299.     );
  300. }

Documentation generated on Wed, 04 Jan 2017 22:54:07 +0100 by phpDocumentor 1.4.3