POO - FACTORY CLASS

---

Auteur : Waredan

Ecrire un message privé
Commentaire sur cette source (2)
Ajouter un commentaire et/ou une note

Une classe générique qui implémente le factory design pattern en utilisant la Reflection API de PHP 5, les espaces de noms et le chargement automatique.

(Il y'avait déjà une source similaire par Naixn, celle-çi est plus évoluée et mise à jour PHP 5.3)

Avec l'arrivée des espaces de noms, on peut désormais utiliser les fonctions de chargements automatiques natives de PHP qui sont un peu plus rapide qu'une fonction définie par __autoload(). Enfin, ajoutons l'utilisation de la Reflection API de PHP 5, on dispose alors de tout les éléments pour avoir une classe assez générique responsable de la "fabrication" d'un objet.

Si vous souhaitez ajouter des conditions, comme par exemple vérifier l'héritage d'une classe ou l'implémentation d'une interface, il vous suffit de les définir dans vos propres méthodes.

<?php
abstract class Database
{
    protected $_dsn      = null;
    protected $_username = null;
    protected $_password = null;

    public function __construct($dsn, $username = null, $password = null)
    {
        $this->_dsn      = (string) $dsn;
        $this->_username = (string) $username;
        $this->_password = (string) $password;
    }

    static public function factory($classname, $argument)
    {
        if (func_num_args() === 2) {
            $object = Factory::newInstance($classname, $argument);
        }
        else {
            $object = Factory::newInstanceArgs($classname, array_slice(func_get_args(), 1));
        }

        if (!is_a($object, __CLASS__)) {
            throw new InvalidArgumentException(sprintf('The class `%s` is not of `%s`', get_class($object), __CLASS__));
        }

        return $object;
    }
}

class MySQL extends Database
{
    public function __toString()
    {
        return __CLASS__        . PHP_EOL
             . $this->_dsn      . PHP_EOL
             . $this->_username . PHP_EOL
             . $this->_password . PHP_EOL;
    }
}

class SQLite
{
    protected $_dsn = null;

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

    public function __toString()
    {
        return __CLASS__        . PHP_EOL
             . $this->_dsn      . PHP_EOL;
    }
}

// prints: MySQL mysql:dbname=test;host=localhost root root
// echo Database::factory('MySqL', 'mysql:dbname=test;host=localhost', 'root', 'root');

// prints (InvalidArgumentException): The class `SQLite` is not of Database
// echo Database::factory('SQLite', 'sqlite:test.sqlite3');
?>

Alternativement, avec l'utilisation de la fonction "get_called_class" de PHP 5.3, on peut par exemple avoir une classe Database étendant "Factory", l'appel alors des méthodes "newInstance" et "newInstanceArgs" (avec modifications) chercheront alors si la classe que l'on souhaite instancier hérite de la classe dans laquelle on appel ces méthodes uniquement si ce n'est pas dans la classe "Factory" elle-même.

<?php
abstract class Database extends Factory
{
    protected $_dsn      = null;
    protected $_username = null;
    protected $_password = null;

    public function __construct($dsn, $username = null, $password = null)
    {
        $this->_dsn      = (string) $dsn;
        $this->_username = (string) $username;
        $this->_password = (string) $password;
    }
}

class MySQL extends Database
{
    public function __toString()
    {
        return __CLASS__        . PHP_EOL
             . $this->_dsn      . PHP_EOL
             . $this->_username . PHP_EOL
             . $this->_password . PHP_EOL;
    }
}

class SQLite
{
    protected $_dsn = null;

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

    public function __toString()
    {
        return __CLASS__        . PHP_EOL
             . $this->_dsn      . PHP_EOL;
    }
}

// prints: MySQL mysql:dbname=test;host=localhost root root
// echo Database::newInstanceArgs('MySqL', array('mysql:dbname=test;host=localhost', 'root', 'root'));

// prints (InvalidArgumentException): The class `SQLite` is not of Database
// echo Database::newInstance('SQLite', 'sqlite:test.sqlite3');

// prints: SQLite sqlite:test.sqlite3
// echo Factory::newInstance('SQLite', 'sqlite:test.sqlite3');
?>

et les méthodes "Factory::newInstance" et "Factory::newInstanceArgs" aurait une condition, avant l'instanciation, similaire à :

<?php
$calledClass = get_called_class();

if ($calledClass !== __CLASS__ && !$reflectionClass->isSubclassOf($calledClass)) {
    throw new InvalidArgumentException(sprintf('Class `%s` is not of `%s`', $reflectionClass->getName(), $calledClass));
}
?>

Mais pour des fabrications nécessitant des conditions plus complexes, le premier exemple reste le plus approprié.

Télécharger le zip