Do not use STDOUT and STDERR constants
[phinde.git] / README.rst
index 071f42d985a8d14211c61cd9c121533b9543028f..cd3641b96d55b1b19e2303ab6bc5761a69f0d3c8 100644 (file)
@@ -36,28 +36,27 @@ Features
 ============
 Dependencies
 ============
-- PHP 5.5+
+- PHP 8.x
 - Elasticsearch 2.0
 - MySQL or MariaDB for WebSub subscriptions
 - Gearman (Debian 9: ``gearman-job-server``, not ``gearman-server``)
+- ``gearadmin`` command line tool (``gearman-tools`` package)
 - PHP Gearman extension
-- Console_CommandLine
-- Net_URL2
-- Twig 1.x
+- Some PHP libraries that get installed with composer
 
 
 =====
 Setup
 =====
 #. Install and run Elasticsearch and Gearman
-#. Install ``php-gearman``
+#. Install ``php-gearman`` and ``gearman-tools``
 #. Get a local copy of the code::
 
      $ git clone https://git.cweiske.de/phinde.git phinde
 
 #. Install dependencies via composer::
 
-     $ composer install
+     $ composer install --no-dev
 
 #. Point your webserver's document root to phinde's ``www`` directory
 #. Copy ``data/config.php.dist`` to ``data/config.php`` and adjust it.
@@ -144,6 +143,27 @@ That's delete-by-query 2.0, see
 https://www.elastic.co/guide/en/elasticsearch/plugins/2.0/delete-by-query-usage.html
 
 
+Subscribe to a website/feed
+===========================
+Phinde supports WebSub__ to get subscribe to changes of a website.
+When phinde gets notified by the website's hub about changes,
+it will immediately crawl and index the changed pages.
+
+Subscribe to a website's feed::
+
+    $ php bin/subscribe.php http://example.org/feed.atom
+
+Phinde will determine the website's hub and send a registration request to it.
+
+The status page will show the number of working, and the number of open
+subscriptions.
+
+Unsubscribing also happens on command line::
+
+    $ php bin/unsubscribe.php http://example.org/feed.atom
+
+__ https://www.w3.org/TR/websub/
+
 ============
 About phinde
 ============