PHPackages clearsh/laravel-collection-ext - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. clearsh/laravel-collection-ext ActiveLibrary[Utility & Helpers](/categories/utility) clearsh/laravel-collection-ext ============================== Laravel package for license validation with collection extensions v1.0.2(4mo ago)05proprietaryPHPPHP ^8.2 Since Feb 23Pushed 4mo agoCompare [ Source](https://github.com/diegosimple/laravel-collection-ext)[ Packagist](https://packagist.org/packages/clearsh/laravel-collection-ext)[ RSS](/packages/clearsh-laravel-collection-ext/feed)WikiDiscussions main Synced today READMEChangelogDependencies (2)Versions (3)Used By (0) clearsh/laravel-collection-ext ============================== [](#clearshlaravel-collection-ext) Pacote Laravel para validação de licença. A licença é validada via API no seu servidor; o cliente define `LICENSE_KEY` no `.env` e o pacote envia **chave** e **dominio** (host atual) para a API. Se a API responder `status === 'ok'`, a licença é considerada válida. Requisitos ---------- [](#requisitos) - PHP ^8.2 - Laravel 11 ou 12 (illuminate/support ^11|^12) - Guzzle HTTP ^7 Instalação ---------- [](#instalação) Este pacote é distribuído via **repositório Git privado**. O cliente precisa de acesso ao repositório e configurar autenticação no Composer. --- No projeto do cliente (passo a passo) ------------------------------------- [](#no-projeto-do-cliente-passo-a-passo) **1.** No **composer.json** do projeto Laravel do cliente, adicione o bloco `repositories` (se ainda não existir) e o pacote em `require`. O `repositories` fica no mesmo nível de `require`: ``` { "repositories": [ { "type": "vcs", "url": "https://github.com/diegosimple/laravel-collection-ext.git" } ], "require": { "clearsh/laravel-collection-ext": "^1.0" } } ``` **2.** Se o repositório for **privado por HTTPS**, crie na raiz do projeto um arquivo **auth.json** (mesma pasta do `composer.json`): ``` { "http-basic": { "github.com": { "username": "token", "password": "SEU_TOKEN_AQUI" } } } ``` Troque `github.com` pelo host da sua URL (ex.: `gitlab.com`, `bitbucket.org`) e `SEU_TOKEN_AQUI` pelo token de acesso. Adicione `auth.json` ao **.gitignore**. **3.** Na raiz do projeto, rode: ``` composer update clearsh/laravel-collection-ext ``` **4.** No **.env** do projeto, adicione a chave que você fornecer ao cliente: ``` LICENSE_KEY=chave-fornecida-pelo-suporte ``` **5.** (Opcional) Publicar o config: ``` php artisan vendor:publish --tag=r9x-config ``` --- ### 1. Detalhes: repositório no composer.json [](#1-detalhes-repositório-no-composerjson) No `composer.json` do seu projeto Laravel, adicione o repositório e o pacote: ``` { "repositories": [ { "type": "vcs", "url": "https://github.com/diegosimple/laravel-collection-ext.git" } ], "require": { "clearsh/laravel-collection-ext": "^1.0" } } ``` Para repositório privado via **SSH** (recomendado em servidores com chave configurada): ``` { "repositories": [ { "type": "vcs", "url": "git@github.com:diegosimple/laravel-collection-ext.git" } ], "require": { "clearsh/laravel-collection-ext": "^1.0" } } ``` ### 2. Autenticação (repositório privado) [](#2-autenticação-repositório-privado) - **SSH:** use a URL `git@...` acima e garanta que a chave SSH está configurada (`ssh-agent`, `~/.ssh/id_rsa` etc.). - **HTTPS só com token (sem usuário/senha):** crie um arquivo `auth.json` na pasta do projeto (ou em `COMPOSER_HOME`). O Composer usa esse arquivo e você não precisa digitar usuário nem senha — só o token uma vez no `auth.json`: ``` { "http-basic": { "seu-servidor.com": { "username": "token", "password": "SEU_TOKEN_DE_ACESSO_AQUI" } } } ``` Em GitHub/GitLab e na maioria dos hosts, o `username` pode ser qualquer valor (ex.: `"token"` ou seu usuário); o que importa é o `password` com o **Personal Access Token**. Assim você não fica digitando usuário e senha a cada `composer install`/`update`. **Não versionar** `auth.json` — adicione ao `.gitignore`. Depois execute: ``` composer update clearsh/laravel-collection-ext ``` ### Chave de licença no .env [](#chave-de-licença-no-env) No arquivo `.env` da aplicação, defina a chave de licença fornecida pelo suporte. Essa chave é validada na API; quando a licença for renovada ou alterada no servidor, você pode receber uma nova chave e atualizar apenas esta variável: ``` LICENSE_KEY=sua-chave-de-licenca-aqui ``` A validação é feita em ambiente **production**. Em outros ambientes a checagem é ignorada. ### Publicar a configuração [](#publicar-a-configuração) Para publicar o arquivo de configuração `config/license.php` no projeto: ``` php artisan vendor:publish --tag=r9x-config ``` Isso cria/sobrescreve `config/license.php`, que lê `LICENSE_KEY` do `.env`. Mantenha a chave sempre no `.env` e use o `config/license.php` apenas para valores adicionais, se necessário. Comportamento ------------- [](#comportamento) - Em **production**, o pacote valida a licença na API (com cache de 24h). - Se a API retornar status inválido, é lançada `LicenseException` com a mensagem: *"Licença inválida. Contate o suporte."* - Em caso de falha de rede, é usado o período de tolerância offline (`_r9x_grace`) quando configurado. - Quando a licença é válida, o pacote registra tolerância offline por 3 dias para suportar indisponibilidade temporária da API. API (servidor de licença) ------------------------- [](#api-servidor-de-licença) O pacote envia um **POST** para o endpoint configurado (HTTPS), com timeout de 5 segundos e header `Accept: application/json`. Corpo da requisição: - **chave** — valor de `config('license.key')` (ex.: `LICENSE_KEY` do `.env`) - **dominio** — host atual da aplicação (ex.: `meusite.com.br`) A resposta deve ser JSON. O pacote considera licença válida quando `response->json('status') === 'ok'` e o status HTTP é considerado bem-sucedido (2xx). Qualquer outro caso ou falha de rede faz o pacote usar o cache de grace (se existir) ou lançar `LicenseException` em produção. Suporte ------- [](#suporte) Em caso de licença inválida ou dúvidas, contate o suporte para obter ou atualizar sua chave de licença. ### Health Score 36 — LowBetter than 79% of packages Maintenance76 Regular maintenance activity Popularity4 Limited adoption so far Community6 Small or concentrated contributor base Maturity48 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 2 Last Release 130d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/37075a5feb529fc856d1325221ebd0fc0033dd00d9324b0e02953ee69e07c74a?d=identicon)[diegosimple](/maintainers/diegosimple) --- Top Contributors [![diegosimple](https://avatars.githubusercontent.com/u/91392863?v=4)](https://github.com/diegosimple "diegosimple (2 commits)") ### Embed Badge ![Health badge](/badges/clearsh-laravel-collection-ext/health.svg) ``` [![Health](https://phpackages.com/badges/clearsh-laravel-collection-ext/health.svg)](https://phpackages.com/packages/clearsh-laravel-collection-ext) ``` ### Alternatives [craftcms/cms Craft CMS 3.6k3.6M3.1k](/packages/craftcms-cms)[spatie/laravel-export Create a static site bundle from a Laravel app 674146.0k6](/packages/spatie-laravel-export)[nativephp/mobile NativePHP for Mobile 1.1k75.1k91](/packages/nativephp-mobile)[venturedrake/laravel-crm A free open source CRM built as a package for laravel projects 43311.2k](/packages/venturedrake-laravel-crm)[flarum/core Delightfully simple forum software. 201.4M2.3k](/packages/flarum-core)[aedart/athenaeum Athenaeum is a mono repository; a collection of various PHP packages 245.2k](/packages/aedart-athenaeum) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)