Download the PHP package boruta/timebase without Composer
On this page you can find all versions of the php package boruta/timebase. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download boruta/timebase
More information about boruta/timebase
Files in boruta/timebase
Package timebase
Short Description Flat file database for storage any data as events in timeline and finding it for a given timestamp.
License MIT
Informations about the package timebase
TimeBase
Flat file database for storage any data as events in timeline and finding it for a given timestamp.
Table of contents
- Description
- Requirements
- Installation
- Usage
- Quick introduction
- Details
- Extra logger in constructor
- Data types
- Setting the storage namespace
- Inserting data for specific timestamp
- Searching data for specific timestamp
- Getting multiple records with the same timestamp
- Searching strategies
- Tests
Description
The data are stored in files, with the possibility of using multi-level namespaces - in this case, the files are stored in subdirectories. Each day is stored in a separate file named YYYY-MM-DD.tb
.
The data records are searched using a binary search algorithm, so it's quick and doesn't require loading the entire file into memory. Each record is one line in file, in format {timestamp}/{data}
(data
is result of base64_encode(json_encode(...))
). The records are sorted, and you can add multiple records for one timestamp - they are saved and returned in the order they were added.
There are many use cases for such a database, e.g. storing stock exchange data (volumes, price values etc.) for trading strategy backtesting.
Requirements
Package requires PHP >= 7.3 and ext-json installed.
Installation
Install the library using Composer. Please read the Composer Documentation if you are unfamiliar with Composer or dependency managers in general.
Usage
Quick introduction
Creating database instance. First constructor argument is a path where to store database files.
Inserting data (for current timestamp) :
Getting last inserted data (last record):
You will get array as result, with keys timestamp
and value
:
Details
Extra logger in constructor
You can optionally give the second argument which is a logger object, compatible with Psr\Log\LoggerInterface
. The application append logs only in case of errors.
Data types
The data can be of any native type, e.g. int
, string
, array
. When searching for data, they will be of the same type.
Setting the storage namespace
You can store your data in different storages on many levels. Please use the method ->storage(array $storage)
to set this.
Examples of inserting data into specific storage:
Examples of reading data from specific storage:
Inserting data for specific timestamp
To add data for a given timestamp (not the current) use the method ->timestamp(int $timestamp)
. Example:
Searching data for specific timestamp
To find a record for a specific timestamp use the method ->timestamp(int $timestamp)
during search query:
In the default strategy, you will get one record that is closest to the timestamp you entered.
Getting multiple records with the same timestamp
If you have more than one record with the same timestamp you can retrieve them using the ->all()
method.
In the result array there will be an additional key all
containing all records for given timestamp, in the order in which they were added:
Searching strategies
Nearest (default)
The default strategy returns the record with the nearest timestamp to the given one. Usage (is not necessary as it is the default):
If the time distance is the same for two records, you will get the earlier one.
Exact
If there is no record for the timestamp you provided, you will get null
value. There must be a record in the database with exactly the same timestamp.
Earlier
If there is no record for the timestamp you entered, you will get the closest one before that timestamp or null
.
Later
If there is no record for the timestamp you entered, you will get the closest one after that timestamp or null
.
Tests
To run the tests in the package, execute the following command:
After a while you will get the result, example: