okapi/singleton

PHP Singleton is a PHP library that allows you to create singleton classes with a trait.

1.0.3 2023-03-09 10:04 UTC

Requires

• php: >=8.0

Requires (Dev)

• phpunit/phpunit: >=9.0

MIT

• WalterWoshid

• php
• trait
• singleton

README

PHP Singleton

PHP Singleton is a PHP library that allows you to create singleton classes with a trait.

Installation

composer require okapi/singleton

Usage

<?php

use Okapi\Singleton\Singleton;

class GovernmentOfUSA
{
    // Add the singleton trait
    use Singleton;
    
    /**
     * Function to register the singleton. 
     * 
     * This function and the "initialized" methods are completely optional.
     * 
     * Can be static or non-static. 
     */
    public static function register(): void
    {
        // Get instance
        $instance = self::getInstance();
        
        // For non-static just use $this
        
        // Make sure the instance is only registered once
        $instance->ensureNotInitialized();
        
        // Do something
        // ...
        
        // Mark the instance as initialized
        $instance->setInitialized();
    }
    
    /**
     * Custom function
     */
    public function takeOverTheWorld(): void
    {
        // Make sure the instance is initialized
        $this->ensureInitialized();
        
        // Do something
        // ...
    }
}

// Other file

// Register the singleton
GovernmentOfUSA::register();

// Take over the world
$instance = GovernmentOfUSA::getInstance();
$instance->takeOverTheWorld();
// or
GovernmentOfUSA::getInstance()->takeOverTheWorld();

Testing

• Run composer run-script test
  or
• Run composer run-script test-coverage

Show your support

Give a ⭐ if this project helped you!

📝 License

Copyright © 2023 Valentin Wotschel.
This project is MIT licensed.