Headers content type text html charset windows 1251 r n

Стандартная функция отправки почты в PHP не заботится о кодировке письма, а специальные классы отправки писем могут показаться слишком тяжеловесным решением. В настоящей статье приведена простая функция, которая позволяет отправлять MIME-совместимые письма на русском языке в виде простого текста или в формате HTML.

Тело письма может быть текстом в любой кодировке. Немного сложнее дело обстоит с составляющими заголовка письма (Subject, From, To), они по стандарту должны быть в US-ASCII. Использование в заголовках кодированного текста регламентируется стандартом RFC-2047. Стандарт задает две возможные формы кодирования — BASE64 и Quoted-Printable. BASE64 более универсальна и работает в том числе для кодировки UTF-8, поэтому мы выбрали именно эту форму. MIME-совместимый почтовый клиент обязан уметь читать обе формы.

Далее код функции, который достаточно схематичен:

Мы определили собственную функцию mime_header_encode() для преобразования каждого заголовка в MIME-совместимый формат, несмотря на то, что в PHP предусмотрена аналогичная функция mb_encode_mimeheader(). От встроенной функции нам пришлось отказаться, так как на нашем сервере (PHP 5.1.6) она работает некорректно (возвращает неверный результат).

Использование описанной функции достаточно простое, см. пример ниже. В случае, если кодировка отправки письма отличается от текущей кодировки данных, используется iconv() для преобразования кодировки.

<?php
send_mime_mail(‘Автор письма’,
               ‘sender@site.ru’,
               ‘Получатель письма’,
               ‘recepient@site.ru’,
               ‘CP1251’,  // кодировка, в которой находятся передаваемые строки
               ‘KOI8-R’, // кодировка, в которой будет отправлено письмо
               ‘Письмо-уведомление’,
               «Здравствуйте, я Ваша программа!»);

?>

• Как отправлять письма, используя PHP?
• Как отправлять письма, используя ASP.NET?
• Как отправлять письма, используя ASP?
• WordPress
• Joomla
• Drupal
• NetCat

Поскольку отправка анонимных сообщений с серверов виртуального Windows-хостинга запрещена, отправку писем следует производить через SMTP-сервер, для чего так же возможно использовать и нашу почтовую систему.

Как отправлять письма, используя PHP?

С помощью любого класса PHP, поддерживающего авторизацию на smtp-сервере. Например, можно использовать набор классов PHPMailer.

Также вы можете воспользоваться нашим примером, в котором реализована отправка писем с использованием smtp-сервера, для которого требуется авторизация. Поэтому не забудьте добавить в скрипт соответствующие реквизиты доступа, например:

<?php

// Если нужно показать лог SMTP-сессии, то можно раскомментировать следующую строчку.
// $_SERVER['debug'] = true;

function MailSmtp($reciever, $subject, $content, $headers, $debug = 0) {

  $smtp_server = 'smtp.masterhost.ru'; // адрес SMTP-сервера
  $smtp_port = 25; // порт SMTP-сервера
  $smtp_user = 'user@domen.ru'; // Имя пользователя для авторизации на SMTP-сервере
  $smtp_password = 'pAsSwORd'; // Пароль для авторизации на SMTP-сервере
  $mail_from = 'frommailbox@domen.ru'; // Ящик, с которого отправляется письмо

  $sock = fsockopen($smtp_server,$smtp_port,$errno,$errstr,30);

  $str = fgets($sock,512);
  if (!$sock) {
    printf("Socket is not createdn");
    exit(1);
  }

  smtp_msg($sock, "HELO " . $_SERVER['SERVER_NAME']);
  smtp_msg($sock, "AUTH LOGIN");
  smtp_msg($sock, base64_encode($smtp_user));
  smtp_msg($sock, base64_encode($smtp_password));
  smtp_msg($sock, "MAIL FROM: <" . $mail_from . ">");
  smtp_msg($sock, "RCPT TO: <" . $reciever . ">");
  smtp_msg($sock, "DATA");

  $headers = "Subject: " . $subject . "rn" . $headers;

  $data = $headers . "rnrn" . $content . "rn.";

  smtp_msg($sock, $data);
  smtp_msg($sock, "QUIT");

  fclose($sock);
}


function smtp_msg($sock, $msg) {

  if (!$sock) {
    printf("Broken socket!n");
    exit(1);
  }

  if (isset($_SERVER['debug']) && $_SERVER['debug']) {
    printf("Send from us: %s<BR>", nl2br(htmlspecialchars($msg)));
  }
  fputs($sock, "$msgrn");
  $str = fgets($sock, 512);
  if (!$sock) {
    printf("Socket is downn");
    exit(1);
  }
  else {
    if (isset($_SERVER['debug']) && $_SERVER['debug']) {
      printf("Got from server: %s<BR>", nl2br(htmlspecialchars($str)));
    }

    $e = explode(" ", $str);
    $code = array_shift($e);
    $str = implode(" ", $e);

    if ($code > 499) {
      printf("Problems with SMTP conversation.<BR><BR>Code %d.<BR>Message %s<BR>", $code, $str);
      exit(1);
    }
  }
}

?>

Скачать пример готового скрипта с функцией MailSmtp(): smtpauth.php.sample

Использовать описанную выше функцию MailSmtp() можно для прямой замены функции mail(), рассмотрим пример самой простой формы на PHP:

<?php

if (isset($_POST['submit'])) {

  $to      = $_POST['to'];
  $subject = $_POST['subj'];
  $message = $_POST['msg'];
  
  // Заголовки сообщения, в них определяется кодировка сообщения, поля From, To и т.д.
  $headers = "MIME-Version: 1.0rn";
  $headers .= "Content-type: text/html; charset=windows-1251rn";
  $headers .= "To: $torn";
  $headers .= "From: Имя отправителя <from@domen.ru>";
  
  // mail ($to, $subject, $message, $headers);
 
  require_once "smtpauth.php";
  MailSmtp ($to, $subject, $message, $headers);

} 

?>

<form action="" method="post">
  <pre>
    Кому:   <input type="text" name="to">
    Тема:   <input type="text" name="subj">
    Текст:  <input type="text" name="msg">
    <input type="submit" value="Отправить!" name="submit">
  </pre>
</form>

Для того, чтобы данная форма заработала без функции mail(), мы включили файл smtpauth.php через require_once и вызвали функцию MailSmtp(), описанную в нем, с аналогичными для mail() аргументами. При этом сам вызов mail() мы закомментировали в коде, чтобы избежать ошибки при выполнении скрипта.

Как отправлять письма, используя ASP.NET?

Если вы используете версию 2.0, то используя
класс MailMessage (используется пространство имен System.Net.Mail), хорошо описанный здесь.

Ниже приведены примеры его использования для языков «C#» и «VisualBasic»:

Пример для языка «C#»:

<% @Page Language="c#" %>
<% @Import Namespace="System.Net.Mail" %>
<% @Import Namespace="System.Net" %>
<%

MailMessage message = new MailMessage(); // создание нового письма
message.To.Add ("user@tomail.tld"); // добавление адреса получателя
message.From = new MailAddress("from@domain.tld", "Имя_отправителя"); // указание имени и адреса отправителя
message.Subject = "Тема письма"; // указание темы письма 
message.BodyEncoding = System.Text.Encoding.UTF8; // указание кодировки письма
message.IsBodyHtml = false; // указание формата письма (true - HTML, false - не HTML)
message.Body = "Текст письма"; // указание текста (тела) письма

SmtpClient client = new SmtpClient("smtp.masterhost.ru",25); // создание нового подключения к серверу "smtp.masterhost.ru"
client.DeliveryMethod = SmtpDeliveryMethod.Network; // определяет метод отправки сообщений
client.EnableSsl = false; // отключает необходимость использования защищенного соединения с сервером
client.UseDefaultCredentials = false; // отключение использования реквизитов авторизации "по-умолчанию"
client.Credentials = new NetworkCredential("postmaster@domain.tld", "***password***"); // указание нужных реквизитов (имени пользователя и пароля) для авторизации на SMTP-сервере
client.Send(message); // отправка сообщения

%>

Скачать пример готовой формы, демонстрирующей использование данного метода: MailForm.aspx.

Пример для языка «VisualBasic»:

<% @Page Language="VB" Debug="true"  %>
<% @Import Namespace="System.Net.Mail" %>
<% @Import Namespace="System.Net" %>
<%

    Dim smtpMssg AS new MailMessage ' объявление нового объекта типа "MailMessage"
    smtpMssg.From = New MailAddress ("admin@domain.tld", "Имя_отправителя") ' указание имени и адреса отправителя
    smtpMssg.To.Add ("user@tomail.tld") ' добавление адреса получателя
    smtpMssg.Subject = "Тема письма" ' указание темы письма
    smtpMssg.Body = "Текст письма" ' указание текста (тела) письма
    smtpMssg.BodyEncoding = System.Text.Encoding.UTF8 ' указание кодировки письма
    smtpMssg.IsBodyHtml = false  ' указание формата письма (true - HTML, false - не HTML)
    
    Dim SmtpMail As New SmtpClient("smtp.masterhost.ru", 25)' объявление нового объекта типа "SmtpClient" 
    SmtpMail.DeliveryMethod = SmtpDeliveryMethod.Network ' указание метода доставки письма
    SmtpMail.UseDefaultCredentials = False ' отключение использования реквизитов авторизации "по-умолчанию" 
    SmtpMail.EnableSsl = False ' отключает необходимость использования защищенного соединения с сервером
    SmtpMail.Credentials = new NetworkCredential("postmaster@domain.tld", "***password***") ' указание нужных реквизитов (имени пользователя и пароля) для авторизации на SMTP-сервере
    SmtpMail.Send(smtpMssg) ' отправка сообщения

%>

Также существует устаревший (и не рекомендуется к использованию) класс SmtpMail (используется пространство имен System.Web.Mail). Ниже приведен пример его использования для языка «VisualBasic»:

<% @Page Language="VB" Debug="true"  %>
<% @Import Namespace="System.Web" %>
<% @Import Namespace="System.Web.Mail" %>
<%

Dim smtpMssg = new MailMessage ' объявление нового объекта типа "MailMessage"

smtpMssg.From = "Имя_отправителя <admin@domain.tld>" ' указание имени и адреса отправителя
smtpMssg.To = "admin@domain.tld" ' указание адреса получателя
smtpMssg.BodyFormat = MailFormat.Text ' указание формата письма
smtpMssg.BodyEncoding = Encoding.UTF8 'указание кодировки письма
smtpMssg.Subject = "Тема письма" ' указание темы письма
smtpMssg.Body = "Текст письма" ' указание текста письма
smtpMssg.Fields.Add("http://schemas.microsoft.com/cdo/configuration/smtpauthenticate",1) ' указание необходимости SMTP-авторизации на сервере
smtpMssg.Fields.Add("http://schemas.microsoft.com/cdo/configuration/sendusername", "admin@domain.tld") ' имя пользователя для авторизации
smtpMssg.Fields.Add("http://schemas.microsoft.com/cdo/configuration/sendpassword", "***password***") ' пароль для авторизации
SmtpMail.SmtpServer = "smtp.masterhost.ru" ' указание адреса SMTP-сервера
SmtpMail.Send(smtpMssg) ' отправка сообщения

%>

Как отправлять письма, используя ASP?

С помощью Collaboration Data Objects.

Обратите внимание, что при использовании нашего smtp-сервера требуется авторизация, поэтому не забудьте добавить в скрипт соответствующие реквизиты доступа, например:

<%
  iConfig = Server.CreateObject("CDO.Configuration")
  Set iConfig = Server.CreateObject("CDO.Configuration")
  With iConfig.Fields
    .Item("http://schemas.microsoft.com/cdo/configuration/smtpserver") = "smtp.masterhost.ru"
    .Item("http://schemas.microsoft.com/cdo/configuration/smtpserverport") = 25
    .Item("http://schemas.microsoft.com/cdo/configuration/sendusing") = 2
    .Item("http://schemas.microsoft.com/cdo/configuration/smtpauthenticate") = 1
    .Item("http://schemas.microsoft.com/cdo/configuration/languagecode") = "ru"
    .Item("http://schemas.microsoft.com/cdo/configuration/sendusername") = "postmaster@domain.tld"
    .Item("http://schemas.microsoft.com/cdo/configuration/sendpassword") = "password"
    .Update
  End With

  Set cdoMessage = CreateObject("CDO.Message")

  With cdoMessage
      Set .Configuration = iConfig
      .From = "Test user <postmaster@domain.tld>"
      .To = "User <user@somedomain.com>"
      .Subject = "Hello, User"
      .TextBody = "I write this message from ASP script."
      .Send
  End With

Set cdoMessage = Nothing
Set iConfig = Nothing
%>

Некоторые CMS уже имеют встроенные средства для отправки корреспонденции или соответствующие модули, рассмотрим самые популярные из них.

WordPress

Для данной CMS существует специальный модуль «WP Mail SMTP», пример его конфигурации описан на странице модуля.

Обратите внимание на иллюстрацию в примере, в условиях нашей почтовой системы требуется использовать 25-й порт и SSL-шифрование не требуется.

Joomla

В панели администрирования перейдите в раздел «Общие настройки», выберете вкладку «Сервер». В поле «Почта» требуется выбрать способ отправки как «SMTP-сервер», в полях «Адрес SMTP-сервера» и «SMTP-логин» и «SMTP-пароль» укажите соответствующие реквизиты почтовой системы, например: smtp.masterhost.ru, ящик@ваш_домен и соответствующий пароль.

Подробнее вы можете прочитать в документации к данной CMS.

Drupal

Эта CMS так же имеет собственный модуль для работы с SMTP-сервером, основанный на базе PHPMailer. Загрузить данный модуль можно на его странице на сайте CMS Drupal, описание установки модуля доступно в архиве с ним.

NetCat

Данная CMS не имеет встроенных функций для работы с SMTP-сервером. Для отправки почты скриптами сайта мы можем предложить использовать наше решение, для его подключения необходимо выполнить следующие действия:

• Скачать с нашего сайта архив с необходимыми файлами (send_auth_mail.php и mail.inc.php) и распаковать его на компьютере;

• Отредактировать файл send_auth_mail.php из архива, указав в нём реквизиты подключения к нужному SMTP-серверу:

  • $mail_smtpServer = «smtp.masterhost.ru»; (адрес SMTP-сервера)
  • $mail_port = «25»; (порт для подключения)
  • $mail_username = «mail@domain.tld»; (имя пользователя для авторизации на SMTP-сервере)
  • $mail_password = «Password»; (пароль для авторизации на SMTP-сервере)
• Создать резервную копию файла domain.tld/www/netcat/admin/mail.inc.php;
• Загрузить файлы send_auth_mail.php и mail.inc.php на виртуальную площадку в директорию domain.tld/www/netcat/admin/

domain.tld следует заменить на имя вашего домена.

Предлагаемое решение работает со всеми модулями NetCat, которые используют стандартные функции данной CMS для отправки почты.

От автора: вопрос кодировок является, без сомнения, одним из актуальных вопросов рано или поздно встающим перед любым веб-мастером. Практически каждый из нас сталкивался с такой, порой довольно неприятной, проблемой, как проблема корректного отображения информации на сайте, т.е. вывод ее на экран в нужной нам кодировке. Несмотря на то, что этот вопрос почти всегда решается очень легко, и ничего сложного в нем нет. Сейчас в сети можно часто увидеть вопросы о всевозможных «кракозябрах, вопросах и ромбиках» на сайте.

1. Кодировка при работе без использования баз данных

Забегая вперед, давайте сразу сформулируем основной тезис, придерживаясь которого мы значительно облегчим себе работу:

Кодировка в Вашем проекте должна быть универсальной.

Какое значение вкладывается в этот термин — «универсальная»? Это значит, что все составляющие создаваемого проекта, которые так или иначе касаются кодировок, должны иметь единую кодировку. Чтобы понять эту мысль разобьем сформулированный тезис на пункты, которые затем поэтапно разберем:

1. Содержимое всех файлов должно иметь единую кодировку.

2. Заголовки должны передавать единую кодировку.

3. В качестве кодировки сервера необходимо установить единую кодировку.

4. Кодировка соединения с БД также не должна отличаться от кодировки создаваемого проекта.

Это 4 основных правила, которые и являются составляющими сформулированного тезиса. Давайте теперь разберем каждый из этих пунктов.

Итак, на сервере создадим файл index.php, содержимое которого сохраним в кириллической кодировке. Сделать это можно, например, в редакторе Notepad++ через пункт меню Кодировки.

Узнать текущую кодировку файла можно взглянув в строку состояния редактора (в нижней панели).

Здесь уместно дать небольшой совет. При создании сайтов лучше пользоваться одной из двух кодировок: кириллической (windows-1251) или юникод без сигнатуры BOM (utf-8 without BOM). При этом следует знать, что юникод более универсален. Эта кодировка содержит большее количество символов, а потому идеально подойдет для мультиязычных сайтов, в то время как с кириллической кодировкой здесь могут возникнуть проблемы. Есть еще ряд нюансов при использовании юникода. В общем, лучше использовать ту кодировку, которая более универсальна, но если Ваш сайт содержит только кириллические символы, то никто не запрещает использовать Вам windows-1251, тем более, что она также имеет свои плюсы (детальнее об этом, возможно, в одном из следующих уроков).

Отлично, кодировка нашего файла кириллическая (windows-1251). У всех остальных файлов проекта, согласно первому пункту, кодировка должна быть аналогичной. В мета-тегах (между тегами head) также укажем эту кодировку:

Выведем какой-нибудь текст кириллицей на страницу:

Сохраним файл и попробуем открыть его в браузере… На экран выводится нечитабельная строка — набор вопросительных знаков вместо букв.

Почему так? Ведь мы сохранили файл в кириллической кодировке, в мета-теге также прописали нужную кодировку, но это не помогло. Если мы взглянем, в какой именно кодировке браузер отобразил нам текст, то увидим UTF-8.

При этом если мы выставим в браузере вручную нужную нам кодировку, то текст станет читабельным, но… до следующего обновления страницы в браузере. Еще раз зададимся вопросом, почему так произошло? Почему браузер никак не отреагировал на кодировку указанную в мета-теге?

«Виноват» здесь не браузер, а сервер. Дело в том, что сервер отсылает в браузер так называемые заголовки, где указывается кодировка, в которой браузер должен отобразить содержимое файла. В качестве кодировки сервер берет кодировку по умолчанию, т.е. так называемую дефолтную кодировку сервера. Посмотреть дефолтную кодировку сервера можно в конфигурационном файле httpd.conf, расположенном на сервере в каталоге usrlocalapacheconf. Здесь кодировка задается в строке AddDefaultCharset. Здесь же мы можем изменить кодировку на нужную нам, при этом не забывая после внесения изменений перезапускать сервер.

Но изменить кодировку получится только на локальном сервере. На сервере в сети хостер нам просто не даст доступ к конфигурационному файлу сервера… и правильно сделает 🙂 Что же нам делать в таком случае? Неужели придется подстраиваться под настройки сервера? Конечно же нет. Для решения этой задачи существует 2 варианта, отвечающих за второй и третий сформулированные нами выше пункты.

Согласно второму пункту мы можем самостоятельно передать в заголовках необходимую кодировку. Делается это при помощи функции header(), в параметрах которой мы укажем тип документа и, собственно, кодировку. В самом верху файла (перед объявлением доктайпа (типа документа)) добавим строку кода:

Если теперь обновить страницу в браузере, то увидим читабельный текст в кириллической кодировке. Замечательно — мы решили задачу! Путем передачи заголовков мы указали нужную нам кодировку. Но этот вариант не совсем универсален. Дело в том, что заголовки передаются посредством функции header(), т.е. для этого мы используем средства PHP. Но что же тогда делать, если файлы нашего проекта имеют расширение html? В файлах с таким расширением по умолчанию код PHP не выполняется, соответственно — заголовки не будут отправлены. Результат — вновь нечитабельный текст в браузере.

Альтернативой является второе решение (пункт 3), которое гораздо более универсальнее первого. Итак, согласно пункта 3 мы должны установить дефолтной кодировкой сервера нужную нам. Но как это можно сделать, если к конфигурационному файлу сервера мы доступа не имеем? Очень просто. Предусмотрен специальный файл, в котором можно изменять некоторые настройки сервера, в частности — дефолтную кодировку. Файл этот не имеет расширения и называется .htaccess (с точкой в начале имени файла). В самом файле достаточно прописать ту же строку, что и в конфигурационном файле сервера, но с указанием необходимой кодировки:

Сервер при этом перезапускать не нужно, поскольку фактически мы ничего не изменяем в его настройках, а просто «говорим» серверу, что в качестве дефолтной кодировки следует использовать ту, которую мы только что указали.

Теперь файлы открываются в «правильной» (нужной нам) кодировке (функцию header() теперь нет надобности использовать) и кодировка нашего проекта не будет зависеть от настроек сервера того или иного хостера.
Но помните, если мы нарушим сформулированный нами тезис об универсальности кодировки и, к примеру, при установленной в качестве дефолтной кодировки кириллице перекодируем содержимое файлов в юникод, то получим знаменитые «кракозябры».

2. Проблема кодировки при работе с базой данных

Теперь взглянем на ту же проблему, но с использованием в работе БД. Дело в том, что в таблицах БД лежит текст, и эти таблицы также могут иметь свою кодировку. Поскольку я использую в качестве сервера Денвер, который настроен под кириллическую кодировку, то логично, что для хранения информации в БД по умолчанию используется также кириллическая кодировка.

Не будем ничего изменять в настройках и при создании БД и таблицы оставим все как есть, т.е. будет использована кириллическая кодировка. Хотя, забегая вперед, можно сказать, что если бы мы создали таблицы в нужной нам кодировке, то это совсем не означает, что данные будут выведены в этой же кодировке… вся хитрость в том, что здесь существует такой параметр, как кодировка соединения с БД. Вот ее то мы и будем использовать для достижения нужного результата.

Итак, создадим файл с кодировкой юникод (поскольку мы заранее знаем, что данные из БД будут выведены в кириллической кодировке), т.е. мы таким образом поставили перед собой в учебных целях проблему, которую и попытаемся решить… как говорится, тяжело в учении… 🙂

При создании файла не забудем передать в заголовках нужную нам кодировку, поскольку в файле .htaccess указана сейчас кириллическая кодировка, но мы хотим, чтобы новый файл работал корректно в юникоде:

Теперь создадим БД charset и в ней таблицу test с двумя полями:

В таблицу поместим единственную запись в поле text:

Эту запись мы и будем выводить на экран. Для этого пропишем соединение с сервером MySQL, выберем БД для работы и запросом выберем необходимые данные (все это мы уже проделывали в ряде предыдущих уроков, а потому подробно останавливаться на объяснении всего этого — нет оснований):

Теперь в массиве $row мы имеем искомую строку. Давайте выведем ее в теле страницы (между тегами body):

Если сейчас открыть страницу в браузере, то увидим опять-таки вместо читабельного текста вопросительные знаки. Так произошло оттого, что браузер (согласно отосланных заголовков) открыл страницу в юникоде, но информация из БД достается в кириллической кодировке. Как это исправить? Очень просто — достаточно после соединения с сервером БД указать в запросе кодировку соединения, тогда данные из БД будут отдаваться в искомой кодировке.

Пропишем необходимый запрос после соединения:

Теперь после обновления страницы информация выводится корректно.
Вот и вся хитрость.

Заключение

Стоит обратить внимание на отличия в именовании кодировок в MySQL от традиционного их именования, т.е. того, к которому мы привыкли. Например, указать юникод правильно так — «utf8», но не так — «utf-8». Второй вариант серверу MySQL будет непонятен. Аналогично с кириллицей: правильно так — «cp1251», но не так — «windows-1251».

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

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

Автор: Кудлай Андрей

Редакция: Рог Виктор и Андрей Бернацкий. Команда webformyself.