Ne v kontakte Antisocial programmer's blog

Пишем простой авторегистратор. Часть 6 - пишем для RegSubmitter.

    articles     howto     regsubmitter     code

Содержание

  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, но по ходу дела буду пояснять назначение тех или иных функций и их параметров.

**<?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 хорошие, не то что у яблофона, который с очередным обновлением прошивки грозит превратиться в кирпич. После долгих споров пришли к выводу, что пиво хорошее, но его мало. Вот так :).

P.S. Dimmu Borgir — The Sacrilegious Scorn

blog comments powered by Disqus