Spec-Zone.ru › CakePHP 2.8

Класс EmailComponent

EmailComponent

Этот компонент используется для обработки Internet Message Format, основанного на стандарте, описанном в http://www.rfc-editor.org/rfc/rfc2822.txt

Объект
Extended by Компонент
Extended by EmailComponent
Пакет: Cake\Controller\Component
Ссылка: http://book.cakephp.org/2.0/en/core-libraries/components/email.html
Ссылка: http://book.cakephp.org/2.0/en/core-utility-libraries/email.html
Устаревший: 3.0.0 Будет удалён в 3.0. Используйте Network/CakeEmail вместо этого
Авторские права: Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)
Лицензия: MIT Лицензия
Расположение: Cake/Controller/Component/EmailComponent.php

Резюме свойств

  • $_controller protected
    Controller
    Ссылка на контроллер
  • $additionalParams public
    string
    Список дополнительных заголовков
  • $attachments public
    array
    Список файлов, которые должны быть прикреплены к письму.
  • $bcc public
    array
    Скрытая копия
  • $cc public
    array
    Копия
  • $charset public
    string
    Кодировка символов для отправляемого письма
  • $date public
    string

    Дата, которая должна быть указана в заголовке Date. Должна соответствовать стандарту RFC2822. Оставьте null, чтобы использовать текущую дату.

  • $delivery public
    string
    Метод для отправки письма
  • $filePaths public
    array
    Список путей для поиска вложений, если путь не абсолютный
  • $from public
    string
    Адрес отправителя
  • $headers public
    array

    Ассоциативный массив пользовательских заголовков. Ключи будут иметь префикс 'X-' в соответствии с RFC2822 Раздел 4.7.5

  • $htmlMessage public
    string
    Содержит отрендеренное HTML сообщение, если оно было отправлено.
  • $layout public
    string
    Макет для представления
  • $lineFeed public
    string

    Символ(ы) перевода строки, используемые при отправке с помощью функции mail(). По умолчанию используется PHP_EOL. RFC2822 требует CRLF, но некоторые агенты передачи почты Unix автоматически заменяют LF на CRLF (что приводит к удваиванию CR, если используется CRLF).

  • $messageId public
    mixed

    Генерировать заголовок Message-ID для электронного письма. True - генерировать, False - позволить sendmail (или подобному) обрабатывать его, или строка - полностью переопределить Message-ID.

  • $readReceipt public
    string
    Электронное письмо для подтверждения прочтения
  • $replyTo public
    string
    Электронное письмо, на которое получатель должен ответить
  • $return public
    string

    Электронное письмо, которое будет использоваться в случае ошибок, таких как: - Отдалённый почтовый сервер недоступен - Отдалённый пользователь превысил свой лимит - Неизвестный пользователь

  • $sendAs public
    string
    Формат для отправки письма
  • $smtpOptions public
    array
    Список параметров для метода smtp
  • $subject public
    string
    Тема письма
  • $template public
    string
    Шаблон для представления
  • $textMessage public
    string
    Содержит отрендеренное текстовое сообщение, если оно было отправлено.
  • $to public
    string
    Получатель письма
  • $xMailer public
    string
    Как EmailComponent должен идентифицировать себя

Унаследованные свойства

  • _Collection, _componentMap, components, settings

Резюме методов

  • __construct() public
    Конструктор
  • _findFiles() protected
    Поиск указанного вложения в списке путей к файлам
  • _formatAddresses() protected
    Форматирование адресов в массив с адресом электронной почты в качестве ключа и псевдонимом в качестве значения
  • _formatAttachFiles() protected
    Форматирование массива вложений
  • _strip() protected

    Удаление определённых элементов (таких как bcc:, to:, %0a) из заданного значения. Помогает предотвратить инъекцию/манипуляцию заголовков с содержимым пользователя.

  • initialize() public
    Инициализация компонента
  • reset() public
    Сброс всех внутренних переменных EmailComponent, чтобы отправить новое письмо.
  • send() public
    Отправка письма с использованием указанного содержимого, шаблона и макета

Подробное описание методов

__construct()source public

__construct( ComponentCollection $collection , array $settings array() )

Конструктор

Параметры

ComponentCollection $collection
Коллекция компонентов, которую может использовать этот компонент для ленивой загрузки своих компонентов
массив $settings необязательно array()
Массив параметров конфигурации.

Переопределяет

Component::__construct()

_findFiles()source protected

_findFiles( string $attachment )

Поиск указанного вложения в списке путей к файлам

Параметры

строка $attachment
Имя файла вложения для поиска

Возвращает

string|null
Путь к найденному файлу

_formatAddresses()source protected

_formatAddresses( array $addresses )

Форматирование адресов в массив с адресом электронной почты в качестве ключа и псевдонимом в качестве значения

Параметры

массив $addresses
Адрес для форматирования.

Возвращает

массив

_formatAttachFiles()source protected

_formatAttachFiles( )

Форматирование массива вложений

Возвращает

массив
END_OF_DOCUMENT_MARKER

_strip()source protected

_strip( string $value , boolean $message false )

Удаляет определенные элементы (например, bcc:, to:, %0a) из заданного значения. Помогает предотвратить инъекцию и манипулирование заголовков в пользовательском контенте.

Параметры

строка $value
Значение для удаления
логическое значение $message необязательно false
Устанавливается в true, чтобы указать основной контент сообщения

Возвращает

строку
Очищенное значение

initialize()source public

initialize( Controller $controller )

Инициализировать компонент

Параметры

Controller $controller
Инициализируемый контроллер

Переопределяет

Component::initialize()

reset()source public

reset( )

Сбрасывает все внутренние переменные EmailComponent, чтобы можно было отправить новое электронное письмо.

send()source public

send( string|array $content null , string $template null , string $layout null )

Отправка электронного письма с указанным содержимым, шаблоном и макетом

Параметры

строка|массив $content необязательно null

Либо массив текстовых строк, либо строка с содержимым. Если вы используете шаблон, эта переменная будет передана в шаблон как $content

строка $template необязательно null
Шаблон для использования при отправке электронного письма
строка $layout необязательно null
Макет для использования для обрамления тела электронного письма

Возвращает

логическое значение
Успех

Наследуемые методы из Component

__get()source public

__get( string $name )

Магический метод для ленивой загрузки $components.

Параметры

строка $name
Имя компонента для получения.

Возвращает

смешанное значение
Объект компонента или null.

beforeRedirect()source public

beforeRedirect( Controller $controller , string|array $url , integer $status null , boolean $exit true )

Вызывается перед Controller::redirect(). Позволяет заменить URL, на который будет осуществлён редирект, на новый URL. Возвращаемое значение этого метода может быть массивом или строкой.

Если возвращаемое значение является массивом и содержит ключ 'url', вы также можете указать следующие:

  • status Код состояния для редиректа
  • exit Необходимо ли завершить выполнение после редиректа.

Если ваше значение — строка или массив, который не содержит ключ 'url', оно будет использоваться в качестве нового URL для редиректа.

Параметры

Controller $controller
Контроллер с компонентами для beforeRedirect
строка|массив $url
Либо строка, либо массив URL, на который осуществляется редирект.
целое число $status необязательно null
Код состояния редиректа
логическое значение $exit необязательно true
Необходимо ли завершить сценарий.

Возвращает

массив|null
Либо массив, либо null.

Ссылка

http://book.cakephp.org/2.0/ru/controllers/components.html#Component::beforeRedirect

beforeRender()source public

beforeRender( Controller $controller )

Вызывается перед Controller::beforeRender(), перед загрузкой класса представления и перед Controller::render()

Параметры

Controller $controller
Контроллер с компонентами для beforeRender

Ссылка

http://book.cakephp.org/2.0/ru/controllers/components.html#Component::beforeRender

shutdown()source public

shutdown( Controller $controller )

Вызывается после Controller::render() и перед выводом данных в браузер.

Параметры

Controller $controller
Контроллер с компонентами для shutdown

Ссылка

http://book.cakephp.org/2.0/ru/controllers/components.html#Component::shutdown

startup()source public

startup( Controller $controller )

Вызывается после Controller::beforeFilter() и перед действием контроллера

Параметры

Controller $controller
Контроллер с компонентами для startup

Ссылка

http://book.cakephp.org/2.0/ru/controllers/components.html#Component::startup

Наследуемые методы из Object

_mergeVars()source protected

_mergeVars( array $properties , string $class , boolean $normalize true )

Объединяет свойства $property текущего объекта со свойствами в определении $class. Значение текущего объекта для свойства будет объединено поверх значения $class's.

Это обеспечивает некоторую DRY магию, предоставляемую CakePHP. Если вы хотите ее отключить, переопределите этот метод как пустую функцию.

Параметры

массив $properties
Имя свойств для объединения.
строка $class
Класс для объединения свойств с.
логическое значение $normalize необязательно true
Установите в true, чтобы выполнить свойства через Hash::normalize() перед объединением.

_set()source protected

_set( array $properties array() )

Позволяет задавать несколько свойств объекта в одной строке кода. Будет устанавливать только свойства, которые являются частью объявления класса.

Параметры

массив $properties необязательно array()
Ассоциативный массив, содержащий свойства и соответствующие значения.

_stop()source protected

_stop( integer|string $status 0 )

Останавливает выполнение текущего сценария. Обёртка exit(), что упрощает тестирование.

Параметры

целое число|строка $status необязательно 0
см. http://php.net/exit для значений

dispatchMethod()source public

dispatchMethod( string $method , array $params array() )

Вызывает метод этого объекта с заданными параметрами. Предоставляет объектно-ориентированную оболочку для call_user_func_array

Параметры

строка $method
Имя вызываемого метода
массив $params необязательно array()
Список параметров для использования при вызове $method

Возвращает

смешанное значение
Возвращает результат вызова метода

log()source public

log( string $msg , integer $type LOG_ERR , null|string|array $scope null )

Удобный метод для записи сообщения в CakeLog. Подробнее о записи в журналы см. CakeLog::write().

Параметры

строка $msg
Сообщение для записи в журнал
целое число $type необязательно LOG_ERR
Константа типа ошибки. Определена в app/Config/core.php.
null|строка|массив $scope необязательно null

Область(и), в которой создается сообщение журнала. Подробнее о областях ведения журнала см. CakeLog::config().

Возвращает

логическое значение
Успех записи в журнал
END_OF_DOCUMENT_MARKER

requestAction()source public

requestAction( string|array $url , array $extra array() )

Вызывает метод контроллера из любой точки. Может использоваться для связи контроллеров или интеграции плагинов с основным приложением. requestAction можно использовать для возврата рендеренных представлений или получения возвращаемого значения из действий контроллера.

Внутри этот метод использует Router::reverse() для преобразования параметра $url в строковый URL. Вы должны использовать форматы URL, совместимые с Router::reverse().

Передача данных POST и GET

Данные POST и GET можно моделировать в requestAction. Используйте $extra['url'] для данных GET. Параметр $extra['data'] позволяет моделировать данные POST.

Параметры

строка|массив $url

URL, заданный строкой или массивом. В отличие от других массивов URL в CakePHP, этот URL не будет автоматически обрабатывать передаваемые и именованные аргументы в параметре $url.

массив $extra необязательно массив()

Если массив включает ключ "return", он устанавливает AutoRender в значение true. Также может использоваться для отправки данных GET/POST, а также именованных/передаваемых аргументов.

Возвращаемое значение

смешанное

Булево значение true или false при успехе/неудаче или содержимое рендеренного действия, если в $extra задан ключ 'return'.


toString()source public

toString( )

Преобразование объекта в строку. Каждый класс может переопределить этот метод по необходимости.

Возвращаемое значение

строка
Название этого класса

Подробное описание свойств

$_controllersource

protected Controller

Ссылка на контроллер

null

$additionalParamssource

public строка

Список дополнительных заголовков

Эти значения НЕ будут использованы, если вы используете режим safemode и функцию mail()

null

$attachmentssource

public массив

Список файлов, которые должны быть прикреплены к электронному письму.

Пути могут быть как абсолютными, так и относительными

array()

$bccsource

public массив

Скрытая копия

Список адресов электронной почты, которые должны получить копию письма. Получатель НЕ увидит этот список.

array()

$ccsource

public массив

Копия

Список адресов электронной почты, которые должны получить копию письма. Получатель увидит этот список.

array()

$charsetsource

public строка

Кодировка символов письма

'utf-8'

$datesource

public строка

Дата, которая должна быть включена в заголовок Date. Должна соответствовать стандарту RFC2822. Если оставить значение null, будет использоваться сегодняшняя дата.

null

$deliverysource

public строка

Метод, который должен использоваться для отправки письма

Поддерживаемые методы: - mail - smtp - debug

'mail'

$filePathssource

public массив

Список путей для поиска, если вложение не является абсолютным.

array()

$fromsource

public строка

Адрес электронной почты, с которого отправляется письмо.

null

$headerssource

public массив

Ассоциативный массив пользовательских заголовков. Ключи будут префиксрованы 'X-' в соответствии с RFC2822, раздел 4.7.5.

array()

$htmlMessagesource

public строка

Содержит рендеренное HTML-сообщение, если оно было отправлено.

null

$layoutsource

public строка

Макет для представления

'default'

$lineFeedsource

public строка

Символ(ы) перевода строки, которые должны быть использованы при отправке с помощью функции mail(). По умолчанию используется PHP_EOL. RFC2822 требует CRLF, но некоторые агенты передачи почты Unix автоматически заменяют LF на CRLF (что приводит к удвоению CR, если используется CRLF).

PHP_EOL

$messageIdsource

public смешанное

Следует ли генерировать заголовок Message-ID для электронного письма. True для генерации Message-ID, False, чтобы это обрабатывалось sendmail (или подобным) или строка для полного переопределения Message-ID.

Если вы отправляете письмо из командной строки, обязательно установите это значение. В противном случае могут возникнуть проблемы с доставкой.

true

$readReceiptsource

public строка

Адрес электронной почты для уведомления о прочтении.

null

$replyTosource

public строка

Адрес электронной почты, на который должен отвечать получатель.

null

$returnsource

public строка

Адрес электронной почты, который будет использоваться в случае ошибок, таких как - удаленный сервер почты недоступен - удаленный пользователь превысил лимит - неизвестный пользователь

null

$sendAssource

public строка

Формат, в котором должно быть отправлено письмо

Поддерживаемые форматы: - текст - html - оба

'text'

$smtpOptionssource

public массив

Список параметров для метода smtp mail

Параметры: - порт - хост - таймаут - имя пользователя - пароль - клиент

array()

$subjectsource

public строка

Тема письма

null
END_OF_DOCUMENT_MARKER

$templatesource

public string

Шаблон для представления

null

$textMessagesource

public string

Содержит отрендеренное сообщение в простом текстовом формате, если оно было отправлено.

null

$tosource

public string

Получатель электронной почты

null

$xMailersource

public string

От имени какого почтового клиента EmailComponent должен идентифицироваться

'CakePHP Email Component'

© 2005–2016 The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
http://api.cakephp.org/2.8/class-EmailComponent.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API