vendor/symfony/http-foundation/File/MimeType/ExtensionGuesser.php line 16

Open in your IDE?
  1. <?php
  3. /*
  4.  * This file is part of the Symfony package.
  5.  *
  6.  * (c) Fabien Potencier <fabien@symfony.com>
  7.  *
  8.  * For the full copyright and license information, please view the LICENSE
  9.  * file that was distributed with this source code.
  10.  */
  12. namespace Symfony\Component\HttpFoundation\File\MimeType;
  14. use Symfony\Component\Mime\MimeTypes;
  16. @trigger_error(sprintf('The "%s" class is deprecated since Symfony 4.3, use "%s" instead.', ExtensionGuesser::class, MimeTypes::class), \E_USER_DEPRECATED);
  18. /**
  19.  * A singleton mime type to file extension guesser.
  20.  *
  21.  * A default guesser is provided.
  22.  * You can register custom guessers by calling the register()
  23.  * method on the singleton instance:
  24.  *
  25.  *     $guesser = ExtensionGuesser::getInstance();
  26.  *     $guesser->register(new MyCustomExtensionGuesser());
  27.  *
  28.  * The last registered guesser is preferred over previously registered ones.
  29.  *
  30.  * @deprecated since Symfony 4.3, use {@link MimeTypes} instead
  31.  */
  32. class ExtensionGuesser implements ExtensionGuesserInterface
  33. {
  34.     /**
  35.      * The singleton instance.
  36.      *
  37.      * @var ExtensionGuesser
  38.      */
  39.     private static $instance = null;
  41.     /**
  42.      * All registered ExtensionGuesserInterface instances.
  43.      *
  44.      * @var array
  45.      */
  46.     protected $guessers = [];
  48.     /**
  49.      * Returns the singleton instance.
  50.      *
  51.      * @return self
  52.      */
  53.     public static function getInstance()
  54.     {
  55.         if (null === self::$instance) {
  56.             self::$instance = new self();
  57.         }
  59.         return self::$instance;
  60.     }
  62.     /**
  63.      * Registers all natively provided extension guessers.
  64.      */
  65.     private function __construct()
  66.     {
  67.         $this->register(new MimeTypeExtensionGuesser());
  68.     }
  70.     /**
  71.      * Registers a new extension guesser.
  72.      *
  73.      * When guessing, this guesser is preferred over previously registered ones.
  74.      */
  75.     public function register(ExtensionGuesserInterface $guesser)
  76.     {
  77.         array_unshift($this->guessers, $guesser);
  78.     }
  80.     /**
  81.      * Tries to guess the extension.
  82.      *
  83.      * The mime type is passed to each registered mime type guesser in reverse order
  84.      * of their registration (last registered is queried first). Once a guesser
  85.      * returns a value that is not NULL, this method terminates and returns the
  86.      * value.
  87.      *
  88.      * @param string $mimeType The mime type
  89.      *
  90.      * @return string The guessed extension or NULL, if none could be guessed
  91.      */
  92.     public function guess($mimeType)
  93.     {
  94.         foreach ($this->guessers as $guesser) {
  95.             if (null !== $extension = $guesser->guess($mimeType)) {
  96.                 return $extension;
  97.             }
  98.         }
  100.         return null;
  101.     }
  102. }