Установка COPSFB на компьютер с Windows

Здесь описан путь самый легкий и быстрый, но не самый правильный. Если у вас есть опыт установки и настройки веб-серверов, логичнее будет сделать все самому, а не использовать готовую сборку. Так что это инструкция исключительно для новичков, которые хотят быстро получить результат.

  1. На компьютере с Windows у вас должна быть установлена MyHomeLib. Посмотрите в программе (меню Коллекция->Свойства коллекции), где лежит "Файл коллекции" и как он называется.
  2. Скачиваем XAMPP для Windows, на текущий момент это версия 1.8.3 / PHP 5.5.11, с ней я тестировал, все работает. Устанавливаем в c:\xampp\. Обязательные опции при установке - Apache и PHP, остальное по вашему желанию, при работе пакета они не используются. (Во время установки будут выданы два предупреждения: первое о том, что желательно отключить антивирус для ускорения работы, второе - рекомендация не устанавливать в Program Files").
  3. После установки XAMPP запускаем Apache нажатием кнопки "Start".
  4. Если у вас не установлен на компьютере 7-zip, то скачиваем и устанавливаем, желательно в папку типа c:\7-zip\, но необязательно, просто если устанавливать в Program Files, то потом могут быть проблемы с длинными путями
  5. Скачиваем zip архив с COPSFB с этой страницы. Сохраняем в корне веб-сервера, т.е. c:\xampp\htdocs\. Распаковываем архив, после распаковки у вас должна получиться папка со скриптами c:\xampp\htdocs\copsfb\.
  6. Желательно, хотя и не обязательно, сделать копию БД MyHomeLib чтобы COPSFB работал с копией базы, тогда ее можно почистить, что ускорит работу. Как называется и где лежит файл коллекции вы должны были посмотреть в п.1. Пример команды копирования:
    1. copy c:\MyHomeLib\Data\librusec_local_fb2.hlc2 c:\xampp\htdocs\copsfb\lib\
  7. Настройки COPSFB находятся в файле c:\xampp\htdocs\copsfb\config_local.php Редактируем их. Для редактирования файлов рекомендуется использовать программу notepad++.
    1. В конфиге два слеша подряд // - это комментарии. Поскольку я использую программу и на Windows и на NAS, в конфиге по умолчанию раскомментированы параметры для linux, вам необходимо их отредактировать.
    2. ОБЯЗАТЕЛЬНО настройте следующие параметры:
      1. $config['calibre_directory'] = "c:\\Books\\Lib.Rus.Ec and MyHomeLib[FB2]\\lib.rus.ec\\" ; $config['myhomelib_database'] = './lib/librusec_local_fb2.hlc2'; $config['shell_exec_unzip'] = TRUE; $config['shell_exec_cmd'] = c:\\7-Zip\\7z.exe e -so ';
    3. Здесь примеры путей, вам нужно указать свои! Описание параметров на этой странице. Для флибусты так же изменится параметр 'myhomelib_database'.
  8. Правильно настроенных этих 4 параметров достаточно, чтобы сервер запустился. Проверяем в браузере:
    1. http://localhost/copsfb/
  9. При указании адреса в opds клиентах адрес сервера надо указывать как
    1. http://адрес_компьютера/copsfb/feed.php
  10. Опция 1. Запуск сервера автоматом после перезагрузки: В консоли администрирования Xampp нажимаем "Config" которая большая и справа и ставим галочку возле пункта Apache. Копируем ярлык на Xampp в каталог автозапуска Windows. Делаем автовход в систему Windows (для случая непредвиденной перезагрузки).
  11. Опция 2. Включение авторизации: в файле "C:\xampp\copsfb\htdocs" раскомментируем строки и меняем путь:
    1. <FilesMatch "\.php$"> AuthUserFile C:\xampp\htdocs\copsfb\.htpasswd AuthGroupFile /dev/null AuthName "Acces securise" AuthType Basic Require valid-user </FilesMatch>
  12. По умолчанию пользователь\пароль reader\reader
  13. Опция 3. Создание новых пользователей: Запускаем консоль: Пуск - "CMD"
    1. C:\Windows\system32>cd \ C:\>cd c:\xampp c:\xampp>cd apache c:\xampp\apache>cd bin
  1. Создаем свой файл и нового пользователя (в примере lib)
    1. htpasswd -c C:\xampp\htdocs\copsfb\.htpasswd lib
  1. Дважды вводим пароль. Для того, чтоб поменять пароль у уже существующего пользователя достаточно сделать
    1. htpasswd С:\xampp\htdocs\copsfb\.htpasswd lib
  1. Добавляем пользователя lib2 (для красоты, ну или кому-то может понадобиться)
    1. htpasswd C:\xampp\htdocs\copsfb\.htpasswd lib2
  1. Что бы посмотреть существующих пользователей: открываем файл блокнотом и каждая строка до двоеточия - это его имя, пароль зашифрован.
  2. Опция 4. Переадресация портов на роутере. Возможна при наличии белого ip (Настройки для Asus прошивка энтузиастов): Найти пункт NAT Setting - Virtual Server

В таблицу ниже вводим:

    • Source IP (оставляем пустым)
    • Port Range (придумываем номер порта, желательно использовать 1024—49151)
    • Local IP 192.168.0.89 (подставить свое значение ip адрес локальной машины)
    • Local Port - 80
    • Protocol - TCP
    • Protocol No. - (оставляем пустым)
    • Description - название правила у меня lib

Нажимаем последовательно три кнопки: ADD, APPLY, FINISH

Для обращения к библиотеке извне используем строку в браузере:

http:\\xxx.xxx.xxx.xxx:yyyy\copsfb

где xxx.xxx.xxx.xxx ваш внешний IP, а yyyy номер порта