grottopress/nouveau

This package is abandoned and no longer maintained. No replacement package was suggested.

Instantiate a class by calling `::new()`, as an alternative to the `new` keyword.

dev-master 2020-02-26 14:54 UTC

Requires

• php: >=7.0

Requires (Dev)

• codeception/codeception: ^2.3

MIT

• GrottoPress.com
• N Atta Kusi Adusei

• OOP
• constructor
• new

README

Description

Nouveau adds a new() static method to your class for constructing an instance of the class, as an alternative to using the new keyword.

In ruby and crystal, you instantiate a class by doing:

MyClass.new(*args)

In rust, it is idiomatic to add a constructor to a type:

pub struct MyStruct {}

impl MyStruct {
    pub fn new() {}
}

...and call it thus:

MyStruct::new();

Nouveau brings the same concept to PHP, allowing to intantiate a class thus:

MyClass::new(..$args);

The above is equivalent to:

new MyClass(...$args);

Among other things, this allows chaining a method immediately unto the constructed object.

This:

Person::new('John', 'Doe')->fullName();

Versus:

$john = new Person('John', 'Doe');
$john->fullName();

// OR
(new Person('John', 'Doe'))->fullName();

Usage

Install via composer:

composer require grottopress/nouveau

1. Import trait into your class:

<?php
declare (strict_types = 1);

namespace Vendor;

use GrottoPress\Nouveau\NewTrait;

class Greeter
{
    /**
     * Import trait
     */
    use NewTrait;

    private $name;

    public function __construct(string $name)
    {
        $this->name = $name;
    }

    public function sayHello(): string
    {
        return "Hello, {$this->name} :-)";
    }
}

1. Instantiate class

$greeter = Vendor\Greeter::new('John'); // Same as `new Vendor\Greeter('John');`
echo $greeter->sayHello(); // => Hello, John :-)

Note that new() is variadic, and takes as many arguments as you pass to __construct().