Un composant de service est implémenté sous forme de classe.
Pour l'identifier, il doit contenir une annotation
@service
. L'exécutable SCA
va utiliser le nom du fichier de script pour déterminer le nom
du composant, par convention. La classe et le fichier de script
doivent donc porter le même nom.
Les composants PHP SCA doivent toujours exposer un service, et il n'y a
aucun moyen pour un composant d'être appelé autrement que comme le
résultat d'un service Web, ou bien directement par un autre composant
ou un script. Pour cette raison, un composant PHP SCA valide va toujours
contenir une annotation @service
et au moins une
méthode publique.
Chaque composant SCA requiert que le script SCA.php soit inclus. En plus de contenir la définition de la classe SCA, ce script contient du code PHP qui est exécuté à chaque appel, et qui est responsable du comportement général du composant.
Il est très important que les autres inclusions de votre script interviennent avant celle du fichier SCA.php. S'il y a des inclusions après SCA.php, ils ne seront pas pris en compte lorsque l'exécutable SCA traitera votre classe.
L'exemple ci-dessous montre la structure générale.
Exemple #1 Structure d'un composant SCA pour PHP
<?php
// les inclusions
include "SCA/SCA.php";
/**
* @service
*/
class ConvertedStockQuote {
// variables, logique métier, inclusion d'au moins une méthode publique
}
?>