Spec-Zone.ru › CakePHP 2.7

Класс EmailComponent

EmailComponent

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

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

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

__constructисточник public

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

Конструктор

Параметры

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

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

Component::__construct()

_findFilesисточник protected

_findFiles( string $attachment )

Находит указанное вложение в списке путей к файлам

Параметры

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

Возвращает

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

_formatAddressesисточник protected

_formatAddresses( array $addresses )

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

Параметры

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

Возвращает

array
массив

_formatAttachFilesисточник protected

_formatAttachFiles( )

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

Возвращает

array
массив

_stripисточник protected

_strip( string $value , boolean $message false )

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

Параметры

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

Возвращает

string
Очищенное значение

initializeисточник public

initialize( Controller $controller )

Инициализация компонента

Параметры

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

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

Component::initialize()

resetисточник public

reset( )

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

sendисточник public

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

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

Параметры

строка|массив $content необязательно null
Либо массив строк текста, либо строка с содержимым. Если вы рендерите шаблон, эта переменная будет отправлена в шаблоны как $content
строка $template необязательно null
Шаблон для использования при отправке электронного письма
строка $layout необязательно null
Макет для использования для оформления тела электронного письма

Возвращает

boolean
Успех

Методы, унаследованные от Компонента

__getисточник public

__get( string $name )

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

Параметры

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

Возвращает

mixed
Объект компонента или null.

beforeRedirectисточник public

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

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

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

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

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

Параметры

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

Возвращает

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

Ссылка

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

beforeRenderисточник public

beforeRender( Controller $controller )

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

Параметры

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

Ссылка

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

shutdownисточник public

shutdown( Controller $controller )

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

Параметры

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

Ссылка

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

startupисточник public

startup( Controller $controller )

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

Параметры

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

Ссылка

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

Методы, унаследованные от Объекта

_mergeVarssource protected

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

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

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

Параметры

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

_setsource protected

_set( array $properties array() )

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

Параметры

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

_stopsource protected

_stop( integer|string $status 0 )

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

Параметры

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

dispatchMethodsource public

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

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

Параметры

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

Возвращает

mixed
Возвращает результат вызова метода

logsource 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().

Возвращает

boolean
Успешность записи в журнал

requestActionsource 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 необязательно array()
Если массив содержит ключ "return", он устанавливает AutoRender в значение true. Также может быть использован для отправки данных GET/POST и именованных/переданных аргументов.

Возвращает

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

toStringsource public

toString( )

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

Возвращает

string
Имя этого класса

Краткое описание свойств

$_controllersource

protected Controller

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

null

$additionalParamssource

public string

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

Они НЕ будут использоваться, если вы используете safemode и mail()

null

$attachmentssource

public array

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

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

array()

$bccsource

public array

Скрытая копия (BCC)

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

array()

$ccsource

public array

Копия (CC)

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

array()

$charsetsource

public string

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

'utf-8'

$datesource

public string

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

null

$deliverysource

public string

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

Поддерживаемые методы:

  • mail
  • smtp
  • debug
'mail'

$filePathssource

public array

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

array()

$fromsource

public string

Адрес отправителя

null

$headerssource

public array

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

array()

$htmlMessagesource

public string

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

null

$layoutsource

public string

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

'default'

$lineFeedsource

public string

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

PHP_EOL

$messageIdsource

public mixed

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

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

true

$readReceiptsource

public string

Адрес для уведомления о прочтении

null

$replyTosource

public string

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

null

$returnsource

public string

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

  • Удаленный почтовый сервер не отвечает
  • Удаленный пользователь превысил свою квоту
  • Неизвестный пользователь
null

$sendAssource

public string

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

Поддерживаемые форматы:

  • text
  • html
  • both
'text'

$smtpOptionssource

public array

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

Параметры:

  • port
  • host
  • timeout
  • username
  • password
  • client
array()

$subjectsource

public string

Тема письма

null

$templatesource

public string

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

null

$textMessagesource

public string

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

null

$tosource

public string

Получатель письма

null

$xMailersource

public string

Как EmailComponent должен идентифицировать себя как почтовый агент

'CakePHP Email Component'

Свойства, унаследованные от Component

$_Collectionsource

protected ComponentCollection

Класс коллекции компонентов, используемый для ленивой загрузки компонентов.

$_componentMapsource

protected array

Таблица поиска компонентов, используемая для ленивой загрузки объектов компонентов.

array()

$componentssource

public array

Другие компоненты, используемые этим компонентом.

array()

$settingssource

public array

Настройки для этого компонента

array()

© 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.7/class-EmailComponent.html

Spec-Zone.ru

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