Download the PHP package gustavosantarosa/controller-basics-extension without Composer

On this page you can find all versions of the php package gustavosantarosa/controller-basics-extension. 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 controller-basics-extension

Controller-Basics-Extension for Laravel

🧐 Sobre

Este pacote inclui uma classe de extensão desacoplada que contem os principais metodos para um crud dentro de controller:

Sempre que possivel ele sera atualizado, e esta aberto para a comunidade sugerir melhorias.

🏁 Para utilizar o pack

Para utilizar a classe, basta instalar ela utilizando o comando do composer:

extender ela na sua classe de controller dentro de app/controllers e com isso, o seu crud ja vai estar finalizado e pronto para uso.

Pronto, ja é para estar funcionando.

🎈 Recursos

Nele existem algumas ferramentas uteis.

🔐 Criptografia de IDs (Hashids)

O CryptographyMiddleware esconde os ids inteiros da API: na resposta, "id": 42 sai como "id": "v5rNVenmKP", e na requisição o hash volta a ser 42 antes de chegar ao controller. Depende do vinkla/hashids:

Aplique o middleware nas rotas que devem ter os ids criptografados:

O que é decodificado e codificado

O middleware escolhe os campos pelo nome, usando o regex (padrão /id$|_id$|Id$|_ids$/):

Onde Na requisição (hash → inteiro) Na resposta (inteiro → hash)
Parâmetro de rota ({id}, {post_id}) ✅ —
Query e corpo (user_id, plan_ids[], ?filter[store_id]=) ✅ —
Cabeçalhos (X-Admin, X-Agent, X-User) ✅ —
Chaves do JSON (id, user_id...) — ✅ (só valores inteiros)

Um valor que não decodifica responde 400 ("Identificador inválido"), e um parâmetro de rota fora do alfabeto responde 404.

Configuração

Variável Chave Padrão Para quê
ENABLE_CRYPTOGRAPHY hashids.enable_cryptography false Liga o middleware. Desligado, as rotas recebem e devolvem os ids crus.
HASHID_REGEX hashids.regex /id$\|_id$\|Id$\|_ids$/ Quais nomes de campo são ids.
HASHID_HEADER_REGEX hashids.headers.regex /^(X-Admin\|X-Agent\|X-User)/i Quais cabeçalhos carregam ids.
HASHID_IGNORE_UUID hashids.ignore_uuid false Deixa passar intactos os valores com formato de UUID (ver abaixo).
HASHID_DEFAULT hashids.default main Conexão do Hashids (salt, length, alphabet em hashids.connections).

🧪 Fora de produção, ?crypt=true liga a criptografia numa requisição, mesmo com ENABLE_CRYPTOGRAPHY=false. Use em teste para exercitar o mesmo caminho de produção.

Projetos que misturam id inteiro e UUID

O regex olha o nome do campo, nunca o valor. Numa tabela de chave UUID, o id também chega em {id} ou *_id, e o middleware tenta decodificá-lo como hash: a rota responde 404 ou 400, e só com a criptografia ligada (normalmente só em produção, então os testes passam e o erro aparece depois do deploy).

Ligue o HASHID_IGNORE_UUID=true nesse caso. Valores com formato de UUID passam intactos; hashids continuam sendo decodificados, inclusive numa lista mista:

Não há colisão: o alfabeto do Hashids não tem hífen, e o UUID tem (8-4-4-4-12). Um valor que não é nem hash nem UUID continua sendo recusado. Na resposta nada muda: o UUID já não era codificado, porque só valores inteiros passam pelo Hashids.

🧐 Outras Bibliotecas

📚 Documentação GraphQL-like

⛏️ Ferramentas

✍️ Autor


All versions of controller-basics-extension with dependencies

PHP Build Version
Package Version
Requires php Version ^8.2
quantumtecnology/service-basics-extension Version ^3.0.7
quantumtecnology/handler-basics-extension Version ^2.2.0
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 gustavosantarosa/controller-basics-extension contains the following files

Loading the files please wait ...