FreshRSS/README.md

FreshRSS

FreshRSS est un agrégateur de flux RSS à auto-héberger à l’image de Leed ou de Kriss Feed. Il se veut léger et facile à prendre en main tout en étant un outil puissant et paramétrable.

• Site officiel : http://marienfressinaud.github.io/FreshRSS/
• Démo : http://marienfressinaud.fr/projets/freshrss/
• Développeur : Marien Fressinaud dev@marienfressinaud.fr
• Version actuelle : 0.7-dev
• Date de publication 2013-12-xx
• License AGPL3

Disclaimer

Cette application a été développée pour s’adapter à des besoins personnels et non professionels. Je ne garantis en aucun cas la sécurité de celle-ci, ni son bon fonctionnement. Je m’engage néanmoins à répondre dans la mesure du possible aux demandes d’évolution si celles-ci me semblent justifiées. Privilégiez pour cela des demandes sur GitHub (https://github.com/marienfressinaud/FreshRSS/issues) ou par mail (dev@marienfressinaud.fr)

Pré-requis

• Serveur Apache2 ou Nginx (non testé sur les autres)
• PHP 5.2+ (PHP 5.3.3+ recommandé)
• Requis : LibXML, PCRE, cURL, PDO_MySQL
• Recommandés : JSON, zlib, mbstring, iconv
• MySQL 5.0.3+ (ou SQLite 3.7.4+ à venir)
• Un navigateur Web récent tel Firefox, Chrome, Opera, Safari, Internet Explorer 9+
• Fonctionne aussi sur mobile

Installation

1. Récupérez l’application FreshRSS via la commande git ou en téléchargeant l’archive
2. Placez l’application sur votre serveur (la partie à exposer au Web est le répertoire ./public)
3. Accédez à FreshRSS à travers votre navigateur Web et suivez les instructions d’installation
4. Tout devrait fonctionner :) En cas de problème, n’hésitez pas à me contacter.

Conseils

1. Pour une meilleure sécurité, faites en sorte que seul le répertoire ./public soit accessible depuis le Web, par exemple en faisant pointer un sous-domaine sur le répertoire ./public.
2. Les données sensibles se trouvent dans le répertoire ./data/ (déjà protégé par un .htaccess pour Apache - vérifiez que cela fonctionne -, à protéger vous-même dans le cas d’autres serveurs Web).
3. En cas de problème, les logs peuvent être utile à lire, soit depuis l’interface de FreshRSS, soit manuellement depuis ./data/log/*.log.
4. Le fichier ./constants.php définit les chemins d’accès aux répertoires clés de l’application. Si vous les bougez, tout se passe ici.
5. Vous pouvez ajouter une tâche CRON sur le script d’actualisation des flux. Il s’agit d’un script PHP à exécuter avec la commande php. Par exemple, pour exécuter le script toutes les heures :

7 * * * * php /chemin/vers/freshrss/actualize_script.php >/dev/null 2>&1