2026-09-22 16:43:47 +08:00
<? 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\Header\Headers ;
/**
* @author Fabien Potencier <fabien@symfony.com>
*/
abstract class AbstractPart
{
private Headers $headers ;
public function __construct ()
{
$this -> headers = new Headers ();
}
public function getHeaders () : Headers
{
return $this -> headers ;
}
public function getPreparedHeaders () : Headers
{
$headers = clone $this -> headers ;
$headers -> setHeaderBody ( 'Parameterized' , 'Content-Type' , $this -> getMediaType () . '/' . $this -> getMediaSubtype ());
return $headers ;
}
public function toString () : string
{
return $this -> getPreparedHeaders () -> toString () . " \r\n " . $this -> bodyToString ();
}
public function toIterable () : iterable
{
yield $this -> getPreparedHeaders () -> toString ();
yield " \r\n " ;
yield from $this -> bodyToIterable ();
}
public function asDebugString () : string
{
return $this -> getMediaType () . '/' . $this -> getMediaSubtype ();
}
abstract public function bodyToString () : string ;
abstract public function bodyToIterable () : iterable ;
abstract public function getMediaType () : string ;
abstract public function getMediaSubtype () : string ;
public function __serialize () : array
{
2026-10-16 18:13:09 +08:00
if ( ! method_exists ( $this , '__sleep' )) {
return [ 'headers' => $this -> headers ];
}
trigger_deprecation ( 'symfony/mime' , '7.4' , 'Implementing "%s::__sleep()" is deprecated, use "__serialize()" instead.' , get_debug_type ( $this ));
$data = [];
foreach ( $this -> __sleep () as $key ) {
try {
if (( $r = new \ReflectionProperty ( $this , $key )) -> isInitialized ( $this )) {
$data [ $key ] = $r -> getValue ( $this );
}
} catch ( \ReflectionException ) {
$data [ $key ] = $this -> $key ;
}
}
return $data ;
2026-09-22 16:43:47 +08:00
}
public function __unserialize ( array $data ) : void
{
2026-10-16 18:13:09 +08:00
if ( $wakeup = method_exists ( $this , '__wakeup' ) && self :: class === ( new \ReflectionMethod ( $this , '__unserialize' )) -> class ) {
trigger_deprecation ( 'symfony/mime' , '7.4' , 'Implementing "%s::__wakeup()" is deprecated, use "__unserialize()" instead.' , get_debug_type ( $this ));
}
if ([ 'headers' ] === array_keys ( $data )) {
$this -> headers = $data [ 'headers' ];
if ( $wakeup ) {
$this -> __wakeup ();
}
return ;
}
trigger_deprecation ( 'symfony/mime' , '7.4' , 'Passing more than just key "headers" to "%s::__unserialize()" is deprecated, populate properties in "%s::__unserialize()" instead.' , self :: class , get_debug_type ( $this ));
\Closure :: bind ( function ( $data ) use ( $wakeup ) {
foreach ( $data as $key => $value ) {
$this -> {( " \0 " === $key [ 0 ] ?? '' ) ? substr ( $key , 1 + strrpos ( $key , " \0 " )) : $key } = $value ;
}
if ( $wakeup ) {
$this -> __wakeup ();
}
}, $this , static :: class )( $data );
2026-09-22 16:43:47 +08:00
}
}