PHP Classes

Singleton Trait: Trait that adds singleton pattern to a class

Recommend this page to a friend!
     
  Info   Example   View files Files   Install with Composer Install with Composer   Download Download   Reputation   Support forum   Blog    
Ratings Unique User Downloads Download Rankings
Not enough user ratingsTotal: 250 All time: 7,925 This week: 49Up
Version License PHP version Categories
singleton-trait 3.2MIT/X Consortium ...5.4PHP 5, Language, Design Patterns, Traits
Description 

Author

Asher Wolfstein

This is a trait that adds singleton pattern to a class.

The trait can allow the creation of the first object of the class taking optional configuration parameters.

Classes that use the trait may override the init() method to process the parameters that may be restricted to the first instantiation of the object.

Picture of Asher Wolfstein
  Performance   Level  
Name: Asher Wolfstein <contact>
Classes: 15 packages by
Country: United States United States

Level 4 StarStarStarStar

 Innovation award
Innovation award
Nominee: 5x

Example

<?php

require_once('SingletonTrait.php');

use Falcraft\Patterns;

class TestSingleton {
    use Patterns\SingletonTrait;
   
    public $publicprop;
    private $privateprop;
    public static $staticProp = null;
   
    public function init($testarg1, $testarg2)
    {
        $this->publicProp = $testarg1;
        $this->privateProp = $testarg2;
        self::$staticProp = 5;
    }
   
    public function getPrivateProp()
    {
        return $this->privateProp;
    }
   
    public function setStaticProp($staticarg)
    {
        self::$staticprop = $staticarg;
    }
}

echo "Falcraft\\Patterns\\SingletonTrait.php Test\n";
echo "------------------------------------------\n\n";

echo "Instantiating Singleton with Arguments -> ";

$success = true;

$testSingletonInstance = null;

try {
    $testSingletonInstance = TestSingleton::instantiate(1, 2);
} catch (\Exception $e) {
    $success = false;
}

if ($success) {
    echo "Success!\n";
} else {
    echo "Failure...\n";
}

echo "Check Hardened Through Static Call -> ";

$success = true;

$hardened = false;

try {
    $hardened = TestSingleton::hardened();
} catch (\Exception $e) {
    $success = false;
}

if ($hardened == false) {
    $success = false;
}

if ($success) {
    echo "Success: " . ( $hardened ? "Hardened\n" : "Not Hardened\n" );
} else {
    echo "Failure...: " . ( $hardened ? "Hardened\n" : "Not Hardened\n" );
}

echo "Check Hardened Through Member Function -> ";

$success = true;

try {
    $hardened = $testSingletonInstance->hardened();
} catch (\Exception $e) {
    $success = false;
}

if ($hardened == false) {
    $success = false;
}

if ($success) {
    echo "Success: " . ( $hardened ? "Hardened\n" : "Not Hardened\n" );
} else {
    echo "Failure...: " . ( $hardened ? "Hardened\n" : "Not Hardened\n" );
}

echo "Instantiate Again Into Alternate Local Variable -> ";

$success = true;

$testSingletonInstanceTwo = null;

try {
    $testSingletonInstanceTwo = TestSingleton::instantiate();
} catch (\Exception $e) {
    $success = false;
}

if ($success) {
    echo "Success!\n";
} else {
    echo "Failure...\n";
}

echo "Instantiate Into Another Local Variable with Arguments -> ";

$success = false;

try {
    $testSingletonHardenedTest = TestSingleton::instantiate(4, 5);
} catch (\Exception $e) {
    $success = true;
}

if ($success) {
    echo "Success: Exception Raised\n";
} else {
    echo "Failure...: No Exception Raised\n";
}

echo "Accessing Private Attribute With Member Function -> ";

$success = true;

$privateProp = null;
$privateProp2 = null;

try {
    $privateProp = $testSingletonInstance->getPrivateProp();
    $privateProp2 = $testSingletonInstanceTwo->getPrivateProp();
} catch (\Exception $e) {
    $success = false;
}

if ($success) {
    echo "Success: $privateProp, $privateProp2\n";
} else {
    echo "Failure...\n";
}

echo "Accessing Public Attribute Without Member Function -> ";

$success = true;

$publicProp = null;
$publicProp2 = null;

try {
    $publicProp = $testSingletonInstance->publicProp;
    $publicProp2 = $testSingletonInstanceTwo->publicProp;
} catch (\Exception $e) {
    $success = false;
}

if ($success) {
    echo "Success: $publicProp, $publicProp2\n";
} else {
    echo "Failure...\n";
}

echo "Setting And Accessing Public Static Singleton Attribute -> ";

$success = true;

$staticProp = null;

try {
    TestSingleton::$staticProp = 9;
    if (TestSingleton::$staticProp == 9) {
        $success = true;
    } else {
        $success = false;
    }
} catch (\Exception $e) {
    $success = false;
}

if ($success) {
    echo "Success!\n";
} else {
    echo "Failure...\n";
}

echo "\n";

  Files folder image Files (15)  
File Role Description
Files folder imageFalcraft (1 directory)
Files folder imagesrc (1 directory)
Files folder imagetests (1 directory)
Accessible without login Plain text file composer.json Conf. Composer File
Accessible without login Plain text file LICENSE.txt Lic. License (MIT)
Accessible without login Plain text file phpunit.xml Test Unit Testing
Accessible without login Plain text file README.txt Doc. README

  Files folder image Files (15)  /  Falcraft  
File Role Description
Files folder imagePatterns (2 files, 2 directories)

  Files folder image Files (15)  /  Falcraft  /  Patterns  
File Role Description
Files folder imageException (2 files)
Files folder imageResource (1 file)
  Accessible without login Plain text file SingletonExampleAndTest.php Example A registry singleton example
  Plain text file SingletonTrait.php Class The Singleton Trait

  Files folder image Files (15)  /  Falcraft  /  Patterns  /  Exception  
File Role Description
  Plain text file ExceptionInterface.php Class Custom/Local Exception Interface
  Plain text file RuntimeException.php Class Custom/Local Runtime Exception

  Files folder image Files (15)  /  Falcraft  /  Patterns  /  Resource  
File Role Description
  Plain text file SingletonInterface.php Class An interface to identify singletons, separate from trait

  Files folder image Files (15)  /  src  
File Role Description
Files folder imagePhabstractic (1 file, 1 directory)

  Files folder image Files (15)  /  src  /  Phabstractic  
File Role Description
Files folder imagePatterns (2 directories)
  Accessible without login Plain text file falcraftLoad.php Conf. Loader

  Files folder image Files (15)  /  src  /  Phabstractic  /  Patterns  
File Role Description
Files folder imageException (2 files)
Files folder imageResource (2 files)

  Files folder image Files (15)  /  src  /  Phabstractic  /  Patterns  /  Exception  
File Role Description
  Plain text file ExceptionInterface.php Class exception classification
  Plain text file RuntimeException.php Class exception classification

  Files folder image Files (15)  /  src  /  Phabstractic  /  Patterns  /  Resource  
File Role Description
  Plain text file SingletonInterface.php Class Main Trait
  Plain text file SingletonTrait.php Class Main Trait

  Files folder image Files (15)  /  tests  
File Role Description
Files folder imagePhabstractic (1 directory)

  Files folder image Files (15)  /  tests  /  Phabstractic  
File Role Description
Files folder imagePatterns (1 directory)

  Files folder image Files (15)  /  tests  /  Phabstractic  /  Patterns  
File Role Description
Files folder imageResource (1 file)

  Files folder image Files (15)  /  tests  /  Phabstractic  /  Patterns  /  Resource  
File Role Description
  Accessible without login Plain text file SingletonTrait.php Test unit testing

The PHP Classes site has supported package installation using the Composer tool since 2013, as you may verify by reading this instructions page.
Install with Composer Install with Composer
Downloadsingleton-trait-2016-07-10.zip 13KB
Downloadsingleton-trait-2016-07-10.tar.gz 5KB
Install with ComposerInstall with Composer
 Version Control Reuses Unique User Downloads Download Rankings  
 0%1
Total:250
This week:0
All time:7,925
This week:49Up

  Applications that use this package  
No pages of applications that use this class were specified.

Add link image If you know an application of this package, send a message to the author to add a link here.


  Other classes that need this package  
Class Why it is needed Dependency
PHP Registry with Singleton Trait Required to make registry a singleton Required

  Related pages  
Location in Git Hub Repository
Info on Singleton Pattern
Traits Explanation
Singleton Class Explanation