cops

ตำรวจ

COPS ย่อมาจาก Calibre OPDS (และ HTML) Php Server

ดู : บ้านของ COPS สำหรับรายละเอียดเพิ่มเติม

อย่าลืมตรวจสอบวิกิ

ทำไม ?

ในความคิดของฉัน Caliber เป็นเครื่องมือที่ยอดเยี่ยมแต่มีขนาดใหญ่เกินไปและมีการพึ่งพามากเกินไปที่จะใช้สำหรับเซิร์ฟเวอร์เนื้อหา

นั่นคือเหตุผลหลักว่าทำไมฉันถึงเขียนโค้ดเซิร์ฟเวอร์ OPDS นี้ ฉันต้องการเครื่องมือง่ายๆ เพื่อติดตั้งบนเซิร์ฟเวอร์ขนาดเล็ก (ในกรณีของฉันคือ Seagate Dockstar)

ตอนแรกฉันนึกถึง Calibre2OPDS แต่เนื่องจากมันสร้างไฟล์คงที่ จึงไม่สามารถค้นหาได้

ต่อมาฉันได้เพิ่มแค็ตตาล็อก HTML แบบง่าย ๆ ที่ควรใช้กับ Kobo ของฉัน

ดังนั้นข้อดีหลักของ COPS คือ:

• ไม่จำเป็นต้องพึ่งพาอะไรมากมาย
• ไม่จำเป็นต้องใช้ CPU หรือ RAM จำนวนมาก
• รหัสไม่มาก.
• ค้นหาได้
• การเขียนโค้ดเป็นเรื่องสนุก

หากคุณต้องการใช้ฟีด OPDS อย่าลืมระบุ feed.php ที่ท้าย URL ของคุณ

คุณเพียงแค่ต้องซิงค์ไดเร็กทอรี Calibre ของคุณกับเซิร์ฟเวอร์ COPS ตามที่คุณต้องการ (Dropbox, Bt Sync, Syncthing, ใช้ไดเร็กทอรีที่แชร์กับ Nextcloud, ...)

ข้อกำหนดเบื้องต้น

1. PHP 5.3, 5.4, 5.5, 5.6, 7.X หรือ hhvm พร้อมการประมวลผลภาพ GD, รองรับ Libxml, Intl, Json และ SQLite3 (แนะนำ PHP 5.6 หรือใหม่กว่า)
2. เว็บเซิร์ฟเวอร์ที่รองรับ PHP ฉันทดสอบกับ Nginx และ Apache เวอร์ชันต่างๆ คนอื่นรายงานว่าทำงานร่วมกับ Apache และ Cherokee คุณยังสามารถใช้เซิร์ฟเวอร์ฝังตัว PHP ได้ (https://github.com/seblucas/cops/wiki/Howto---PhpEmbeddedServer)
3. เส้นทางไปยังไลบรารีลำกล้อง (metadata.db, รูปแบบ และไฟล์หน้าปก)

บน Linux ที่ใช้ Debian คุณสามารถใช้: apt-get install php5-gd php5-sqlite php5-json php5-intl

หากคุณใช้ Debian Stretch : apt-get install php7.0-gd php7.0-sqlite3 php7.0-json php7.0-intl php7.0-xml php7.0-mbstring php7.0-zip

บน Centos คุณอาจต้องเพิ่ม : yum install php-xml

ติดตั้งรีลีส (วิธีที่ง่ายที่สุด)

1. แยกไฟล์ zip ที่คุณได้รับจากหน้าเผยแพร่ไปยังโฟลเดอร์ในพื้นที่เว็บ (เว็บเซิร์ฟเวอร์มองเห็นได้)
2. หากคุณกำลังทำการติดตั้งครั้งแรก ให้คัดลอก config_local.php.example ไปที่ config_local.php
3. แก้ไข config_local.php ให้ตรงกับการกำหนดค่าของคุณ
4. หากจำเป็นให้เพิ่มรายการการกำหนดค่าอื่นจาก config_default.php

หากคุณชอบ Docker คุณสามารถลองใช้คอนเทนเนอร์ docker แบบ multiarch ได้จาก linuxserver.io ซึ่งมี builds สำหรับ x64, armhf และ arm64

ติดตั้งจากแหล่งที่มา

git clone https://github.com/seblucas/cops.git # or download lastest zip see below
cd cops
wget https://getcomposer.org/composer.phar
php composer.phar global require " fxp/composer-asset-plugin:~1.1 "
php composer.phar install --no-dev --optimize-autoloader

หลังจากนั้นคุณสามารถใช้วิธีการก่อนหน้าโดยเริ่มจากขั้นตอนที่ 2

โปรดทราบว่าแทนที่จะโคลนนิ่ง คุณสามารถรับต้นแบบล่าสุดเป็น zip ได้

โปรดทราบว่าหากเวอร์ชัน PHP ของคุณต่ำกว่า 5.6 คุณอาจต้องลบ composer.lock ก่อนที่จะเริ่มบรรทัดสุดท้าย

จะใส่ไดเร็กทอรี Caliber ของฉันได้ที่ไหน?

เรื่องสั้นเรื่องยาว : อยู่นอกไดเรกทอรีของ COPS เสมอ โดยเฉพาะอย่างยิ่งหากมีการติดตั้ง COPS บน VPS / เซิร์ฟเวอร์ หากคุณทำตามคำแนะนำของฉัน ข้อมูลของคุณจะปลอดภัย

หากคุณเลือกที่จะใส่ไดเร็กทอรี Caliber ของคุณไว้ในไดเร็กทอรีเว็บของคุณและใช้ Nginx คุณจะต้องแก้ไข /etc/nginx/mime.types เพื่อเพิ่มบรรทัดเหล่านี้:

 application/epub+zip epub;
application/x-mobipocket-ebook mobi prc azw;

ปัญหาที่ทราบ

ไม่มาก ยกเว้นคุณภาพโค้ดที่ไม่ดี (โปรเจ็กต์ PHP แรกสุดที่เคยมีมา) ;)

โปรดดู https://github.com/seblucas/cops/issues สำหรับปัญหาที่เปิดอยู่

ต้องการความช่วยเหลือ

โปรดอ่าน https://github.com/seblucas/cops/wiki และตรวจสอบคำถามที่พบบ่อย

มีส่วนร่วม

อย่างที่คุณเห็นที่นี่ ฉันซาบซึ้งกับทุกการมีส่วนร่วมและมีจำนวนมากเมื่อเวลาผ่านไป ดังนั้นอย่าอายและส่งคำขอดึงของคุณ

หมายเหตุถึงนักแปล : โปรดเลือกใช้ Transifex แทนการประชาสัมพันธ์

ฉันมีขีดจำกัดเดียวเท่านั้น (ฉันอาจมีมากกว่านั้นแต่อันนั้นแย่กว่านั้น): เป้าหมายของ COPS คือการจัดหาทางเลือกให้กับเซิร์ฟเวอร์เนื้อหาของ Calibre และไม่แทนที่ Calibre ทั้งหมด ดังนั้นฉันจะปฏิเสธการประชาสัมพันธ์ใด ๆ ที่ทำการเปลี่ยนแปลงเนื้อหาฐานข้อมูล

เครดิต

• การจัดการข้อความสถานที่ได้รับแรงบันดาลใจจากhttps://www.mind-it.info/2010/02/22/a-simple-approach-to-localization-in-php
• ฟังก์ชั่น str_format มาจาก http://tmont.com/blargh/2010/1/string-format-in-php
• ไอคอนทั้งหมดมาจาก Font Awesome: https://github.com/FortAwesome/Font-Awesome
• เครื่องมือตรวจสอบ OPDS อย่างไม่เป็นทางการ: http://opds-validator.appspot.com/
• ขอขอบคุณผู้ทดสอบ ผู้แปล และผู้ร่วมให้ข้อมูลทุกคน
• ไอคอนฟีดที่สร้างโดย Freepik จากเว็บไซต์ Flaticon ที่ได้รับอนุญาตภายใต้ Creative Commons BY 3.0 http://www.flaticon.com และ http://www.freepik.com
• ขอขอบคุณ Jetbrains เป็นอย่างยิ่งที่ให้การสนับสนุน COPS โดยมอบชุดใบอนุญาตฟรีให้กับผลิตภัณฑ์ของตนมาหลายปีแล้ว!
• โปรเจ็กต์นี้ได้รับการทดสอบด้วย BrowserStack

ไลบรารีภายนอกที่ใช้:

• เจคิวรี : http://jquery.com/
• ป๊อปอัปอันงดงาม: http://dimsemenov.com/plugins/magnific-popup/
• Php-epub-meta : https://github.com/splitbrain/php-epub-meta พร้อมการแก้ไขบางอย่างโดยฉัน (https://github.com/seblucas/php-epub-meta)
• TbsZip : http://www.tinybutstrong.com/apps/tbszip/tbszip_help.html
• Dot.js : http://olado.github.io/doT/index.html
• PHPMailer : https://github.com/PHPMailer/PHPMailer
• js-lru : https://github.com/rsms/js-lru

ลิขสิทธิ์และใบอนุญาต

COPS - 2012-2019 (c) เซบาสเตียน ลูคัส

ดูการคัดลอกและส่วนหัวของไฟล์สำหรับข้อมูลใบอนุญาต