% Global configuration

All settings (see `_DEFAULTS[]` for default values) are listed here:

- https://srv.tt-rss.org/ttrss-docs/classes/Config.html (auto-generated class documentation) 
- https://git.tt-rss.org/fox/tt-rss/src/branch/master/classes/config.php (source code, including defaults)

---------------

It is preferred to adjust tt-rss global configuration through the environment, i.e. defined in `.env` when using docker-compose setup.

Alternatively, you can use `config.php` (copied from `config.php-dist`) - use the following syntax:

```php
putenv('TTRSS_DB_HOST=myserver');
putenv('TTRSS_SELF_URL_PATH=http://example.com/tt-rss');
putenv('TTRSS_SESSION_COOKIE_LIFETIME='.(86400*30));
```

Regardless of method used, options should be always prefixed by `TTRSS_`.

Note lack of quotes around values. Legacy plugin-required constants also go here, using `define()`:

```php
define('LEGACY_CONSTANT', 'value');
```

To set computed values via `putenv()` you have to get them evaluated by PHP, this would work:

```php
putenv('TTRSS_SESSION_COOKIE_LIFETIME='.(86400*30));
```

However, these won't give you expected results:

```php
putenv("TTRSS_SESSION_COOKIE_LIFETIME='2592000'");
# => 0, because '2592000' is an invalid number

putenv('TTRSS_SESSION_COOKIE_LIFETIME=86400*30');
# => 86400, because expression is not evaluated, so you're just casting a string literal "86400*30" to integer
```

Note that all values should be precomputed when setting via `.env` because they are not evaluated by PHP and used as-is.

## Migrating from old-style config.php

For any `config.php` settings you have changed from the defaults (normally this is the `DB_` group of settings and `SELF_URL_PATH`, replace as follows, using the rules above:

`define('DB_PORT', 'xxx')` → `putenv('TTRSS_DB_PORT=xxx')`.

You can safely omit any settings that were at default values.

[This thread](https://community.tt-rss.org/t/rip-config-php-hello-classes-config-php/4337/30) has relevant discussion and many examples.