Download the PHP package aledefreitas/zlx_cache without Composer
On this page you can find all versions of the php package aledefreitas/zlx_cache. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download aledefreitas/zlx_cache
More information about aledefreitas/zlx_cache
Files in aledefreitas/zlx_cache
Package zlx_cache
Short Description Módulo de cache para ajudar na utilização de cache em sites
License MIT
FAQ
Example:
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 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.
Informations about the package zlx_cache
ZLX Cache
Introdução
A classe ZLX\Cache traz uma forma elegante de utilizar cache na aplicação, facilitando a implementação de sistemas de Cache em sua aplicação. Com esta classe é possível criar várias instâncias separadas de Cache para sua aplicação, sem forçar que sua aplicação se restrinja a apenas uma implementação de cache. Você poderá alterar ou criar engines de cache com sua própria lógica, sobre-escrevendo a classe CacheEngine. Também pode apagar dados de várias instâncias de uma só vez, através dos namespaces atribuídos às instâncias!
Instalação
É possível instalar o ZLX\Cache através do Composer:
Requerimentos
- PHP 7.0+
Pre-built Engines
- Redis
- Memcached
- Memcache
Modo de uso
Abaixo citaremos as funções que são utilizadas no gerenciamento do cache na sua aplicação. Primeiramente, iniciamos o Cache, no início de seu código de inicialização da aplicação:
Atenção!
Tenha muita atenção ao setar a configuração 'prefix' na inicialização do Cache. Ela é o prefixo para as entradas de cache de seu site, e não deve ser duplicada com nenhum outro prefixo igual em qualquer outro site no servidor inteiro.
Criando instâncias on-the-fly (em tempo de execução)
Podemos criar instancias novas programáticamente em tempo de execução com a função :
Atributos das instâncias:
- 'engine': É o Engine a ser utilizado. Ex.: 'memcached'
- 'duration': Duração das chaves de cache. Ex.: '+40 minutes'
- 'prefix': Prefixo da instância. Ex.: 'prefixo_zlx'
- 'namespaces': Array contendo os namespaces ao qual a instância pertence. Ex.: [ 'Posts', 'Admin' ]
- 'groups': Array contendo os grupos da instância. Ex.: [ 'Comments', 'Session', 'Users' ]
- 'prevent_clear': Array contendo os grupos que são ignorados quando o método clear(false)
Após inicializado, poderemos utilizar todas suas funcionalidades:
Atenção!
Todas as funções tem como padrão a instância 'default'. Caso seja omitido este parâmetro, a instância utilizada será a 'default'. Você pode especificar o parametro para utilizar outra instância.
set(key, value [, instance = 'default')
Salva uma chave e seu valor no cache. Retorna com true quando foi salvo com sucesso, e false quando não foi salvo com sucesso.
get(key [, instance = 'default')
Retorna o valor de uma chave do cache. Retorna caso não seja encontrado nada.
delete(key [, instance = 'default')
Apaga o valor de uma chave do cache. Retorna com true caso delete, e false caso não delete.
remember(key, callable [, instance = 'default')
Pesquisa o valor da chave requisitado, caso o mesmo não exista, executa a função e salva na chave requisitada (e retorna) seu retorno.
clearGroup(group [, instance = 'default')
Invalida todas as chaves de um grupo determinado na instancia escolhida
clear([ ignore_prevents = false [, instance = 'default')
Apaga todas as entradas de cache da instancia. Caso ignore_prevents seja setado como , ignorará até os grupos em 'prevent_clear'.
clearNamespace(namespace)
Invoca o método clear() de todas as instâncias sob o namespace escolhido
Funcionamento dos Grupos de Cache
A funcionalidade de grupos de Cache no ZLX\Cache é interessante para invalidar/resetar apenas entradas de cache em um grupo específico. Suponhamos que em determinado momento da sua lógica, você cria uma entrada de Cache sob o grupo 'Posts', para guardar os dados de uma postagem específica:
Ao utilizar o padrão 'Grupo.chave' para salvar, deletar, ou retornar uma chave (set(),get(),delete(),**remember()***), caso o grupo esteja no array de grupos da sua instância, ele será salvo sob este grupo.
Ao invocar o método**clearGroup()***, invalidamos todas as chaves sob este grupo, de forma que na próxima requisição de qualquer chave deste grupo, ela não será encontrada no cache, e portanto será renovada!
Funcionamento dos Namespaces
É muito parecido com o funcionamento de grupos, porém funciona num escopo acima dos grupos. Os grupos pertencem à instancia, e as instâncias pertencem aos namespaces. Quando o métodoclearNamespace()** for invocado, ele irá executar um clear (ignorando os prevents***) em todas as instâncias pertencentes ao namespace a ser resetado.
Criando e utilizando uma Engine personalizada
O ZLX\Cache permite que sejam criadas Engines personalizadas para que possa-se desenvolver as lógicas necessárias do programador através de abstração da classe ZLX\Cache\CacheEngine!
Abaixo segue o exemplo de uma classe personalizada:
Então, será possível adicionar instâncias desta classe de duas maneiras diferentes:
Desta forma, você pode criar engines que utilizam a lógica que for necessária implementada.
