jeroen/file-fetcher-cache

Provides a SimpleCache (PSR-16) decorator for file fetchers

1.0.1 2020-08-19 16:25 UTC

Requires

• php: >=7.1
• jeroen/file-fetcher: ~6.0|~5.0
• jeroen/simple-cache: ~2.0
• psr/simple-cache: ~1.0

Requires (Dev)

• mediawiki/mediawiki-codesniffer: ~31.0
• ockcyp/covers-validator: ~1.0
• phpstan/phpstan: ^0.12.29
• phpunit/phpunit: ~7.5
• slevomat/coding-standard: ~6.0
• squizlabs/php_codesniffer: ~3.3

GPL-2.0-or-later

• Jeroen De Dauw

• cache
• caching
• simplecache
• file_get_contents
• simple-cache
• psr-16
• file-fetcher
• filefetcher

README

Provides simple caching decorators for FileFetcher implementations.

Usage

The FileFetcher decorators are constructed via FileFetcher\Cache\Factory.

• $factory->newCachingFetcher(): Caches file contents via PSR-16 SimpleCache
• $factory->newJeroenSimpleCacheFetcher(): Caches file contents via jeroen/simple-cache

Once you constructed a FileFetcher, fetching a file is easy:

$fileContent = $fileFetcher->fetchFile($fileLocation);

To test your code you can use all the test doubles provided by FileFetcher itself.

Installation

To use the FileFetcher Cache library in your project, simply add a dependency on jeroen/file-fetcher-cache to your project's composer.json file. Here is a minimal example of a composer.json file that just defines a dependency on FileFetcher Cache 1.x:

{
    "require": {
        "jeroen/file-fetcher-cache": "~1.0"
    }
}

Development

Start by installing the project dependencies by executing

composer update

You can run the tests by executing

make test

You can run the style checks by executing

make cs

To run all CI checks, execute

make ci

You can also invoke PHPUnit directly to pass it arguments, as follows

vendor/bin/phpunit --filter SomeClassNameOrFilter

Release notes

1.0.1 (2020-08-19)

• Updated attribution in composer.json

1.0.0 (2019-01-17)

Initial release with decorators for PSR-16 SimpleCache and jeroen/simple-cache.