Download the PHP package eusonlito/query-remember without Composer

On this page you can find all versions of the php package eusonlito/query-remember. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package query-remember

Moved to a new repository that manages the cache in a much more efficient way: https://github.com/eusonlito/laravel-database-cache

Query Remember

Based on https://github.com/DarkGhostHunter/RememberableQuery, but with tags and more focused on Eloquent.

Requirements

Installation

You can install the package via composer:

Differences from DarkGhostHunter/RememberableQuery

Usage

Just use the remember() method to remember a Query result before the execution. That's it. The method automatically remembers the result for 60 seconds.

If you are using the default config, this cache will be stored inside ['database', 'database|articles'] tags.

The next time you call the same query, the result will be retrieved from the cache instead of running the SQL statement in the database, even if the result is null or false.

The remember() will throw an error if you build a query instead of executing it.

Time-to-live

By default, queries are remembered by 60 seconds, but you're free to use any length, Datetime, DateInterval or Carbon instance.

Custom Cache Key

The auto-generated cache key is an BASE64-MD5 hash of the SQL query and its bindings, which avoids any collision with other queries while keeping the cache key short.

If you are using the default config, this cache will be stored inside ['database', 'database|articles'] tags with the key latest_articles.

Cache Lock (data races)

On multiple processes, the Query may be executed multiple times until the first process is able to store the result in the cache, specially when these take more than 1 second. To avoid this, set the wait parameter with the number of seconds to hold the lock acquired.

The first process will acquire the lock for the given seconds, execute the query and store the result. The next processes will wait until the cache data is available to retrieve the result from there.

If you need to use this across multiple processes, use the cache lock directly.

Idempotent queries

While the reason behind remembering a Query is to cache the data retrieved from a database, you can use this to your advantage to create idempotent queries.

For example, you can make this query only execute once every day for a given user ID.

Subsequent executions of this query won't be executed at all until the cache expires, so in the above example we have surprisingly created a "unique views" mechanic.

Operations are NOT commutative

Altering the Builder methods order will change the auto-generated cache key hash. Even if they are visually the same, the order of statements makes the hash completely different.

For example, given two similar queries in different parts of the application, these both will not share the same cached result:

To ensure you're hitting the same cache on similar queries, use a custom cache key. With this, all queries using the same key will share the same cached result:

This will allow you to even retrieve the data outside the query, by just asking directly to the cache.

Remember that you need to pass the same ordered list of tags to the tags method as when cache was stored. Always use ['database', 'database|XXX'] when XXX is the table name related with the query.

Tags

This package tag caches with two different tags (only supported by redis and memcached)

Custom tags on models

The models can include two methods to create custom tags:

Flush caches

You can flush all database caches or only caches related with only one table:

License

The MIT License (MIT). Please see License File for more information.


All versions of query-remember with dependencies

PHP Build Version
Package Version
Requires php Version ^8.0
illuminate/database Version 8.*
illuminate/support Version 8.*
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package eusonlito/query-remember contains the following files

Loading the files please wait ...