Jaxon

Jaxon permet de définir des options lors de la déclaration des namespaces, classes et fonctions.

Ces options peuvent s'appliquer au code PHP, au code Javascript, ou aux deux.

Les options PHP

Lorsqu'elle s'applique au code PHP, les options sont ajoutées aux métadonnées des classes et fonctions. Elles seront prises en compte lors de leur traitement.

C'est le cas par exemple des options pour les callbacks de classes, ou pour l'upload.

Les options Javascript

Lorsqu'elle s'applique au code Javascript, les options sont ajoutées aux paramètres des requêtes Ajax vers les classes et fonctions.

C'est le cas par exemple des options pour les callbacks Javascript, ou pour l'upload.

L'option excluded

L'option excluded est différente, car elle va plutôt indiquer qu'une classe ou une méthode publique PHP ne doit pas être exportée vers Javascript.

    'app' => [
        'directories' => [
            [
                'path' => '/the/class/dir',
                'namespace' => '\\Ns',
                'classes' => [
                    \Ns\App\FirstClass::class => [
                        'excluded' => true,
                    ],
                    \Ns\App\SecondClass::class => [
                        'functions' => [
                            'doThat' => [
                                'excluded' => true,
                            ]
                        ]
                    ]
                ]
            ]
        ]
    ]

use Jaxon\Jaxon;

jaxon()->register(Jaxon::CALLABLE_DIR, '/the/class/dir', [
    'namespace' => 'Ns',
    'classes' => [
        \Ns\App\FirstClass::class => [
            'excluded' => true,
        ],
        \Ns\App\SecondClass::class => [
            'functions' => [
                'doThat' => [
                    'excluded' => true,
                ]
            ]
        ]
    ]
]);

// Cette classe ne sera pas exportée en javascript.
/**
 * @exclude
 */
class FirstClass
{
}

class SecondClass
{
    /**
     * @exclude
     */
    public function doThat()
    {
        // Cette méthode ne sera pas exportée en javascript.
    }
}

class SecondClass
{
    /**
     * @exclude true
     */
    public function doThat()
    {
        // Cette méthode ne sera pas exportée en javascript.
    }

    /**
     * @exclude false
     */
    public function doThis()
    {
        // Cette méthode sera exportée en javascript.
    }
}