readme.txt

***********************************************************************************************************
*                                                                                                         *
*                                  down.php v0.1.4 (Released 13.02.2010)                                  *
*                                            created by JeFFrey                                           *
*                                                                                                         *
*                                        http://gameart.110mb.com/                                        *
*                                                                                                         *
***********************************************************************************************************

***********************************************************************************************************

  Общие сведения

***********************************************************************************************************

Данный скрипт предназначен для автоматического сбора геймарта с сайта AG.ru. Подробнее о геймарте можно
почитать здесь: http://www.ag.ru/gameart/.

Условно работу скрипта можно разделить на этапы:
  1. Выполнение входа на AG под указанными пользователем логином и паролем (если эта функция включена).
     Выполняется единожды в самом начале работы
  2. Запрос страницы, содержащей ссылку на карточку (как правило, /stats/) с использованием cookies,
     полученных на предыдущем этапе
  3. Запрос карточки (уже без использования cookies)
  4. Сохранение карточки (в случае, если она не была сохранена ранее)
  5. Отправка карточки на http://gameart.110mb.com/ (если она требуется проектом и пользователь
     не отключил эту функцию)

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

***********************************************************************************************************

  Changelog

***********************************************************************************************************

13.02.2010 v0.1.4
  [+] Добавлена возможность установить паузу между запросами карточек

22.06.2009 v0.1.3
  [*] Исправлено: ранее скрипт отправлял в проект, помимо необходимых карточек, еще и карточки, имя файла
      которых содержит ведущие нули

01.06.2009 v0.1.2
  [*] Исправлен баг с отправкой карточек

21.01.2009 v0.1.1
  [+] Добавлена возможность автоматической рассортировки арта по подпапкам для каждого сета

14.01.2009 v0.1
  [!] Первый релиз скрипта

***********************************************************************************************************

  Настройки

***********************************************************************************************************

     *                                                                                               *
    * *    ВНИМАНИЕ!!! В силу особенностей языка PHP, во всех настройках  (особенно это касается    * *
   *   *    путей к файлам) обратный слеш (\) необходимо писать два раза (\\). Например, вместо    *   *
  *  !  *    "D:\folder\" необходимо указывать "D:\\folder\\", иначе скрипт не будет работать.    *  !  *
 *       *                                  Будьте внимательны!                                  *       *
***********                                                                                     ***********

Значения, указанные в описанных настройках, используются по умолчанию. Загадочный термин "пустая строка"
означает две идущие подряд кавычки (""). Если в имени файла не будет указан путь, предполагается, что файл
лежит в той же папке, что и скрипт.

    $host="www.ag.ru";
      Имя хоста без предварительного "http://". Менять, я думаю, почти бессмысленно.

    $page="/stats/";
      Страница, с которой будет добываться арт. Должна предваряться одним слешем, например вместо "stats/"
      нужно указывать "/stats/". Как известно, "/stats/" считается наиболее легкой страницей, содержащей
      геймарт.

    $local_folder="";
      Папка, в которую будет сохраняться арт. Пустая строка означает папку, в которой находится скрипт.

    $log_file="log.txt";
      Имя файла, в который будет выводиться лог. Пустая строка будет означать отключение логгирования.

    $crc="";
      Файл с контрольными суммами (набор строк в произвольном порядке, каждая содержит имя файла
      и ЧЕРЕЗ ПРОБЕЛ сумму CRC).

    $send_cards=true;
      Включить (true) или отключить (false) отправку карт в проект gameart.110mb.com.

    $save_to_subfolders=false;
      false: Сохранять весь арт в указанной папке $local_folder;
      true:  рассортировывать арт по отдельным подпапкам для каждого сета (например, 001\, 002\ и так
             далее; название папки берется из имени файла до первого знака нижнего подчеркивания (_)).

    $username="downphp";
    $password="setitfree";
      Логин и пароль AG.ru. Эти данные нужны для уменьшения трафика (выигрыш примерно в 32000 байт). Кроме
      того, они необходимы для использования преимуществ VIP-аккаунта. Для наибольшей эффективности
      отключите как можно больше элементов дизайна в настройках AG. Я гарантирую, что эти данные никуда
      не отсылаются (исходники-то перед вами — проверяйте). Тем не менее, если вы скачали скрипт не с
      моего сайта, гарантировать я уже ничего не могу. Наилучшим решением в плане безопасности будет
      зарегистрировать новый логин, использующийся только для коллектинга. Впрочем, есть специально
      зарегистрированный левый ничейный логин downphp с паролем setitfree, это и есть значения
      по умолчанию. Пустая строка в значении переменной $username отключит использование входа на AG.

    $time_for_sleep=0;
      Значение временной задержки между запросами карточек в секундах. Принимает неотрицательные значения,
      и если установлено не в 0, перед запросом очередной карточки скрипт делает паузу в установленное
      количество секунд, сопровождая это выводом трёх точек, после чего продолжает нормальную работу.

    $time_offset=0;
      Временной сдвиг (в часах). Используется в том случае, если в лог выводятся неправильное время.
      Положительный сдвиг прибавляет часы, отрицательный — убавляет, дробное значение возможно
      (правда, нужно иметь ввиду, что десятичные дроби пишутся через точку).

***********************************************************************************************************

  Установка и запуск

***********************************************************************************************************

Скрипт требует наличие PHP-процессора, последнюю стабильную версию можно скачать тут (Windows Binaries):
  http://www.php.net/downloads.php#v5

Если вы установили PHP не в "C:\Program Files\PHP\", то в файлах "down.php" и "back.php" нужно изменить
путь к "php-cgi.exe" и "php-win.exe". Обратите внимание, что полное имя файла указывается в кавычках.

Перед первым запуском проверьте настройки (предыдущий пункт).

Для запуска скрипта запустите один из файлов:
  down.bat (для варианта с консолью)
  back.bat (для фонового варианта)

Для того, чтобы остановить выполнение скрипта, запущенного в консольном режиме, достаточно закрыть
рабочее окно скрипта. Чтобы остановить скрипт в фоновом режиме, нужно вызвать диспетчер задач
(Ctrl+Alt+Delete) и завершить процесс "php-win.exe" (кстати, в фоновом режиме процесс будет называться
"php-cgi.exe").

**********************************************************************************************************

  Условия распространения и ссылки

**********************************************************************************************************

Данный скрипт распространяется на условиях "как есть". Это значит, что вы можете свободно распространять
данную программу, невзирая на разного рода права и обязанности. Тем не менее автор не несет отвественности
за возможный причиненный ущерб от использования данного скрипта. Указывать в качестве автора какое-либо
другое лицо является большим заблуждением. Перехват логинов и паролей от AG и дальнейшее их использование
в личных целях — тоже.

Любые замечания и предложения направляйте в специальную ветку на AGFC:
  http://forums.ag.ru/?board=gameart&action=display&num=1231890438

Узнать о последних новостях и скачать новую версию можно на официальной странице скрипта:
  http://gameart.110mb.com/down.php

**********************************************************************************************************
*                                                                                                        *
* © 2007–2010                                                          Все права, вроде бы как, защищены *
*                                                                                                        *
**********************************************************************************************************