# Introduction

`Zend_CodeGenerator` est un outils permettant de générer du code PHP en utilisant une interface orientée objet. Il peut générer ou mettre à jour du code. Il est aussi possible d'étendre ces classes afin de changer le langage de référence pour générer du Javascript, des hôtes virtuels Apache ..., par exemple.

## Théorie

Dans la plupart des cas, vous créerez une instance du générateur de code, et vous le configurez. Pour afficher le code généré, un simple echo suffira, ou l'appel à sa méthode `generate()`.

    // Passage de configuration au constructor:
    $file = new Zend_CodeGenerator_Php_File(array(
        'classes' => array(
            new Zend_CodeGenerator_Php_Class(array(
                'name'    => 'World',
                'methods' => array(
                    new Zend_CodeGenerator_Php_Method(array(
                        'name' => 'hello',
                        'body' => 'echo \'Hello world!\';',
                    )),
                ),
            )),
        )
    ));

    // Configuration après instanciation
    $method = new Zend_CodeGenerator_Php_Method();
    $method->setName('hello')
           ->setBody('echo \'Hello world!\';');

    $class = new Zend_CodeGenerator_Php_Class();
    $class->setName('World')
          ->setMethod($method);

    $file = new Zend_CodeGenerator_Php_File();
    $file->setClass($class);

    // Rendu du fichier généré:
    echo $file;

    // 2criture du fichier généré:
    file_put_contents('World.php', $file->generate());

Les 2 exemples ci-dessus vont rendre le même résultat :

    <?php

    class World
    {

        public function hello()
        {
            echo 'Hello world!';
        }

    }

Il est aussi possible de mettre à jour un code existant, par exemple, ajouter une méthode à une classe. Dans ce cas, vous devez inspecter le code existant en utilisant la réflexion, puis ajouter une nouvelle méthode. `Zend_CodeGenerator` rend ceci très simple en utilisant Zend_Reflection.

Par exemple, imaginons que nous avons sauvegardé le code de l'exemple ci-dessus dans un fichier "`World.php`" que nous avons alors inclus. Nous pourrions dès lors agir comme suit :

    $class = Zend_CodeGenerator_Php_Class::fromReflection(
        new Zend_Reflection_Class('World')
    );

    $method = new Zend_CodeGenerator_Php_Method();
    $method->setName('mrMcFeeley')
           ->setBody('echo \'Hello, Mr. McFeeley!\';');
    $class->setMethod($method);

    $file = new Zend_CodeGenerator_Php_File();
    $file->setClass($class);

    // Rendu du code généré
    echo $file;

    // Ou encore sauvegarde par dessus l'ancien fichier
    file_put_contents('World.php', $file->generate());

La nouvelle classe ressemblera à ça :

    <?php

    class World
    {

        public function hello()
        {
            echo 'Hello world!';
        }

        public function mrMcFeeley()
        {
            echo 'Hellow Mr. McFeeley!';
        }

    }