Outils pour utilisateurs

Outils du site


php:magnyaa

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentes Révision précédente
Prochaine révision
Révision précédente
php:magnyaa [2012-10-13 20:58]
mitsu [[ Download ]]
php:magnyaa [2014-09-07 15:14] (Version actuelle)
mitsu [[ Download ]]
Ligne 2: Ligne 2:
 ===== Lightweight magnet-link database mirror of Nyaa.eu ===== ===== Lightweight magnet-link database mirror of Nyaa.eu =====
  
-{{:php:magnyaa.png?direct&200|}}+{{:php:magnyaa1_0.png?direct&200|}}
  
 ---- ----
-**Status: initial development (alpha) **+**Status: 1.0 "The Internet Is Made Of Cats, Nyaa~ !" released; pausing **
  
 +[[#download|Jump to downloads]]
  
 ---- ----
Ligne 16: Ligne 17:
 The focus remains the same: provide a lightweight database mirror for NyaaTorrents (nyaa.eu), based on BitTorrent magnet links. Now the project is divided in 2 parts: the **engine** and the **browser**. The focus remains the same: provide a lightweight database mirror for NyaaTorrents (nyaa.eu), based on BitTorrent magnet links. Now the project is divided in 2 parts: the **engine** and the **browser**.
  
-**Magnyaa Engine**+=== Magnyaa Engine === 
  
 The Magnyaa Engine is written in **PHP5** and works with **SQLite3** databases. Each database contains up to 1000 torrent informations and weights ~130 kB (3 times more with complete updated data). The Engine responds with **JSON** messages. The Engine functions are: The Magnyaa Engine is written in **PHP5** and works with **SQLite3** databases. Each database contains up to 1000 torrent informations and weights ~130 kB (3 times more with complete updated data). The Engine responds with **JSON** messages. The Engine functions are:
Ligne 33: Ligne 35:
 The JSON response messages allows using Magnyaa Engine with many applications and languages, may it be PHP, Javascript, Python ... The JSON response messages allows using Magnyaa Engine with many applications and languages, may it be PHP, Javascript, Python ...
  
-**Engine Feeder**+=== Engine Feeder === 
  
 The Engine Feeder consists of 3 bash scripts and one PHP script (which is [[https://github.com/adriengibrat/torrent-rw/|torrent-rw]]). One bash script for each instance, plus a "cron-job script" to ease execution of both and avoid overlapping (since they use the same PHP resources). So you need a **GNU/Linux** machine with basic tools (wget, awk, head, sed,..), **php5-cli** and **httping**. Well actually you can replace httping with "wget --spider". But everything you need can be found on Debian, Ubuntu, Mandriva, Archlinux, Fedora,..  The Engine Feeder consists of 3 bash scripts and one PHP script (which is [[https://github.com/adriengibrat/torrent-rw/|torrent-rw]]). One bash script for each instance, plus a "cron-job script" to ease execution of both and avoid overlapping (since they use the same PHP resources). So you need a **GNU/Linux** machine with basic tools (wget, awk, head, sed,..), **php5-cli** and **httping**. Well actually you can replace httping with "wget --spider". But everything you need can be found on Debian, Ubuntu, Mandriva, Archlinux, Fedora,.. 
Ligne 44: Ligne 47:
  
  
-**Magnyaa Browser**+=== Magnyaa Browser === 
  
 The Magnyaa Browser is written in **PHP5** and parses JSON messages. The Magnyaa Browser is written in **PHP5** and parses JSON messages.
 +
 +Which of the "main" and "sukebei" instances is used is set in the config.php. Well actually the config.php defines quite much: name, Engine URL, export link display, links between instances, disclaimer text, headers, CSS, footer, Engine check, category code translation,.. Use a real text editor so you can easily find and read the comments :) Windows' default Notepad won't make it, absolutely not (prefer [[http://www.notepad-plus-plus.org/|Notepad++]])
 +
 +The provided download of Magnyaa Browser is pre-configured with the project's test Engine: just upload it and you're ready to go. But keep one thing in mind: **it's a test Engine, and retro-compatibility isn't our priority**. We may have designed the Engine so that it won't change much in the way of responding to requests, but keep an eye on updates: if your Magnyaa Browser suddenly shows "error with Engine.. is it one ?", update it.
 +
 +
 +Of course you can use your own Engine and feed it yourself, so you have a really independent mirror.
  
  
Ligne 58: Ligne 69:
  
   * {{:php:magnyaa_browser_1.0.zip|Magnyaa Browser 1.0}}   * {{:php:magnyaa_browser_1.0.zip|Magnyaa Browser 1.0}}
-  * Magnyaa Engine (soon) +  * {{:php:magnyaa_engine_1.0.zip|Magnyaa Engine 1.0}} 
-  * Magnyaa Engine SQLite3 databases (soon) +  * {{:php:nyaa_feeder.zip|Magnyaa Engine Feeders 1.0}}
-  * Magnyaa Feeders (soon)+
  
  
 ==== [ Installing and Updating ] ==== ==== [ Installing and Updating ] ====
 +
 +=== Browser ===
 +
 +  * upload
 +  * (customize config.php at will)
 +  * done !
 +  * update: replace index.php, compare and edit config.php, add any other file
  
  
 +=== Engine ===
  
  
 +  * RTFM. (it's included in the zip)
 ==== [ Changelog ] ==== ==== [ Changelog ] ====
  
Ligne 75: Ligne 94:
  
  
-==== [ Technical details for Engine ] ====+==== [ Engine technical details ] ====
  
  
Ligne 89: Ligne 108:
 data_#/{4 digits}.db: contains torrent data, up to 1000 elements data_#/{4 digits}.db: contains torrent data, up to 1000 elements
  
-As for now, # is "m" for main and "s" for sukebei. Data is stored and fetched in databases named like: torrent id divided by 1000; padded to 4 digits to the left with zeros. For example, "351540" would be in table "0351.db". This provides space for over 9 million torrent informations, more than a century time at Nyaa's actual pace ;-)+As for now, # is "m" for main and "s" for sukebei. Data is stored and fetched in databases named like: torrent id divided by 1000; padded to 4 digits to the left with zeros. For example, "351540" would be in database "0351.db". This provides space for over 9 million torrent informations, more than a century time at Nyaa's actual pace ;-)
  
 ---- ----
Ligne 98: Ligne 117:
 Note: if {id} is starting with "s", the considered instance is "sukebei". Else, "main". Note: if {id} is starting with "s", the considered instance is "sukebei". Else, "main".
  
-//no query//: empty page+//no query//: empty page (actually useful: the HTTP header "X-Magnyaa: engineX" that tells Browser it's an Engine and it is of version X)
  
 //?nyaaid={id}//: check if existing database, load it, SELECT the {id}, parse data, output in JSON //?nyaaid={id}//: check if existing database, load it, SELECT the {id}, parse data, output in JSON
Ligne 125: Ligne 144:
 The Engine Feeder uses torrent-rw, published under GNU GPLv3 by Adrien Gibrat: https://github.com/adriengibrat/torrent-rw/ The Engine Feeder uses torrent-rw, published under GNU GPLv3 by Adrien Gibrat: https://github.com/adriengibrat/torrent-rw/
  
-Magnyaa in itself is neutral and automated, the developers can't be held liable for any misuse of the software.+Magnyaa in itself is neutral and automated, the developers can't be held liable for any misuse of the software. If Nyaa.eu's team made mistakes, well.. blame them. Magnyaa is a "set up and forget" thing.
  
  
 ==== [ Contact ] ==== ==== [ Contact ] ====
  
-Bug report, feature requests, love declarations ? Head over here:+Bug report, feature requests, anything else ? Head over here:
  
 http://www.suumitsu.eu/contact  (don't mind the french stuff, just proceed) http://www.suumitsu.eu/contact  (don't mind the french stuff, just proceed)
  
php/magnyaa.1350154693.txt.gz · Dernière modification: 2013-02-19 21:28 (modification externe)