Пишем простой авторегистратор. Часть 6 - пишем для RegSubmitter.
Содержание
- Инструментарий
- Основы
- Боремся с капчей
- Подключаем антикапчу
- Подтверждение по email
- Пишем модуль для 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, но по ходу дела буду пояснять назначение тех или иных функций и их параметров.
<?php
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('#<input type="hidden" name="token" value="([0-9a-z]+)" />#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('#<p class="error">([^<]+)</p>#mu', $html_data, $matches);
return $matches[1];
}
}
/**
* Функция подтверждения по почте.
* Параметр $account содержит те же данные о логине, пароле и email-e, что и в случае с методом SubmitReg.
* возвращает null в случае успеха или массив с сообщениями об ошибках в ином случае.
*/
function Confirm($account)
{
// Ищем письмо по отправителю. Кроме того, в теле письма должен упоминаться домен из поля $this->url
$mail = $this->findMail('no-reply@memori.ru');
// Загружаем тело сообщения
$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: Memori.zip. И, кстати, на этот раз в нем нет никаких ошибок ;)
Короткой строкой.
- В процессе поиска хостинга для нового своего проекта нашел один недорогой хостинг. Между прочим, они являются спонсорами такого крупного ресурса, как phpbbguru.net, что есть хороший показатель.
- Сегодня беседовал с хорошим товарищем на тему телефонов и брендов. Он утверждал, что яблочные телефоны - рабство Стива Джобса, хоть с джейлбрейком, хоть без него. И говорил что у нормальных производителей вроде нокии и тупых ограничений нет, и отзывы о nokia хорошие, не то что у яблофона, который с очередным обновлением прошивки грозит превратиться в кирпич. После долгих споров пришли к выводу, что пиво хорошее, но его мало. Вот так :).