Класс EmailComponent
EmailComponent
Этот компонент используется для обработки Internet Message Format, основанного на стандарте, описанном в http://www.rfc-editor.org/rfc/rfc2822.txt
- Объект
-
Компонент -
EmailComponent
Ссылка: 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
Резюме свойств
- Ссылка на контроллер
$_controllerprotected -
$additionalParamspublicСписок дополнительных заголовковstring -
$attachmentspublicСписок файлов, которые должны быть прикреплены к письму.array -
$bccpublicСкрытая копияarray -
$ccpublicКопияarray -
$charsetpublicКодировка символов для отправляемого письмаstring -
$datepublicstringДата, которая должна быть указана в заголовке Date. Должна соответствовать стандарту RFC2822. Оставьте null, чтобы использовать текущую дату.
-
$deliverypublicМетод для отправки письмаstring -
$filePathspublicСписок путей для поиска вложений, если путь не абсолютныйarray -
$frompublicАдрес отправителяstring -
$headerspublicarrayАссоциативный массив пользовательских заголовков. Ключи будут иметь префикс 'X-' в соответствии с RFC2822 Раздел 4.7.5
-
$htmlMessagepublicСодержит отрендеренное HTML сообщение, если оно было отправлено.string -
$layoutpublicМакет для представленияstring -
$lineFeedpublicstringСимвол(ы) перевода строки, используемые при отправке с помощью функции mail(). По умолчанию используется PHP_EOL. RFC2822 требует CRLF, но некоторые агенты передачи почты Unix автоматически заменяют LF на CRLF (что приводит к удваиванию CR, если используется CRLF).
-
$messageIdpublicmixedГенерировать заголовок Message-ID для электронного письма. True - генерировать, False - позволить sendmail (или подобному) обрабатывать его, или строка - полностью переопределить Message-ID.
-
$readReceiptpublicЭлектронное письмо для подтверждения прочтенияstring -
$replyTopublicЭлектронное письмо, на которое получатель должен ответитьstring -
$returnpublicstringЭлектронное письмо, которое будет использоваться в случае ошибок, таких как: - Отдалённый почтовый сервер недоступен - Отдалённый пользователь превысил свой лимит - Неизвестный пользователь
-
$sendAspublicФормат для отправки письмаstring -
$smtpOptionspublicСписок параметров для метода smtparray -
$subjectpublicТема письмаstring -
$templatepublicШаблон для представленияstring -
$textMessagepublicСодержит отрендеренное текстовое сообщение, если оно было отправлено.string -
$topublicПолучатель письмаstring -
$xMailerpublicКак EmailComponent должен идентифицировать себяstring
Унаследованные свойства
Резюме методов
- __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( )
Форматирование массива вложений
Возвращает
массив_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::beforeRedirectbeforeRender()source public
beforeRender( Controller $controller )
Вызывается перед Controller::beforeRender(), перед загрузкой класса представления и перед Controller::render()
Параметры
-
Controller$controller - Контроллер с компонентами для beforeRender
Ссылка
http://book.cakephp.org/2.0/ru/controllers/components.html#Component::beforeRendershutdown()source public
shutdown( Controller $controller )
Вызывается после Controller::render() и перед выводом данных в браузер.
Параметры
-
Controller$controller - Контроллер с компонентами для shutdown
Ссылка
http://book.cakephp.org/2.0/ru/controllers/components.html#Component::shutdownstartup()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().
Возвращает
логическое значениеУспех записи в журнал
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( )
Преобразование объекта в строку. Каждый класс может переопределить этот метод по необходимости.
Возвращаемое значение
строкаНазвание этого класса
Подробное описание свойств
$additionalParamssource
public строка
Список дополнительных заголовков
Эти значения НЕ будут использованы, если вы используете режим safemode и функцию mail()
null
$attachmentssource
public массив
Список файлов, которые должны быть прикреплены к электронному письму.
Пути могут быть как абсолютными, так и относительными
array()
$bccsource
public массив
Скрытая копия
Список адресов электронной почты, которые должны получить копию письма. Получатель НЕ увидит этот список.
array()
$ccsource
public массив
Копия
Список адресов электронной почты, которые должны получить копию письма. Получатель увидит этот список.
array()
$datesource
public строка
Дата, которая должна быть включена в заголовок Date. Должна соответствовать стандарту RFC2822. Если оставить значение null, будет использоваться сегодняшняя дата.
null
$deliverysource
public строка
Метод, который должен использоваться для отправки письма
Поддерживаемые методы: - mail - smtp - debug
'mail'
$filePathssource
public массив
Список путей для поиска, если вложение не является абсолютным.
array()
$headerssource
public массив
Ассоциативный массив пользовательских заголовков. Ключи будут префиксрованы 'X-' в соответствии с RFC2822, раздел 4.7.5.
array()
$htmlMessagesource
public строка
Содержит рендеренное HTML-сообщение, если оно было отправлено.
null
$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
$returnsource
public строка
Адрес электронной почты, который будет использоваться в случае ошибок, таких как - удаленный сервер почты недоступен - удаленный пользователь превысил лимит - неизвестный пользователь
null
$sendAssource
public строка
Формат, в котором должно быть отправлено письмо
Поддерживаемые форматы: - текст - html - оба
'text'
$smtpOptionssource
public массив
Список параметров для метода smtp mail
Параметры: - порт - хост - таймаут - имя пользователя - пароль - клиент
array()
$textMessagesource
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