phptailors/singleton-interface

There is no license information available for the latest version (1.0.1) of this package.

Singleton Interface

Maintainers

Package info

github.com/phptailors/singleton-interface

pkg:composer/phptailors/singleton-interface

Statistics

Installs: 910

Dependents: 1

Suggesters: 0

Stars: 0

Open Issues: 0

Security

Advisories: 0

Aikido package health analysis

1.0.1 2026-03-27 12:41 UTC

Requires

  • php: >=8.0

Requires (Dev)

Unknown License 28eeb6af2fded2c41125ffb8c377fd35a5868e02

  • PaweÅ‚ Tomulik <pawel.woop@tomulik.pl>

This package is auto-updated.

Last update: 2026-03-28 12:45:38 UTC

README

PHPUnit Composer Require Checker BC Check Psalm PHP CS Fixer

phptailors/singleton-interface

A PHP Interface for Singletons. See SingletonInterface.

Installation

composer require --dev "phptailors/singleton-interface:^1.0"
composer require --dev "phpunit/phpunit"

Usage

A minimal implementation (example):

<?php

use Tailors\Lib\Singleton\SingletonInterface;
use Tailors\Lib\Singleton\SingletonException;

final class MySingleton implements SingletonInterface
{
    private static ?MySingleton $instance = null;

    public static function getInstance(): MySingleton
    {
        if (null === self::$instance) {
            self::$instance = new self();
        }

        return self::$instance;
    }

    private function __construct() {}

    private function __clone() {}

    public function __wakeup()
    {
        throw new SingletonException('Cannot unserialize singleton '.self::class);
    }
}

Expected features of a Singleton

A real Singleton in PHP:

  1. Should NOT be extendable (should be final).
  2. Should have a private constructor (__construct()).
  3. Its getInstance() should return a single instance of its class.
  4. Should NOT be cloneable (__clone() should be a private method).
  5. Should always throw Tailors\Lib\Singleton\SingletonException on unserialize() (from __wakeup()).

Testing Singleton behavior

The behavior of a Singleton may be tested using phptailors/singleton-testing.