Arsse/UPGRADING

General upgrade notes
=====================

When upgrading between any two versions of The Arsse, the following are 
usually prudent:

- Back up your database
- Check for any changes to sample Web server configuration
- Check for any changes to sample systemd unit or other init files
- If installing from source, update dependencies with:
  `composer install -o --no-dev`
    

Upgrading from 0.10.4 to 0.10.5
=============================

- PHP 7.3 is now required
- Web server configuration in the Arch Linux package has been modified to ease
  the use of alternative PHP interpreters; please review the sample
  configuration files for changes


Upgrading from 0.10.2 to 0.10.3
=============================

- The following Composer dependencies have been removed:
    - laminas/laminas-diactoros


Upgrading from 0.8.5 to 0.9.0
=============================

- The database schema has changed from rev6 to rev7; if upgrading the database
  manually, apply the 6.sql file
- Web server configuration has changed to accommodate Miniflux; the following
  URL paths are affected:
    - /v1/
    - /version
    - /healthcheck
- Icons for existing feeds in Miniflux and Fever will only appear once the
  feeds in question have been fetched and parsed after upgrade. This may take
  some time to occur depending on how often the feed is updated
- An administrator account is now required to refresh feeds via the 
  Nextcloud News protocol


Upgrading from 0.8.4 to 0.8.5
=============================

- The sample configuration for Nginx has changed, to correct the omission of
  the QUERY_STRING FastCGI parameter in those passed to PHP. The omission
  affects the Fever protocol in particular (the parameter is required for 
  Fever to function at all), though it could potentially affect some
  Nextcloud News clients as well
    

Upgrading from 0.8.2 to 0.8.3
=============================

- PHP 7.1 is now required
- The following Composer dependencies have been added:
    - nicolus/picofeed
    - laminas/laminas-diactoros
    - laminas/laminas-httphandlerrunner
- The following Composer dependencies have been removed:
    - p3k/picofeed
    - zendframework/zend-diactoros
    - zendframework/zend-httphandlerrunner
    

Upgrading from 0.8.1 to 0.8.2
=============================

- The database schema has changed from rev5 to rev6; if upgrading the database
  manually, apply the 5.sql file


Upgrading from 0.7.1 to 0.8.0
=============================

- The database schema has changed from rev4 to rev5; if upgrading the database
  manually, apply the 4.sql file
- Web server configuration has changed to accommodate Fever; the following URL
  paths are affected:
    - /fever/
- The following Composer dependencies have been added:
    - zendframework/zend-diactoros (version 2.x)
    - zendframework/zend-httphandlerrunner


Upgrading from 0.5.1 to 0.6.0
=============================

- The database schema has changed from rev3 to rev4; if upgrading the database
  manually, apply the 3.sql file
- Configuration is now validated for type and semantics: some previously 
  working configurations may no longer be accepted


Upgrading from 0.2.1 to 0.3.0
=============================

- The following Composer dependencies have been added:
    - zendframework/zend-diactoros
    - psr/http-message


Upgrading from 0.2.0 to 0.2.1
=============================

- The database schema has changed from rev2 to rev3; if upgrading the database
  manually, apply the 2.sql file


Upgrading from 0.1.x to 0.2.0
=============================

- The database schema has changed from rev1 to rev2; if upgrading the database
  manually, apply the 1.sql file
- Web server configuration has changed to accommodate Tiny Tiny RSS; the
  following URL paths are affected:
    - /tt-rss/api/
    - /tt-rss/feed-icons/
    - /tt-rss/images/
- The following Composer dependencies have been added:
    - jkingweb/druuid