PHPackages spatie/macroable - 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. spatie/macroable ActiveLibrary[Utility & Helpers](/categories/utility) spatie/macroable ================ A trait to dynamically add methods to a class 2.1.0(3mo ago)72759.6M—1.4%2620MITPHPPHP ^8.3CI passing Since Sep 17Pushed 4w ago6 watchersCompare [ Source](https://github.com/spatie/macroable)[ Packagist](https://packagist.org/packages/spatie/macroable)[ Docs](https://github.com/spatie/macroable)[ RSS](/packages/spatie-macroable/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (5)Dependencies (2)Versions (8)Used By (20) A trait to dynamically add methods to a class ============================================= [](#a-trait-to-dynamically-add-methods-to-a-class) [![Latest Version on Packagist](https://camo.githubusercontent.com/24087f808053c864f2ec1dafcdb85c73f88a9e06ffdd337a79964c82b0dfdb7e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7370617469652f6d6163726f61626c652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/spatie/macroable)[![run-tests](https://github.com/spatie/macroable/workflows/run-tests/badge.svg)](https://github.com/spatie/macroable/workflows/run-tests/badge.svg)[![Total Downloads](https://camo.githubusercontent.com/3fc50a2c31af9f2e2b0d09713758e7b227ac0e5cc67c8d8a14d19ede856df1c9/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7370617469652f6d6163726f61626c652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/spatie/macroable) This package provides a trait that, when applied to a class, makes it possible to add methods to that class at runtime. Here's a quick example: ``` $myClass = new class() { use Spatie\Macroable\Macroable; }; $myClass::macro('concatenate', function(... $strings) { return implode('-', $strings); }); $myClass->concatenate('one', 'two', 'three'); // returns 'one-two-three' ``` The idea of a macroable trait and the implementation is taken from [the `macroable` trait](https://github.com/laravel/framework/blob/master/src/Illuminate/Macroable/Traits/Macroable.php) of the [Laravel framework](https://laravel.com). Support us ---------- [](#support-us) [![](https://camo.githubusercontent.com/c28abcfb2bc865224a999cddbc05bfc0fbc472f46c9a72e6281e6170946371ff/68747470733a2f2f6769746875622d6164732e73332e65752d63656e7472616c2d312e616d617a6f6e6177732e636f6d2f6d6163726f61626c652e6a70673f743d31)](https://spatie.be/github-ad-click/macroable) We invest a lot of resources into creating [best in class open source packages](https://spatie.be/open-source). You can support us by [buying one of our paid products](https://spatie.be/open-source/support-us). We highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using. You'll find our address on [our contact page](https://spatie.be/about-us). We publish all received postcards on [our virtual postcard wall](https://spatie.be/open-source/postcards). Installation ------------ [](#installation) You can install the package via composer: ``` composer require spatie/macroable ``` Usage ----- [](#usage) You can add a new method to a class using `macro`: ``` $macroableClass = new class() { use Spatie\Macroable\Macroable; }; $macroableClass::macro('concatenate', function(... $strings) { return implode('-', $strings); }); $macroableClass->concatenate('one', 'two', 'three'); // returns 'one-two-three' ``` Callables passed to the `macro` function will be bound to the `class` ``` $macroableClass = new class() { protected $name = 'myName'; use Spatie\Macroable\Macroable; }; $macroableClass::macro('getName', function() { return $this->name; }; $macroableClass->getName(); // returns 'myName' ``` You can also add multiple methods in one go by using a mixin class. A mixin class contains methods that return callables. Each method from the mixin will be registered on the macroable class. ``` $mixin = new class() { public function mixinMethod() { return function() { return 'mixinMethod'; }; } public function anotherMixinMethod() { return function() { return 'anotherMixinMethod'; }; } }; $macroableClass->mixin($mixin); $macroableClass->mixinMethod() // returns 'mixinMethod'; $macroableClass->anotherMixinMethod() // returns 'anotherMixinMethod'; ``` Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Testing ------- [](#testing) ``` composer test ``` Contributing ------------ [](#contributing) Please see [CONTRIBUTING](https://github.com/spatie/.github/blob/main/CONTRIBUTING.md) for details. Security -------- [](#security) If you've found a bug regarding security please mail instead of using the issue tracker. Postcardware ------------ [](#postcardware) You're free to use this package (it's [MIT-licensed](LICENSE.md)), but if it makes it to your production environment we highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using. Our address is: Spatie, Kruikstraat 22, 2018 Antwerp, Belgium. We publish all received postcards [on our company website](https://spatie.be/en/opensource/postcards). Credits ------- [](#credits) - [Freek Van der Herten](https://github.com/freekmurze) - [All Contributors](../../contributors) Idea and code is taken from [the `macroable` trait](https://github.com/laravel/framework/blob/master/src/Illuminate/Support/Traits/Macroable.php) of the [Laravel framework](https://laravel.com). License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 75 — ExcellentBetter than 100% of packages Maintenance88 Actively maintained with recent releases Popularity72 Solid adoption and visibility Community40 Growing community involvement Maturity83 Battle-tested with a long release history Bus Factor2 2 contributors hold 50%+ of commits 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 ~764 days Total 5 Last Release 108d ago Major Versions 0.0.1 → 1.0.02017-09-18 1.0.1 → 2.0.02021-03-26 PHP version history (4 changes)0.0.1PHP ^7.0 1.0.1PHP ^7.2|^8.0 2.0.0PHP ^8.0 2.1.0PHP ^8.3 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/7535935?v=4)[Spatie](/maintainers/spatie)[@spatie](https://github.com/spatie) --- Top Contributors [![freekmurze](https://avatars.githubusercontent.com/u/483853?v=4)](https://github.com/freekmurze "freekmurze (56 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (15 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (10 commits)")[![AdrianMrn](https://avatars.githubusercontent.com/u/12762044?v=4)](https://github.com/AdrianMrn "AdrianMrn (9 commits)")[![alexmanase](https://avatars.githubusercontent.com/u/10696975?v=4)](https://github.com/alexmanase "alexmanase (5 commits)")[![patinthehat](https://avatars.githubusercontent.com/u/5508707?v=4)](https://github.com/patinthehat "patinthehat (4 commits)")[![akoepcke](https://avatars.githubusercontent.com/u/5311185?v=4)](https://github.com/akoepcke "akoepcke (3 commits)")[![chapeupreto](https://avatars.githubusercontent.com/u/834048?v=4)](https://github.com/chapeupreto "chapeupreto (3 commits)")[![AlexVanderbist](https://avatars.githubusercontent.com/u/6287961?v=4)](https://github.com/AlexVanderbist "AlexVanderbist (3 commits)")[![driesvints](https://avatars.githubusercontent.com/u/594614?v=4)](https://github.com/driesvints "driesvints (3 commits)")[![tommitchelmore](https://avatars.githubusercontent.com/u/19690833?v=4)](https://github.com/tommitchelmore "tommitchelmore (1 commits)")[![amitmerchant1990](https://avatars.githubusercontent.com/u/3647841?v=4)](https://github.com/amitmerchant1990 "amitmerchant1990 (1 commits)")[![angeljqv](https://avatars.githubusercontent.com/u/79208641?v=4)](https://github.com/angeljqv "angeljqv (1 commits)")[![kevinkhill](https://avatars.githubusercontent.com/u/266076?v=4)](https://github.com/kevinkhill "kevinkhill (1 commits)")[![mrchenzifan](https://avatars.githubusercontent.com/u/16876976?v=4)](https://github.com/mrchenzifan "mrchenzifan (1 commits)")[![Nielsvanpach](https://avatars.githubusercontent.com/u/10651054?v=4)](https://github.com/Nielsvanpach "Nielsvanpach (1 commits)")[![peter279k](https://avatars.githubusercontent.com/u/9021747?v=4)](https://github.com/peter279k "peter279k (1 commits)")[![sebastiandedeyne](https://avatars.githubusercontent.com/u/1561079?v=4)](https://github.com/sebastiandedeyne "sebastiandedeyne (1 commits)")[![AbdelrhmanSaid](https://avatars.githubusercontent.com/u/70618755?v=4)](https://github.com/AbdelrhmanSaid "AbdelrhmanSaid (1 commits)") --- Tags macrosphpruntimeutilityspatiemacroable ### Code Quality TestsPest ### Embed Badge ![Health badge](/badges/spatie-macroable/health.svg) ``` [![Health](https://phpackages.com/badges/spatie-macroable/health.svg)](https://phpackages.com/packages/spatie-macroable) ``` ### Alternatives [spatie/laravel-package-tools Tools for creating Laravel packages 945125.5M7.0k](/packages/spatie-laravel-package-tools)[spatie/laravel-data Create unified resources and data transfer objects 1.8k28.9M627](/packages/spatie-laravel-data)[spatie/laravel-analytics A Laravel package to retrieve Google Analytics data. 3.2k5.7M57](/packages/spatie-laravel-analytics)[spatie/regex A sane interface for php's built in preg\_\* functions 1.1k17.1M59](/packages/spatie-regex)[spatie/enum PHP Enums 84529.1M68](/packages/spatie-enum)[spatie/laravel-collection-macros A set of useful Laravel collection macros 1.9k5.7M29](/packages/spatie-laravel-collection-macros) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)