Содержание

1. Инструментарий
2. Основы
3. Боремся с капчей
4. Подключаем антикапчу
5. Подтверждение по email
6. Пишем модуль для RegSubmitter

В этой заключительной статье я покажу, как можно легко и аккуратно реализовать материал, изложенный в предыдущих статьях, при помощи RegSubmitter

Введение в предмет.

RegSubmitter изначально задумывался мною как гибкий фреймворк для быстрого написания авторегистраторов. Поэтому в отличие от предыдущих разов, вам не надо будет задумываться обо всякой рутине вроде считывания данных из файла/запроса, заморачиваться с одновременной регистрацией нескольких аккаунтов и т.д. Вы напишете логику, а RegSubmitter сделает все остальное.

Сразу скажу, что в этой статье я буду пользоваться версией RegSubmitter 1.4.0, которая пока официально не зарелизена, но уже скоро будет :) Впрочем, все нижеизложенное будет работать и в 1.3.6, за исключением подтверждения по email.

Структура модуля

Прежде всего, отмечу, что в RS есть два типа модулей: простые и "универсальные". Простые работают только с одним конкретным сервисом, и "универсальные" могут работать со многими сайтами на одинаковых движках. В рамках этой статьи мы каснемся только простых модулей и будем рассматривать все на примере memori.ru.

Модули в RegSubmitter разбиваются по категориям, и располагаются в папке modules/Category_Name/Module_ID/module_ID.php. Здесь module_ID - это буквенно-цифровой идентификатор модуля, который должен быть уникален для каждого модуля (впрочем, это не означает, что он должен быть нечитаем ;) ). Например, модуль, работающий с сервисом Memori.ru находится по адресу /modules/Rus/Memori/Memori.php.

В этом файле должен находиться класс с именем, совпадающим с Module_ID, и при этом унаследованным от класса Module.

Код модуля

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

Первая состоит в том, что в начале класса идут параметры, задающие свойства модуля и то, как он будет обрабатываться RegSubmitter-ом. Во-вторых, я не буду отдельно описывать API RegSubmitter'a, но по ходу дела буду пояснять назначение тех или иных функций и их параметров.

class Memori extends Module
{
 // Параметры модуля
 var $name = 'Memori'; // Имя сервиса, отображаемое пользователю
 var $id = 'Memori'; // Все тот же Module_ID
 var $url = 'http://memori.ru/'; // URL сервиса. Настоятельно рекомендую указывать правильный :-)
 var $icon = 'memori.png'; // Имя иконки. Должна лежать в одной папке с файлом модуля.
 var $notice = ''; // Дополнительная информация, которую мы желаем сообщить пользователям
 var $email_confirm = true; // Требуется ли подтверждение по email
 var $core_version = 3; // Версия ядра, на которую рассчитан модуль, необходимо для проверки совместимости. Нынешняя, как не трудно догадаться - 3
 var $encoding = 'cp1251'; // Кодировка сайта.
 /**
  * Функция, ответственная за загрузку капчи.
  * Если ввод капчи не требуется, возвращает null. В противном случае возвращает массив данных, 
  * которые понадобятся при отправке формы, в т. ч. имя временного файла с кукисами, различные токены и т. п.
  * Обязательно в массиве должен быть элемент image_file, чтобы RegSubmitter мог отобразить капчу пользователю для ввода.
  */
 function GetForm()
 {
  // Запрашиваем страницу регистрации.
  $page = $this->Get('http://memori.ru/registration/');
  // Извлекаем токен
  preg_match('##is', $page, $matches);
  // Ноу-хау: допываем картинку из рекапчи
  $js = $this->Get('http://api.recaptcha.net/challenge?k=6LfV6wgAAAAAAF327mU7j7lzG6s-p1SolxPA2Wx2');
  preg_match("#challenge : '([^']+)'#", $js, $key);
  // Собственно скачиваем картинку
  $image = $this->Get("http://api.recaptcha.net/image?c=$key[1]");
  // Генерируем имена временных файлов для хранения кукисов и картинки. Параметр - префикс имени файла.
  $cookies_file = $this->TempFile('cookie');
  $image_file = $this->TempFile('image');
  $this->SaveCookies($cookies_file); // Сохраняем кукисы
  file_put_contents($image_file, $image); // Сохраняем картинку
  // Возвращаем данные, которые нам понадобятся потом.
  return array(
   'image_file' => $image_file, // Картинку капчи. ОБЯЗАТЕЛЬНО!
   'cookies_file' => $cookies_file, // Файл с кукисами
   'key'   => $matches[1], // Токен формы, добытый в начале
   'recaptcha'  => $key[1], // Токен рекапчи
  );
 }
 /**
  * Эта функция занимается собственно произведением регистрации.
  * Параметры:
  * - $account массив из элеменитов login, password, email. Назначение, думаю, очевидно :)
  * - $data тот самый массив, который мы вернули из функции GetForm()
  * - $captcha текст, написанный по мнению пользователя на капче.
  * Функция возвращает null в случае успеха или массив сообщений об ошибках, если они возникли.
  */
 function SubmitReg($account, $data, $captcha)
 {
  // Собираем запрос
  $post_data = array(
   'login'   => $account['login'], // Логин
   'email'   => $account['email'], // Емейл
   'password'  => $account['password'], // Пароль
   'password_confirm' => $account['password'], // И снова пароль
   'recaptcha_response_field' => $captcha, // Текст с картинки
   'recaptcha_challenge_field' => $data['recaptcha'], // Токен рекапчи
   'token'   => $data['key'], // Токен формы
   'inviter'  => '', // Просто пустое поле. Видимо, для какой-то реферральной системы
  );
  // Загружаем сохраненные кукисы с прошлого раза
  $this->LoadCookies($data['cookies_file']);
  // Отправляем запрос. Первый параметр - куда, второй - параметры запроса, 
  // третий (опциональный, по умолчанию - false) - надо ли преобразовывать страницу из кодировки сайта в родную для RS (utf-8)
  // Очевидно, что для веб-страниц его надо ставить true, а дял картинок - false. Аналогичный параметр есть и у метода $this->Get()
  $html_data = $this->Post("http://memori.ru/register/", $post_data, true);
  // Проверяем успешность регистрации
  if(strstr($html_data, 'На указанный Вами электронный адрес'))
  {
   return null;
  }
  else
  {
   // Если не прошло, добываем ошибки.
   preg_match_all('#
([^#mu', $html_data, $matches);
   return $matches[1];
  }
 }
 /**
  * Функция подтверждения по почте.
  * Параметр $account содержит те же данные о логине, пароле и email-e, что и в случае с методом SubmitReg.
  * возвращает null в случае успеха или массив с сообщениями об ошибках в ином случае.
  */
 function Confirm($account)
 {
  // Ищем письмо по отправителю. Кроме того, в теле письма должен упоминаться домен из поля $this->url
  $mail = $this->findMail('[email protected]');
  // Загружаем тело сообщения
  $text = $this->getMailBody($mail['msg_id']);
  // Извлекаем ссылку подгверждения
  preg_match('#http://memori.ru/regconfirm/[0-9]+/[0-9a-z]+/#i', $text, $url);
  // Отправляем запрос
  $html_data = $this->Get($url[0], true);
  // Проверяем успешность
  if(strstr($html_data, '/logout/'))
  {
   return null;
  }
  else
  {
   // Если что не так - ругаемся.
   return array('Произошла ошибка активации или аккаунт уже был ранее подтвержден');
  }
 }
}
// Alles :-)
?>

Напоследок замечу, что в RS имеется очень удобная для отладки функция dbg($var). Будучи вызванная в любом месте кода она выведет дамп переменной var внизу страницы. Она особенно хороша тем, что работает в том числе и тогда, когда скрипт вызывается через AJAX.

Во вложении к посту полный архив модуля Memori. И, кстати, на этот раз в нем нет никаких ошибок ;)

Короткой строкой.

• В процессе поиска хостинга для нового своего проекта нашел один недорогой хостинг. Между прочим, они являются спонсорами такого крупного ресурса, как phpbbguru.net, что есть хороший показатель.
• Сегодня беседовал с хорошим товарищем на тему телефонов и брендов. Он утверждал, что яблочные телефоны - рабство Стива Джобса, хоть с джейлбрейком, хоть без него. И говорил что у нормальных производителей вроде нокии и тупых ограничений нет, и отзывы о nokia хорошие, не то что у яблофона, который с очередным обновлением прошивки грозит превратиться в кирпич. После долгих споров пришли к выводу, что пиво хорошее, но его мало. Вот так :).

Dimmu Borgir - The Sacrilegious Scorn