—крыть меню * ¬ерси€ дл€ печати

Ћегковесна€ библиотека PostcalcLight

PostcalcLight - это библиотека дл€ работы с Postcalc.RU и простой веб-интерфейс в одном архиве.
PostcalcLight объ€вл€етс€ public domain, то есть вы можете использовать его в своих проектах полностью или частично без ограничений.

ќпробовать PostcalcLight в работе онлайн
ѕосмотреть статистику работы PostcalcLight
—качать документацию
ƒокументаци€ онлайн

Ѕиблиотека легковесна€, в сжатом виде - менее 30  б в архиве, основна€ функци€ опроса - около 60 строк кода.
Ќачина€ с версии 2.0 (декабрь 2015 г.) база данных скачиваетс€ отдельно. ќна предоставл€етс€ в двух форматах на выбор: простых текстовых файлов (аналогично версии 1.x) и дампа MySQL.

«ј√–”« ј

ƒл€ кодировки UTF-8:
http://www.postcalc.ru/download/PostcalcLight_UTF8.zip - последн€€ верси€ программы, 26  б.
http://www.postcalc.ru/download/PostcalcLight_UTF8_TXT.zip - последн€€ верси€ базы данных в формате TXT, около 640  б.

ƒл€ кодировки Windows-1251:
http://www.postcalc.ru/download/PostcalcLight_cp1251.zip - последн€€ верси€ программы, 24  б.
http://www.postcalc.ru/download/PostcalcLight_cp1251_TXT.zip - последн€€ верси€ базы данных в формате TXT, около 570  б.

ƒл€ любой кодировки:
http://www.postcalc.ru/download/PostcalcLight_SQL.zip - последн€€ верси€ базы данных в формате дампа MySQL, около 670  б.

¬се приведенные выше ссылки €вл€ютс€ символьными ссылками на самую последнюю версию программы или базы данных. ѕри желании вы можете настроить скрипты на вашем сайте дл€ обновлени€ в автоматическом режиме.
¬се существующие версии можно посмотреть по ссылке:
http://www.postcalc.ru/download/PostcalcLight/

Ѕазы данных основаны на "Ёталонном справочнике" ѕочты –оссии:
http://vinfo.russianpost.ru/database/ops.html

ќни обновл€ютс€ один раз в год. Ѕольшого смысла обновл€ть их часто нет, так как изменени€ обычно не касаютс€ клиентов: добавл€ютс€/измен€ютс€ технические индексы, которые используютс€ во внутренней обработке ѕочты –оссии.

ѕо практике, достаточно обновл€ть базы раз в квартал.

Ѕј«ј ƒјЌЌџ’

 акой формат выбрать (SQL или TXT) - дело больше вкуса.

“екстовые файлы не требуют дополнительной настройки и доступа к базе данных, работают сразу "из коробки".

Ѕаза MySQL дает возможность интеграции с другими вашими проектами.

¬ы можете просмотреть список используемых названий населенных пунктов, стран и почтовых индексов онлайн: 1. ‘айлы в формате текста, разделенного табул€цией, и соответствующие индексные файлы:
postcalc_light_cities.txt
postcalc_light_cities.idx
postcalc_light_post_indexes.txt
postcalc_light_post_indexes.idx
postcalc_light_countries.txt

’от€ файлы имеют вид обычного текста, измен€ть их нельз€, так как это приведет к нарушению функционировани€.

ƒл€ настройки пишем в конфигурационном файле postcalc_light_config.php:
'source' => 'txt',
'txt_dir' => __DIR__,

≈сли файлы баз данных наход€тс€ в том же каталоге, что и файл postcalc_light_lib.php, то параметр txt_dir можно оставить как есть, то есть __DIR__. »наче укажите полный маршрут к ним.

2. ƒамп базы данных MySQL postcalc_light.sql. ≈го необходимо импортировать в текущую базу данных через phpmyadmin или войти в каталог PostcalcLight и выполнить из командной строки:
mysql -uпользователь -pпароль база_данных < postcalc_light.sql 
ƒл€ настройки пишем в конфигурационном файле postcalc_light_config.php:
'source' => 'mysql',
'mysql_host' => 'localhost',    // ƒл€ mysql: им€ хоста
'mysql_user' => 'testuser',     // ƒл€ mysql: им€ пользовател€ Ѕƒ
'mysql_pass' => 'testpass',     // ƒл€ mysql: пароль пользовател€ Ѕƒ
'mysql_db'   => 'postcalc',     // ƒл€ mysql: им€ базы данных

»«ћ≈Ќ≈Ќ»я

¬≈–—»я 2.0 - 25 декабр€ 2015.
1. ƒобавлены конфигурационные параметры city_as_pindex и dir_txt. Ёти переменные об€зательно должны присутствовать в конфигурационном файле!

2. »зменен формат баз данных - теперь это стандартный Tabbed Separated Values, который можно импортировать в Ѕƒ SQL. ƒл€ баз данных postcalc_light_post_indexes.txt и postcalc_light_cities.txt генерируютс€ индексные файлы с тем же именем и расширением .idx. Ќе удал€йте их и не вносите изменени€ в эти файлы - это приведет к сбою.

3. ”далена база данных postcalc_light_locations.txt. ѕоддержка названий регионов типа 'Ћенинградска€ область' пока сохран€етс€ на уровне API, однако в будущем может быть также прекращена. ¬ планируемом API 2.0 будут стандартно поддерживатьс€ либо 6-значные индексы, либо названи€ населенных пунктов из postcalc_light_cities.txt.

¬≈–—»я 2.1 - 26 €нвар€ 2016.
1. ќткорректирован принцип, по которому формируютс€ названи€ населенных пунктов из трех частей: 3-€ часть теперь строго следует официальному справочнику ќ “ћќ.

2. »справлены небольшие ошибки в коде.

¬≈–—»я 2.2 - 28 июн€ 2016.

»зменени€ в дизайне клиента. Ѕиблиотека не изменилась.

1. ƒобавлен конфигурационный параметр debug. ≈сли 1 - под таблицей с тарифами выводитс€ полный массив ответа сервера. ѕеременна€ [_server][REMOTE_ADDR] содержит реальный IP, с которого ушел запрос клиента.

2. ƒобавлен конфигурационный параметр arrColumns. ћожно включать/отключать вывод следующих колонок таблицы:  оличество, ƒоставка, ÷енность, —рок доставки.

3. ƒобавлены кофигурационные параметры skin и arrSkins. ѕараметр skin - выбор одной из 24 доступных тем оформлени€ из стандартной библиотеки jQuery UI. ƒоступные темы можно посмотреть по ссылке:
http://jqueryui.com/themeroller/

4. ƒобавлен конфигурационный параметр arrParcels - список всех возможных отправлений. „тобы ненужные виды отправлений не выводились в итоговой таблице, просто закомментируйте их в arrParcels.

5. ≈сли доставка в конечный пункт имеет сезонные ограничени€, выводитс€ таблица с информацией по ограничени€м.

ќ—Ќќ¬Ќџ≈ ¬ќ«ћќ∆Ќќ—“»

  • ћожно скачать два варианта базы данных: в формате простого текста, разделенного табул€цией, и формате дампа MySQL. ѕо умолчанию программа настроена на базу в формате текста и работает "из коробки", без дополнительных настроек.
    Ѕазы данных сгенерированы на основе Ёталонного справочника ѕочты –оссии и обновл€ютс€ в автоматическом режиме.
  • ѕроверка аргументов на правильность. ќтправитель и получатель провер€ютс€ по прилагаемым базам данных в формате простых текстовых файлов: postcalc_light_post_indexes.txt и postcalc_light_locations.txt. —трана провер€етс€ по файлу postcalc_light_сountries.txt.
  • ѕравильное перекодирование аргументов.
  • ќпрос в цикле доступных серверов проекта Postcalc.RU - если один сервер недоступен, запрашиваетс€ следующий.
  • –азархивирование ответа и перевод его в массив PHP.
  •  эширование правильного ответа.
  • Ќастройка всех необходимых параметров в конфигурационном файле.
  • ƒл€ дизайна была использована тема Start из стандартной библиотеки jQuery UI. ѕри желании ее можно заменить на любую другую из 24 тем библиотеки.
  • јвтодополнение индекса отделени€ св€зи и местоположени€ дл€ полей "ќткуда" и " уда".
  • Javascript необ€зателен - он используетс€ только в автодополнении и некоторых элементах дизайна.
  • ¬едение журнала успешных и неуспешных соединений. —крипт postcalc_light_stat.php позвол€ет просматривать статистику по мес€цам и дн€м, скрипт postcalc_light_view_log.php - журналы (они разбиты по мес€цам).
    ≈сли число ошибок превышает 10, на контактный email отсылаетс€ извещение (параметр error_log_send).

»—ѕќЋ№«ќ¬јЌ»≈

1. –азархивируйте PostcalcLight_UTF8.zip или PostcalcLight_cp1251.zip в каталог веб-сервера.

2. Ќастройте базу данных.

≈сли вы предпочитаете работать с базой в формате текстовых файлов, разархивируйте содержимое PostcalcLight_UTF8_TXT.zip или PostcalcLight_cp1251_TXT.zip в тот же каталог.

≈сли вы выбрали работу с сервером MySQL, скачайте и разархивируйте PostcalcLight_SQL.zip. «атем воспользуйтесь дл€ импорта дампа программой phpmyadmin или войдите в каталог PostcalcLight и выполните из командной строки:
mysql -uпользователь -pпароль база_данных < postcalc_light.sql 
ƒалее укажите им€ сервера, название базы данных, логин и пароль в конфигурационном файле postcalc_light_config.php.

3. ƒл€ проверки откройте в веб-браузере страницу /PostcalcLight/postcalc_light_test.php - она обратитс€ к серверу Postcalc.RU, использу€ библиотеку PostcalcLight, и, если все в пор€дке, нарисует таблицу.

4. ќткройте в веб-браузере страницу /PostcalcLight/postcalc_light.php - это простой клиент дл€ работы с Postcalc.RU.

5. ќкончательно настройте клиент в рабочем режиме: откройте файл postcalc_light_config.php и правильно заполните значение следующих переменных:
  1. st - Ќазвание сайта, без http: и слэшей
  2. ml -  онтактный email. —амый принципиальный параметр. ќб€зательно проверьте, доходит ли почта с сервера Postcalc.RU на данный почтовый €щик:
    http://www.postcalc.ru/check_email.php
  3. default_from - ѕочтовое отделение отправител€ по умолчанию.
“акже вы можете изменить значение других переменных запроса - их описание имеетс€ в файле postcalc_light_config.php.

6. —ледите за работой библиотеки через /PostcalcLight/postcalc_light_stat.php.


(c) PostCalc.RU 2010-16



яндекс.ћетрика

Time elapsed: 0.02178