169 lines
		
	
	
		
			4.5 KiB
		
	
	
	
		
			PHP
		
	
	
			
		
		
	
	
			169 lines
		
	
	
		
			4.5 KiB
		
	
	
	
		
			PHP
		
	
	
<?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\Mime\Part;
 | 
						|
 | 
						|
use Symfony\Component\Mime\Exception\InvalidArgumentException;
 | 
						|
use Symfony\Component\Mime\Header\Headers;
 | 
						|
 | 
						|
/**
 | 
						|
 * @author Fabien Potencier <fabien@symfony.com>
 | 
						|
 */
 | 
						|
class DataPart extends TextPart
 | 
						|
{
 | 
						|
    /** @internal */
 | 
						|
    protected array $_parent;
 | 
						|
 | 
						|
    private ?string $filename = null;
 | 
						|
    private string $mediaType;
 | 
						|
    private ?string $cid = null;
 | 
						|
 | 
						|
    /**
 | 
						|
     * @param resource|string|File $body Use a File instance to defer loading the file until rendering
 | 
						|
     */
 | 
						|
    public function __construct($body, ?string $filename = null, ?string $contentType = null, ?string $encoding = null)
 | 
						|
    {
 | 
						|
        if ($body instanceof File && !$filename) {
 | 
						|
            $filename = $body->getFilename();
 | 
						|
        }
 | 
						|
 | 
						|
        $contentType ??= $body instanceof File ? $body->getContentType() : 'application/octet-stream';
 | 
						|
        [$this->mediaType, $subtype] = explode('/', $contentType);
 | 
						|
 | 
						|
        parent::__construct($body, null, $subtype, $encoding);
 | 
						|
 | 
						|
        if (null !== $filename) {
 | 
						|
            $this->filename = $filename;
 | 
						|
            $this->setName($filename);
 | 
						|
        }
 | 
						|
        $this->setDisposition('attachment');
 | 
						|
    }
 | 
						|
 | 
						|
    public static function fromPath(string $path, ?string $name = null, ?string $contentType = null): self
 | 
						|
    {
 | 
						|
        return new self(new File($path), $name, $contentType);
 | 
						|
    }
 | 
						|
 | 
						|
    /**
 | 
						|
     * @return $this
 | 
						|
     */
 | 
						|
    public function asInline(): static
 | 
						|
    {
 | 
						|
        return $this->setDisposition('inline');
 | 
						|
    }
 | 
						|
 | 
						|
    /**
 | 
						|
     * @return $this
 | 
						|
     */
 | 
						|
    public function setContentId(string $cid): static
 | 
						|
    {
 | 
						|
        if (!str_contains($cid, '@')) {
 | 
						|
            throw new InvalidArgumentException(sprintf('Invalid cid "%s".', $cid));
 | 
						|
        }
 | 
						|
 | 
						|
        $this->cid = $cid;
 | 
						|
 | 
						|
        return $this;
 | 
						|
    }
 | 
						|
 | 
						|
    public function getContentId(): string
 | 
						|
    {
 | 
						|
        return $this->cid ?: $this->cid = $this->generateContentId();
 | 
						|
    }
 | 
						|
 | 
						|
    public function hasContentId(): bool
 | 
						|
    {
 | 
						|
        return null !== $this->cid;
 | 
						|
    }
 | 
						|
 | 
						|
    public function getMediaType(): string
 | 
						|
    {
 | 
						|
        return $this->mediaType;
 | 
						|
    }
 | 
						|
 | 
						|
    public function getPreparedHeaders(): Headers
 | 
						|
    {
 | 
						|
        $headers = parent::getPreparedHeaders();
 | 
						|
 | 
						|
        if (null !== $this->cid) {
 | 
						|
            $headers->setHeaderBody('Id', 'Content-ID', $this->cid);
 | 
						|
        }
 | 
						|
 | 
						|
        if (null !== $this->filename) {
 | 
						|
            $headers->setHeaderParameter('Content-Disposition', 'filename', $this->filename);
 | 
						|
        }
 | 
						|
 | 
						|
        return $headers;
 | 
						|
    }
 | 
						|
 | 
						|
    public function asDebugString(): string
 | 
						|
    {
 | 
						|
        $str = parent::asDebugString();
 | 
						|
        if (null !== $this->filename) {
 | 
						|
            $str .= ' filename: '.$this->filename;
 | 
						|
        }
 | 
						|
 | 
						|
        return $str;
 | 
						|
    }
 | 
						|
 | 
						|
    public function getFilename(): ?string
 | 
						|
    {
 | 
						|
        return $this->filename;
 | 
						|
    }
 | 
						|
 | 
						|
    public function getContentType(): string
 | 
						|
    {
 | 
						|
        return implode('/', [$this->getMediaType(), $this->getMediaSubtype()]);
 | 
						|
    }
 | 
						|
 | 
						|
    private function generateContentId(): string
 | 
						|
    {
 | 
						|
        return bin2hex(random_bytes(16)).'@symfony';
 | 
						|
    }
 | 
						|
 | 
						|
    public function __sleep(): array
 | 
						|
    {
 | 
						|
        // converts the body to a string
 | 
						|
        parent::__sleep();
 | 
						|
 | 
						|
        $this->_parent = [];
 | 
						|
        foreach (['body', 'charset', 'subtype', 'disposition', 'name', 'encoding'] as $name) {
 | 
						|
            $r = new \ReflectionProperty(TextPart::class, $name);
 | 
						|
            $this->_parent[$name] = $r->getValue($this);
 | 
						|
        }
 | 
						|
        $this->_headers = $this->getHeaders();
 | 
						|
 | 
						|
        return ['_headers', '_parent', 'filename', 'mediaType'];
 | 
						|
    }
 | 
						|
 | 
						|
    /**
 | 
						|
     * @return void
 | 
						|
     */
 | 
						|
    public function __wakeup()
 | 
						|
    {
 | 
						|
        $r = new \ReflectionProperty(AbstractPart::class, 'headers');
 | 
						|
        $r->setValue($this, $this->_headers);
 | 
						|
        unset($this->_headers);
 | 
						|
 | 
						|
        if (!\is_array($this->_parent)) {
 | 
						|
            throw new \BadMethodCallException('Cannot unserialize '.__CLASS__);
 | 
						|
        }
 | 
						|
        foreach (['body', 'charset', 'subtype', 'disposition', 'name', 'encoding'] as $name) {
 | 
						|
            if (null !== $this->_parent[$name] && !\is_string($this->_parent[$name]) && !$this->_parent[$name] instanceof File) {
 | 
						|
                throw new \BadMethodCallException('Cannot unserialize '.__CLASS__);
 | 
						|
            }
 | 
						|
            $r = new \ReflectionProperty(TextPart::class, $name);
 | 
						|
            $r->setValue($this, $this->_parent[$name]);
 | 
						|
        }
 | 
						|
        unset($this->_parent);
 | 
						|
    }
 | 
						|
}
 |