PHPackages frictionlessdigital/macros - 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. frictionlessdigital/macros ActiveProject[Utility & Helpers](/categories/utility) frictionlessdigital/macros ========================== Frictionless Solutions | Macros 12.0.0(2y ago)0450MITPHPPHP ^7.4 || ^8.0 Since Oct 5Pushed 1y ago5 watchersCompare [ Source](https://github.com/Frictionlessdigital/macros)[ Packagist](https://packagist.org/packages/frictionlessdigital/macros)[ RSS](/packages/frictionlessdigital-macros/feed)WikiDiscussions main Synced 1w ago READMEChangelog (9)Dependencies (11)Versions (11)Used By (0) FLS :: Macros ============= [](#fls--macros) Ass some common macroses that Frictionless uses in their daily life. Installation ------------ [](#installation) ``` composer require "frictionlessdigital/macros":"^1.0" ``` Note that root namespace for the package is `Fls` not `Frictionlessdigital`. ### Config [](#config) To publish configuration file, run `php artisan vendor:publish --tag=fls.macros-config` The package will publish `fls.macros.php` file: ``` use Carbon\Carbon; use Illuminate\Database\Eloquent\Builder; use Illuminate\Database\Eloquent\Factories\Factory; use Illuminate\Support\Collection; use Illuminate\Routing\Router; use Laravel\Dusk\Browser; return [ /* |-------------------------------------------------------------------------- | Laravel\Dusk\Browser Macros |-------------------------------------------------------------------------- | To install | composer require laravel/dusk | */ Browser::class => [ // 'firstWindow' => \Fls\Macros\Macros\Browser\FirstWindow::class, // 'lastWindow' => \Fls\Macros\Macros\Browser\LastWindow::class, // 'switchToFirstWindow' => \Fls\Macros\Macros\Browser\SwitchToFirstWindow::class, // 'switchToLastWindow' => \Fls\Macros\Macros\Browser\SwitchToLastWindow::class, // 'windows' => \Fls\Macros\Macros\Browser\Windows::class, ], /* |-------------------------------------------------------------------------- | Illuminate\Database\Eloquent\Builder |-------------------------------------------------------------------------- | Enabled by default | */ Builder::class => [ 'toSqlWithBindings' => \Fls\Macros\Macros\Builder\ToSqlWithBindings::class, ], /* |-------------------------------------------------------------------------- | Carbon\Carbon |-------------------------------------------------------------------------- | startOfFiscalYear($at = null) will return the return of fiscal year | */ Carbon::class => [ 'fiscalYearForHumans' => \Fls\Macros\Macros\Carbon\FiscalYearForHumans::class, 'startOfFiscalYear' => \Fls\Macros\Macros\Carbon\StartOfFiscalYear::class, 'endOfFiscalYear' => \Fls\Macros\Macros\Carbon\EndOfFiscalYear::class, 'isFiscalYear' => \Fls\Macros\Macros\Carbon\IsFiscalYear::class, ], /* |-------------------------------------------------------------------------- | Illuminate\Support\Collection |-------------------------------------------------------------------------- | oxford() required Coduo\Humanize package | composer require coduo/php-humanizer | */ Collection::class => [ // 'ofxord' => \Fls\Macros\Macros\Collection\Oxford::class, ], /* |-------------------------------------------------------------------------- | Illuminate\Database\Eloquent\Factories\Factory Macros |-------------------------------------------------------------------------- | Enabled by default | */ Factory::class => [ 'empty' => \Fls\Macros\Macros\Factory\EmptyFactory::class, ], /* |-------------------------------------------------------------------------- | Illuminate\Routing\Router Macros |-------------------------------------------------------------------------- | livewireResource() is just a shortcut to have a resource with [index, create, show, edit] methods only | but if you want to install LiveWire | composer require livewire/livewire | */ Router::class => [ 'livewireResource' => \Fls\Macros\Macros\Router\LiveResource::class, ], ]; ``` Configuration structure is simple: root key is the name of the class you need to add the macro to and the array is the macros that are being added. You will notice that some are commented out: the package does not insist you have those, and does tno silently pull them, to avoid surprises (with Dusk, for instance). As there is no need to pull extra packages when you dont need them - you should integrate them within your repo. The list of packages is suggested in `composer.json`: - [coduo/php-humanizer](https://github.com/coduo/php-humanizer) - Humanize values - [laravel/dusk](https://github.com/laravel/dusk) - Laravel Testing tool Integration ----------- [](#integration) The package automatically registers with Laravel. If you want to manually register it, add to your `composer.json`: ``` "extra": { "laravel": { "dont-discover": [ "frictionlessdigital/macros" ] } }, ``` and add to `config\app.php`: ``` 'providers' => [ /* * Package Service Providers... */ Fls\Macros\MacrosServiceProvider::class, ``` Usage ----- [](#usage) The package offers extension for Builder, Carbon, Router, Collection and Dusk Browser. ### \\Carbon\\Carbon Macros [](#carboncarbon-macros) **fiscalYearForHumans($formatter=null)**will get readable representation for the fiscal year. ``` $x = Carbon::now()->fiscalYearForHumans() // $x = 'Fiscal year ending March 31, 2022'; ``` `fiscalYearForHumans` accepts closure formatter: ``` $x = Carbon::now()->fiscalYearForHumans(fn($at) => new HtmlString(''.$at->year.'')); // $x = HtmlString('2022'); ``` **startOfFiscalYear**will modify the date to the start of the fiscal year ``` Carbon::startOfFiscalYear(); // Carbon instance at April 1, 2021 0:0:0; ``` **endOfFiscalYear**will modify the date to the end of the fiscal year ``` Carbon::endOfFiscalYear(); // Carbon instance at March 31, 2022 25:59:59; ``` **isFiscalYear**Will check if the date is within the provided (int) fiscal year ``` // assuming now is Carbon::parse('March 31, 2022')->isFiscalYear(2021); // true Carbon::parse('April 1, 2022')->isFiscalYear(2021); // false ``` ### Laravel\\Dusk\\Browser Macros [](#laravelduskbrowser-macros) \*Requires Laravel Dusk: ``` composer require laravel/dusk ``` - firstWindow() - to get the first window - lastWindow() - to get the last window - switchToFirstWindow() - switch Browser to the first window - switchTolastWindow() - switch Browser to the last window - windows() - get all current Browser windows ### Illuminate\\Database\\Eloquent\\Builder Macros [](#illuminatedatabaseeloquentbuilder-macros) - toSqlWithBindings - get the SQL from the builder, hydrated with values ### Illuminate\\Support\\Collection Macros [](#illuminatesupportcollection-macros) Optionally, many need Coduo Humanizer, tested with version 4 ``` composer require coduo/php-humanizer ``` - oxford - list values with Ofxord coma. ### Illuminate\\Database\\Eloquent\\Factories\\Factory Macros [](#illuminatedatabaseeloquentfactoriesfactory-macros) - empty() - will return a Factory where every value in definition is `null` Change log ---------- [](#change-log) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Testing ------- [](#testing) ``` $ composer test ``` Contributing ------------ [](#contributing) Please see [CONTRIBUTING](CONTRIBUTING.md) and [CODE\_OF\_CONDUCT](CODE_OF_CONDUCT.md) for details. Security -------- [](#security) If you discover any security related issues, please email instead of using the issue tracker. Credits ------- [](#credits) - [Cyrill N Kalita](https://github.com/nickfls) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. --- [![](./resources/docs/gramma.png)](http://frictionlesssolutions.com "Fricitonless Solutions Inc.") ### Health Score 34 — LowBetter than 77% of packages Maintenance34 Infrequent updates — may be unmaintained Popularity16 Limited adoption so far Community11 Small or concentrated contributor base Maturity62 Established project with proven stability Bus Factor1 Top contributor holds 87.1% 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 ~141 days Recently: every ~182 days Total 10 Last Release 411d ago Major Versions 1.5.0 → 12.0.02024-04-09 1.5.1 → v12.x-dev2025-04-01 PHP version history (2 changes)1.0.0PHP ^7.3 || ^8.0 1.1.0PHP ^7.4 || ^8.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/d6897fa24df64545b665dc9b4707e5f69d766ab4d2a1b5b13041e22d7eb8b30d?d=identicon)[cyrill@frictionlesssolutions.com](/maintainers/cyrill@frictionlesssolutions.com) --- Top Contributors [![nickfls](https://avatars.githubusercontent.com/u/12013206?v=4)](https://github.com/nickfls "nickfls (27 commits)")[![Purnendu-extreme](https://avatars.githubusercontent.com/u/26261727?v=4)](https://github.com/Purnendu-extreme "Purnendu-extreme (4 commits)") --- Tags laravelmacrosfls ### Code Quality TestsPHPUnit Code StylePHP CS Fixer ### Embed Badge ![Health badge](/badges/frictionlessdigital-macros/health.svg) ``` [![Health](https://phpackages.com/badges/frictionlessdigital-macros/health.svg)](https://phpackages.com/packages/frictionlessdigital-macros) ``` ### Alternatives [watson/active Laravel helper for recognising the current route, controller and action 3253.6M14](/packages/watson-active)[spatie/laravel-livewire-wizard Build wizards using Livewire 4061.0M4](/packages/spatie-laravel-livewire-wizard)[tonysm/importmap-laravel Use ESM with importmap to manage modern JavaScript in Laravel without transpiling or bundling. 148399.8k1](/packages/tonysm-importmap-laravel)[bezhansalleh/filament-google-analytics Google Analytics integration for FilamentPHP 205144.8k5](/packages/bezhansalleh-filament-google-analytics)[dragon-code/pretty-routes Pretty Routes for Laravel 10058.7k4](/packages/dragon-code-pretty-routes)[laracraft-tech/laravel-useful-additions A collection of useful Laravel additions! 58109.4k](/packages/laracraft-tech-laravel-useful-additions) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)