Classes List

Symfony\Component\HttpFoundation\File\File

 1 
 2 
 3 
 4 
 5 
 6 
 7 
 8 
 9 
 10 
 11 
 12 
 13 
 14 
 15 
 16 
 17 
 18 
 19 
 20 
 21 
 22 
 23 
 24 
 25 
 26 
 27 
 28 
 29 
 30 
 31 
 32 
 33 
 34 
 35 
 36 
 37 
 38 
 39 
 40 
 41 
 42 
 43 
 44 
 45 
 46 
 47 
 48 
 49 
 50 
 51 
 52 
 53 
 54 
 55 
 56 
 57 
 58 
 59 
 60 
 61 
 62 
 63 
 64 
 65 
 66 
 67 
 68 
 69 
 70 
 71 
 72 
 73 
 74 
 75 
 76 
 77 
 78 
 79 
 80 
 81 
 82 
 83 
 84 
 85 
 86 
 87 
 88 
 89 
 90 
 91 
 92 
 93 
 94 
 95 
 96 
 97 
 98 
 99 
 100 
 101 
 102 
 103 
 104 
 105 
 106 
 107 
 108 
 109 
 110 
 111 
 112 
 113 
 114 
 115 
 116 
 117 
 118 
 119 
 120 
 121 
 122 
 123 
 124 
 125 
 126 
 127 
 128 
 129 
 130 
 131 
 132 
 133 
 134 
 135 
 136 
 137 
 138 
 139 
<?php

/* * This file is part of the Symfony package. * * (c) Fabien Potencier <fabien@symfony.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */


namespace Symfony\Component\HttpFoundation\File;

use Symfony\Component\HttpFoundation\File\Exception\FileException;
use Symfony\Component\HttpFoundation\File\Exception\FileNotFoundException;
use Symfony\Component\HttpFoundation\File\MimeType\MimeTypeGuesser;
use Symfony\Component\HttpFoundation\File\MimeType\ExtensionGuesser;

/** * A file in the file system. * * @author Bernhard Schussek <bschussek@gmail.com> */
class File extends \SplFileInfo
{
    /** * Constructs a new file from the given path. * * @param string $path The path to the file * @param bool $checkPath Whether to check the path or not * * @throws FileNotFoundException If the given path is not a file */
    public function __construct($path$checkPath = true)
    {
        if ($checkPath && !is_file($path)) {
            throw new FileNotFoundException($path);
        }

        parent::__construct($path);
    }

    /** * Returns the extension based on the mime type. * * If the mime type is unknown, returns null. * * This method uses the mime type as guessed by getMimeType() * to guess the file extension. * * @return string|null The guessed extension or null if it cannot be guessed * * @see ExtensionGuesser * @see getMimeType() */
    public function guessExtension()
    {
        $type = $this->getMimeType();
        $guesser = ExtensionGuesser::getInstance();

        return $guesser->guess($type);
    }

    /** * Returns the mime type of the file. * * The mime type is guessed using a MimeTypeGuesser instance, which uses finfo(), * mime_content_type() and the system binary "file" (in this order), depending on * which of those are available. * * @return string|null The guessed mime type (e.g. "application/pdf") * * @see MimeTypeGuesser */
    public function getMimeType()
    {
        $guesser = MimeTypeGuesser::getInstance();

        return $guesser->guess($this->getPathname());
    }

    /** * Moves the file to a new location. * * @param string $directory The destination folder * @param string $name The new file name * * @return self A File object representing the new file * * @throws FileException if the target file could not be created */
    public function move($directory$name = null)
    {
        $target = $this->getTargetFile($directory$name);

        set_error_handler(function ($type$msguse (&$error) { $error = $msg; });
        $renamed = rename($this->getPathname(), $target);
        restore_error_handler();
        if (!$renamed) {
            throw new FileException(sprintf('Could not move the file "%s" to "%s" (%s)'$this->getPathname(), $targetstrip_tags($error)));
        }

        @chmod($target0666 & ~umask());

        return $target;
    }

    protected function getTargetFile($directory$name = null)
    {
        if (!is_dir($directory)) {
            if (false === @mkdir($directory0777true&& !is_dir($directory)) {
                throw new FileException(sprintf('Unable to create the "%s" directory'$directory));
            }
        } elseif (!is_writable($directory)) {
            throw new FileException(sprintf('Unable to write in the "%s" directory'$directory));
        }

        $target = rtrim($directory'/\\').DIRECTORY_SEPARATOR.(null === $name ? $this->getBasename() : $this->getName($name));

        return new self($targetfalse);
    }

    /** * Returns locale independent base name of the given path. * * @param string $name The new file name * * @return string containing */
    protected function getName($name)
    {
        $originalName = str_replace('\\''/'$name);
        $pos = strrpos($originalName'/');
        $originalName = false === $pos ? $originalName : substr($originalName$pos + 1);

        return $originalName;
    }
}