src/Network/Entity/MimeType.php

   1 <?php
   2 /**
   3  * @copyright Copyright (C) 2010-2024, the Friendica project
   4  *
   5  * @license GNU AGPL version 3 or any later version
   6  *
   7  * This program is free software: you can redistribute it and/or modify
   8  * it under the terms of the GNU Affero General Public License as
   9  * published by the Free Software Foundation, either version 3 of the
  10  * License, or (at your option) any later version.
  11  *
  12  * This program is distributed in the hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15  * GNU Affero General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU Affero General Public License
  18  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  19  *
  20  */
  21
  22 namespace Friendica\Network\Entity;
  23
  24 use Friendica\BaseEntity;
  25
  26 /**
  27  * Implementation of the Content-Type header value from the MIME type RFC
  28  *
  29  * @see https://www.rfc-editor.org/rfc/rfc2045#section-5
  30  *
  31  * @property-read string $type
  32  * @property-read string $subtype
  33  * @property-read array $parameters
  34  */
  35 class MimeType extends BaseEntity
  36 {
  37         /** @var string */
  38         protected $type;
  39         /** @var string */
  40         protected $subtype;
  41         /** @var array */
  42         protected $parameters;
  43
  44         public function __construct(string $type, string $subtype, array $parameters = [])
  45         {
  46                 $this->type = $type;
  47                 $this->subtype = $subtype;
  48                 $this->parameters = $parameters;
  49         }
  50
  51         public function __toString(): string
  52         {
  53                 $parameters = array_map(function (string $attribute, string $value) {
  54                         if (
  55                                 strpos($value, '"') !== false ||
  56                                 strpos($value, '\\') !== false ||
  57                                 strpos($value, "\r") !== false
  58                         ) {
  59                                 $value = '"' . str_replace(['\\', '"', "\r"], ['\\\\', '\\"', "\\\r"], $value) . '"';
  60                         }
  61
  62                         return '; ' . $attribute . '=' . $value;
  63                 }, array_keys($this->parameters), array_values($this->parameters));
  64
  65                 return $this->type . '/' .
  66                         $this->subtype .
  67                         implode('', $parameters);
  68         }
  69 }