Singleton.php

<?php

namespace DesignPatterns\Singleton;

/**
 * Singleton pattern
 *
 * --------------------------------------------------------------------------------------------------------------
 * THIS IS CONSIDERED TO BE AN ANTI-PATTERN! FOR BETTER TESTABILITY AND MAINTAINABILITY USE DEPENDENCY INJECTION!
 * -------------------------------------------------------------------------------------------------------------- 
 *
 * Purpose:
 * to have only one instance of this object in the application that will handle all calls
 *
 * Examples:
 * - DB Connector
 * - Logger (may also be a Multiton if there are many log files for several purposes)
 * - Lock file for the application (there is only one in the filesystem ...)
 */
class Singleton
{
    /**
     * gets the instance via lazy initialization (created on first usage)
     *
     * @return Singleton
     */
    public static function getInstance()
    {
        static $instance;

        if (null === $instance) {
            $instance = new self();
        }

        return $instance;
    }

    /**
     * is not allowed to call from outside: private!
     *
     */
    private function __construct()
    {}

    /**
     * prevent the instance from being cloned
     *
     * @return void
     */
    private function __clone()
    {}

    /**
     * prevent from being unserialized
     *
     * @return void
     */
    private function __wakeup()
    {}
}