%PDF-
%PDF-
Mini Shell
Mini Shell
<?php
/**
* This file is part of the Nette Framework (https://nette.org)
* Copyright (c) 2004 David Grudl (https://davidgrudl.com)
*/
declare(strict_types=1);
namespace Nette\Mail;
use Nette;
use Nette\Utils\Strings;
/**
* MIME message part.
*
* @property string $body
*/
class MimePart
{
use Nette\SmartObject;
/** encoding */
public const
ENCODING_BASE64 = 'base64',
ENCODING_7BIT = '7bit',
ENCODING_8BIT = '8bit',
ENCODING_QUOTED_PRINTABLE = 'quoted-printable';
/** @internal */
public const EOL = "\r\n";
public const LineLength = 76;
private const
SequenceValue = 1, // value, RFC 2231
SequenceWord = 2; // encoded-word, RFC 2047
/** @var array */
private $headers = [];
/** @var array */
private $parts = [];
/** @var string */
private $body = '';
/**
* Sets a header.
* @param string|array|null $value value or pair email => name
* @return static
*/
public function setHeader(string $name, $value, bool $append = false)
{
if (!$name || preg_match('#[^a-z0-9-]#i', $name)) {
throw new Nette\InvalidArgumentException("Header name must be non-empty alphanumeric string, '$name' given.");
}
if ($value == null) { // intentionally ==
if (!$append) {
unset($this->headers[$name]);
}
} elseif (is_array($value)) { // email
$tmp = &$this->headers[$name];
if (!$append || !is_array($tmp)) {
$tmp = [];
}
foreach ($value as $email => $recipient) {
if ($recipient === null) {
// continue
} elseif (!Strings::checkEncoding($recipient)) {
Nette\Utils\Validators::assert($recipient, 'unicode', "header '$name'");
} elseif (preg_match('#[\r\n]#', $recipient)) {
throw new Nette\InvalidArgumentException('Name must not contain line separator.');
}
Nette\Utils\Validators::assert($email, 'email', "header '$name'");
$tmp[$email] = $recipient;
}
} else {
$value = (string) $value;
if (!Strings::checkEncoding($value)) {
throw new Nette\InvalidArgumentException('Header is not valid UTF-8 string.');
}
$this->headers[$name] = preg_replace('#[\r\n]+#', ' ', $value);
}
return $this;
}
/**
* Returns a header.
* @return mixed
*/
public function getHeader(string $name)
{
return $this->headers[$name] ?? null;
}
/**
* Removes a header.
* @return static
*/
public function clearHeader(string $name)
{
unset($this->headers[$name]);
return $this;
}
/**
* Returns an encoded header.
*/
public function getEncodedHeader(string $name): ?string
{
$offset = strlen($name) + 2; // colon + space
if (!isset($this->headers[$name])) {
return null;
} elseif (is_array($this->headers[$name])) {
$s = '';
foreach ($this->headers[$name] as $email => $name) {
if ($name != null) { // intentionally ==
$s .= self::encodeSequence($name, $offset, self::SequenceWord);
$email = " <$email>";
}
$s .= self::append($email . ',', $offset);
}
return ltrim(substr($s, 0, -1)); // last comma
} elseif (preg_match('#^(\S+; (?:file)?name=)"(.*)"$#D', $this->headers[$name], $m)) { // Content-Disposition
$offset += strlen($m[1]);
return $m[1] . self::encodeSequence(stripslashes($m[2]), $offset, self::SequenceValue);
} else {
return ltrim(self::encodeSequence($this->headers[$name], $offset));
}
}
/**
* Returns all headers.
*/
public function getHeaders(): array
{
return $this->headers;
}
/**
* Sets Content-Type header.
* @return static
*/
public function setContentType(string $contentType, ?string $charset = null)
{
$this->setHeader('Content-Type', $contentType . ($charset ? "; charset=$charset" : ''));
return $this;
}
/**
* Sets Content-Transfer-Encoding header.
* @return static
*/
public function setEncoding(string $encoding)
{
$this->setHeader('Content-Transfer-Encoding', $encoding);
return $this;
}
/**
* Returns Content-Transfer-Encoding header.
*/
public function getEncoding(): string
{
return $this->getHeader('Content-Transfer-Encoding');
}
/**
* Adds or creates new multipart.
*/
public function addPart(?self $part = null): self
{
return $this->parts[] = $part ?? new self;
}
/**
* Sets textual body.
* @return static
*/
public function setBody(string $body)
{
$this->body = $body;
return $this;
}
/**
* Gets textual body.
*/
public function getBody(): string
{
return $this->body;
}
/********************* building ****************d*g**/
/**
* Returns encoded message.
*/
public function getEncodedMessage(): string
{
$output = '';
$boundary = '--------' . Nette\Utils\Random::generate();
foreach ($this->headers as $name => $value) {
$output .= $name . ': ' . $this->getEncodedHeader($name);
if ($this->parts && $name === 'Content-Type') {
$output .= ';' . self::EOL . "\tboundary=\"$boundary\"";
}
$output .= self::EOL;
}
$output .= self::EOL;
$body = $this->body;
if ($body !== '') {
switch ($this->getEncoding()) {
case self::ENCODING_QUOTED_PRINTABLE:
$output .= quoted_printable_encode($body);
break;
case self::ENCODING_BASE64:
$output .= rtrim(chunk_split(base64_encode($body), self::LineLength, self::EOL));
break;
case self::ENCODING_7BIT:
$body = preg_replace('#[\x80-\xFF]+#', '', $body);
// break omitted
case self::ENCODING_8BIT:
$body = str_replace(["\x00", "\r"], '', $body);
$body = str_replace("\n", self::EOL, $body);
$output .= $body;
break;
default:
throw new Nette\InvalidStateException('Unknown encoding.');
}
}
if ($this->parts) {
if (substr($output, -strlen(self::EOL)) !== self::EOL) {
$output .= self::EOL;
}
foreach ($this->parts as $part) {
$output .= '--' . $boundary . self::EOL . $part->getEncodedMessage() . self::EOL;
}
$output .= '--' . $boundary . '--';
}
return $output;
}
/********************* QuotedPrintable helpers ****************d*g**/
/**
* Converts a 8 bit header to a string.
*/
private static function encodeSequence(string $s, int &$offset = 0, ?int $type = null): string
{
if (
(strlen($s) < self::LineLength - 3) && // 3 is tab + quotes
strspn($s, "!\"#$%&\\'()*+,-./0123456789:;<>@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^`abcdefghijklmnopqrstuvwxyz{|}~=? _\r\n\t") === strlen($s)
) {
if ($type && preg_match('#[^ a-zA-Z0-9!\#$%&\'*+/?^_`{|}~-]#', $s)) { // RFC 2822 atext except =
return self::append('"' . addcslashes($s, '"\\') . '"', $offset);
}
return self::append($s, $offset);
}
$o = '';
if ($offset >= 55) { // maximum for iconv_mime_encode
$o = self::EOL . "\t";
$offset = 1;
}
$s = iconv_mime_encode(str_repeat(' ', $old = $offset), $s, [
'scheme' => 'B', // Q is broken
'input-charset' => 'UTF-8',
'output-charset' => 'UTF-8',
]);
$offset = strlen($s) - strrpos($s, "\n");
$s = substr($s, $old + 2); // adds ': '
if ($type === self::SequenceValue) {
$s = '"' . $s . '"';
}
$s = str_replace("\n ", "\n\t", $s);
return $o . $s;
}
private static function append(string $s, int &$offset = 0): string
{
if ($offset + strlen($s) > self::LineLength) {
$offset = 1;
$s = self::EOL . "\t" . $s;
}
$offset += strlen($s);
return $s;
}
}
Zerion Mini Shell 1.0