Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/andersundsehr/lucene-cache
https://github.com/andersundsehr/lucene-cache
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/andersundsehr/lucene-cache
- Owner: andersundsehr
- Created: 2024-04-22T15:17:27.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2024-07-22T11:10:10.000Z (5 months ago)
- Last Synced: 2024-10-31T14:42:56.257Z (about 2 months ago)
- Language: PHP
- Size: 147 KB
- Stars: 0
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Use Lucene as Cache Backend for your TYPO3 projects
Provides a cache backend for TYPO3 that stores all cache information in Lucene.
## Key Features of lucene-cache for TYPO3
- Efficient Caching: Uses Lucene's indexing and search capabilities to store and retrieve cached content quickly.
- Scalability: Can handle large volumes of data and perform well under high load, making it suitable for large TYPO3 installations.
- Flexibility: Provides flexible configuration options to tailor the caching behavior to specific needs.
- Integration: Seamlessly integrates with TYPO3's caching framework, allowing for easy setup and use within TYPO3 projects.
## Installation and Configuration
To use the lucene-cache backend in your TYPO3 project, follow these steps:
### Install the Extension
You can install the lucene-cache extension via Composer:
```sh
composer require andersundsehr/lucene-cache
```
### Configure the Cache Backend
In your TYPO3 configuration, typically in LocalConfiguration.php or AdditionalConfiguration.php, additional.php, settings.php or even ext_localconf.php you need to configure the cache backend to use Lucene. Here is an example configuration:
```php
$GLOBALS['TYPO3_CONF_VARS']['SYS']['caching']['cacheConfigurations']['pages'] = [
'frontend' => \TYPO3\CMS\Core\Cache\Frontend\VariableFrontend::class,
'backend' => \Weakbit\LuceneCache\Cache\Backend\LuceneCacheBackend::class,
'options' => [
'defaultLifetime' => 604800,
'indexName' => 'pages',
'maxBufferedDocs' => 1000,
],
'groups' => [
'pages',
]
];
```
### Example Usage
After configuring the lucene-cache backend, TYPO3 will use Lucene for caching pages or other cache configurations you have specified. You can verify the caching behavior by checking the specified index path for Lucene index files and monitoring the performance improvements in your TYPO3 installation.
Additional Resources
For more detailed information, refer to the following resources:
[Lucene-cache GitHub Repository](https://github.com/andersundsehr/lucene-cache)
[TYPO3 Documentation on Caching Framework](https://docs.typo3.org/m/typo3/reference-coreapi/12.4/en-us/ApiOverview/CachingFramework/Index.html****)
These resources provide comprehensive documentation and examples to help you get started with the lucene-cache backend for TYPO3.
### Example Configuration for the Cache
```php
$GLOBALS['TYPO3_CONF_VARS']['SYS']['caching']['cacheConfigurations']['pages'] = [
'frontend' => \TYPO3\CMS\Core\Cache\Frontend\VariableFrontend::class,
'backend' => \Weakbit\LuceneCache\Cache\Backend\LuceneCacheBackend::class,
'options' => [
'defaultLifetime' => 604800,
'indexName' => 'pages',
'maxBufferedDocs' => 1000,
],
'groups' => [
'pages',
]
];
```
The Option "indexName" must not contain other than the following chars: *a-zA-Z0-9\-_*
### Performance
The issue to develop that cache was a usage of very many cache Tags.
maxBufferedDocs is set to 1000 here, that means that up to 1000 documents are buffered before the writeout, that is good for large imports if you have some spare ram.
But keep in mind that a lookup (has,get,remove,flush) will always commit the buffer first to have a full index to search in.
### Keep in mind
This extenion relies on using the SingleSpaceTokenizer with the lucene package, so if you already use lucene in your project, your tokenizer is overwritten which could lead into problems.
*This is a todo we work on*
# Considerdations
In the example
```
'frontend' => \TYPO3\CMS\Core\Cache\Frontend\VariableFrontend::class,
```
Was set, that is the default frontend. This extension ships with the dropin replacement
```
'frontend' => \Weakbit\LuceneCache\Cache\Frontend\VariableFrontend::class,
```
Which uses igbinary if installed, or msgpack if installed. These have some improvements in performance, but you may go with the default frontent as well.
## To be done:
- implement metrics (hits/misses/inserts/deletions)
This extension is inpired by Benni Mack's [https://github.com/bmack/local-caches](bmack/local-caches)