index/README.md

52 lines
2.2 KiB
Markdown

# Index
Index is a common library for my PHP projects.
It provides a number of components that I would otherwise copy between projects (and thus become out-of-sync) as well as a number of quality of life things on top of standard PHP stdlib functionality.
## Requirements and Dependencies
Index currently targets **PHP 8.3** with the `mbstring` extension installed.
### `Index\Cache\Memcached`
Requires either the `memcached` or `memcache` extension, if both are installed the `memcached` based implementation will be used.
For full functionality you will want the `memcached` implementation.
The way each implementation stores data is NOT guaranteed to be compatible, please do not mix them.
### `Index\Cache\Valkey`
Requires the `redis` extension.
Valkey is the name of the Linux Foundation's fork of Redis.
### `Index\Data\MariaDB`
Requires the `mysqli` extension.
`mysqlnd` is recommended as the underlying driver, but `libmysql` should work without a hitch.
This driver also works for MySQL as the dependencies would suggest, but you should consider using MariaDB instead of possible.
### `Index\Data\SQLite`
Requires the `sqlite3` extension.
## Versioning
Index versioning will mostly follow the [Semantic Versioning specification v2.0.0](https://semver.org/spec/v2.0.0.html), counting dropped support for a minor PHP version (e.g. 7.1 -> 7.2 or 7.4 -> 8.0) as a reason to increment the major version.
Previous major versions may be supported for a time with backports depending on what projects of mine still target older versions of PHP.
The version is stored in the root of the repository in a file called `VERSION` and can be read out within Index using `Index\Environment::getIndexVersion()`.
## Contribution
By submitting code for inclusion in the main Index source tree you agree to transfer ownership of the code to the project owner.
The contributor will still be attributed for the contributed code, unless they ask for this attribution to be removed.
This is to avoid intellectual property rights traps and drama that could lead to blackmail situations.
If you do not agree with these terms, you are free to fork off.
## Licencing
Index is available under the BSD 3-Clause Clear License, a full version of which is enclosed in the LICENCE file.