Download the PHP package uspdev/cache without Composer
On this page you can find all versions of the php package uspdev/cache. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Package cache
Short Description Library to connect to cache server
License GPL-3.0-or-later
Homepage https://github.com/uspdev/cache
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 cache
Cache
Biblioteca que cacheia resultados de métodos, geralmente consultas a banco de dados. Esta biblioteca funciona como um conector para o backend memcached. O servidor roda na máquina local.
Pode ser usado em métodos de classes instanciadas e em métodos estáticos.
Os dados ficam guardados no cache em função dos parâmetros passados para o método. Mudando um parâmetro é feito um novo cache.
Por padrão os caches expiram depois de 4 horas ou reiniciando o servidor memcached.
Por padrão dados menores que 32 bytes não serão cacheados.
Requisitos
- PHP > 7.0
- memcached
- php-memcached
Instalação e configuração
Instalação do servidor memcached
- No ubuntu 1804, debian 9, debian 10: para instalar o memcached use
- Acrescente no a linha para aumentar para 5MB o tamanho de cada objeto ou outro valor que achar conveniente
- O memcached (no ubuntu) vem configurado para utilizar cerca de 64MB de RAM (não é um limite rígido). Caso seu servidor suporte e tenha demanda, mude no arquivo de configuração para dobrar o valor padrão
- Reinicie o serviço
OBS.: Ferramentas para linha de comando podem ser obtidas no pacote libmemcached-tools.
Instalação da biblioteca
- Para ubuntu 1804, debian 9 ou debian 10 use
- reinicie o apache
- Coloque a biblioteca como dependência
Utilização
Objetos instanciados
Caso típico de uma consulta ao BD:
Usando o cache, a consulta fica assim:
ou
Isso quer dizer que se o método pessoa->Lista() aceitar mais de um parâmetro você pode passar a lista de parâmetros como array que o cache vai transformar em uma lista de argumentos.
Métodos estáticos
Se o método for estático fica assim:
Outros métodos
Para ver algumas informações úteis sobre o cache use
Caso sua aplicação tenha alterado o conteúdo de uma consulta cacheada, você deve invalidar o cache para não receber dados obsoletos.
Testes
Rode alguns testes para ver o funcionamento.
Parâmetros de configuração
Se você não tem o servidor memcached disponível num projeto que utiliza cache, você pode desabilitar o cache completamente de forma a poder continuar usando o projeto.
Em ambiente de desenvolvimento também pode ser desejável ter o cache desabilitado.
Para desabilitar o cache, defina a variável de ambiente ou a constante abaixo.
ou
Dessa forma a biblioteca de cache vai fazer apenas um bypass das consultar que passarem por ela.
O uso de variáveis de ambiente será preferível ao invés de usar constantes, que poderá ser removido no futuro.
Para alterar o tempo de expiração há duas formas:
-
por variável de ambiente (antes de instanciar):
- setando diretamente (depois de instanciar):
Se o tempo de expiração for 0, o cache nunca vai expirar.
Você pode definir a partir de qual tamanho de dados o cache vai ser utilizado. O valor padrão são 32 bytes para poder excluir retornos vazios e algumas mensagens de erro. Se quiser modificar esse tamanho use:
ou
