Provide carbon-extended as trait/mixin

[kylekatarnls]

Hello,

Classes that extend Carbon like jensseggers/date or this one have one major inconvenient. You have to choose one or the other. You can't benefit of both methods of 2 or more classes that extend a first one (Carbon in this case).

A more extensible approach is to use traits and Carbon provides out of the box the mixin() method which can take as much traits as you want as long as they don't use the same methods names:

trait BeerDayCarbonTrait
{
    public function nextBeerDay()
    {
        return $this->modify('next Wednesday');
    }

    public function previousBeerDay()
    {
        return $this->modify('previous Wednesday');
    }
}

Carbon::mixin(BeerDayCarbonTrait::class);

$date = Carbon::parse('First saturday of December 2018');

echo $date->previousBeerDay();                                                 // 2018-11-28 00:00:00
echo "\n";
echo $date->nextBeerDay();                                                     // 2018-12-05 00:00:00

Try on try-carbon.herokuapp.com

And this is a backward-compatible change as you can do:

<?php

namespace Lee;

use Carbon\Carbon;

// Optionally you can deprecate it for next version
@trigger_error('CarbonExtended class is deprecated and will be removed in carbon-extended 2, use Carbon::mixin(CarbonExtendedTrait::class) instead.', E_USER_DEPRECATED);

class CarbonExtended extends Carbon
{
  use CarbonExtendedTrait;
}

And Carbon documentation has a macro section where such mixins/macros can be promoted if you want by submitting a pull-request on gh-pages branch on https://github.com/briannesbitt/Carbon

[peter279k]

Hi @kylekatarnls, thanks for your reply.

Thanks for your sharing the Carbon::mixin method :) and it will be useful for someone use many other Carbon extended packages conveniently!

I will do this on my next release 2.x version :).