Nouvelles
03 juin 2013 - Mise à jour multiples de la plateforme et du projet WsdlToPhp
- Mise à jour de la plateforme :
- Intialisation du Blog : dans le but de partager des informationsi, des conseils et des exemples de code. Ce blog sera utilisé pour vous montrer comment utiliser le générateur sur notre plateforme. De plus, nous partagerons avec vous des informations à propos des problèmes que nous rencontrons.
- Revue du design de la page d'accueil : notre plateforme est sur le point d'avoir de nouvelles fonctionnalités dans les prochains mois, de ce fait nous mettons à jour doucement mais sûrement son design et ses contenus.
- A partir de maintenant, vous devez indiquer votre adresse email afin que nous puissions vous contacter dans le cas où une erreur survient lors de la génération de la librairie que vous ne pourriez résoudre par vous-même.
- De plus, si nous sommes amenés à nous justifier sur la publication d'un WSDL, nous vous contacterions alors pour connaître les raisons pour lesquelles vous l'avez publié.
- Nous voulons également vous rassurer que nous ne divulguerons jamais votre adresse à qui que ce soit, elle reste privée !
- Les projets que nous utilisons : cette page contient des crédits pour l'ensemble des projets que nous utilisons sur notre plateforme. Comme nous utilisons plusieurs projets libre d'utilisation, nous sommes plutôt fiers de la vous faire savoir que nous sommes satisfaits de leur utilisation.
- Souscrire à notre lettre d'information : lorsque vous générez une librairie, vous pouvez souscrire à notre lettre d'informations. Nous utilisons MailChimp pour gérer notre lettre d'information. Ne vous inquiétez pas, vous ne serez pas spammés car à ce jour, nous n'avons pas encore préparé de lettre d'information, mais cela devrait arriver par la suite.
- Mise à jour du projet WsdlToPhp:
- Nous avons principalement ajouter une méthode générique de définition des tags de documentation PHP pour chaque fichier et classe généré. Cette amélioration a été faite grâce à l'initiative de Gemorroj sur Github. Nous utilisons ainsi cette évolution sur notre plateforme pour ajouter les tags @author, @version et @date aux librairies générées.
- Nous avons également corrigé quelques incohérences.
- A partir de maintenant, nous ne listerons plus chaque mise à jour car vous pouvez facilement les retrouver sur la plateforme de partage de votre choix que vous pouvez retrouver sur la page d'A propos.
23 avril 2013 - Mises à jour sur le projet WsdlToPhp
- Plusieurs mises à jour ont été apporté au projet WsdlToPhp et sont listées ci-dessous :
- Correction d'un bug mineur. Le bug se produisait rarement lors de la définition des entêtes Soap dans la documentation PHP des classes de type Service déployé sur Gihutb, Source Forge et Google Code
- Correction mineure de la documentation des affecteurs générés des classes générées de type Struct : déployé sur Github, Source Forge et Google Code
- Amélioration de la récupération de la documentation des classes de type Struct : déployé sur Github, Source Forge et Google Code
- Ajout de la méthode générique __set_state() à la classe générée WsdlClass et à chaque classe générée de type Struct. On s'assure également que les méthodes magiques de PHP ne soient pas surchargées dans les classes générées. Tout est déployé sur Github, Source Forge et Google Code
10 avril 2013 - Corrections et amélioriations du projet WsdlToPhp
- Correction dans les méthodes générées setSoapHeader*() et améliorations : déployé sur Github, Source Forge et Google Code
- Correction du nmo du paramètre lors de l'instanciataion de l'objet Soapheader dans la méthode setSoapHeader*()
- Ajout de la méthode *WsdlClass::setLocation($_location) afin de faciliter la définition de l'URL du Web service
- On s'assure que chaque méthode générée ne surcharge par une méthode existante de *WsdlClass
- Amélioration de la méthode WsdlToPhpModel::getValueWithinItsType() afin de retourner la valeur null quand cela est nécessaire même lorsque la valeur attendue est un entier (0 était retourné précédemment au lieu de null)
08 avril 2013 - Nouvelles méthodes dans *WsdlClass
- Deux méthodes principales ont été ajoutées à la classe WsdlClass générée : déployé sur Github, Source Forge et Google Code
- getLastRequest($_asDomDocument = false) : cette méthode retourne le résultat retourné par l'appel de la méthode SoapClient::__getLastRequest() mais à la différence près que le résultat est est formaté avec une indentation en utilisant la classe native PHP DOMDocument. Comme cette classe est utilisée, la méthode peut retourner l'objet à la place de la chaine de caractères si cela vous convient mieux.
- getLastResponse($_asDomDocument = false): cette méthode retourne le résultat retourné par l'appel de la méthode SoapClient::__getLastResponse() mais à la différence près que le résultat est formaté avec une indentation en utilisant la classe native PHP DOMDocument. Comme cette classe est utilisée, la méthode peut retourner l'objet à la place de la chaine de caractères si cela vous convient mieux.
- Ces deux méthodes utilisent une troisième méthode nommée getFormatedXml($_string,$_asDomDocument = false). Cette méthode reçoit une chaine de caractères comme premier paramètre et une valeur logique comme deuxième paramètre afin d'indiquer à la méthode si le résultat doit être une chaine de caractères formatée ou un objet DOMDocument. de ce fait, vous pouvez utiliser cette méthode pour tout autre besoin.
06 avril 2013 - Le projet WsdlToPhp a été mis à jour !
- Le projet a été mise à jour sur : Github, Source Forge et Google Code.
- La mise à jour comprend :
- Une nouvelle fonctionnalité : afin de faciliter l'utilisation des méthodes générées lorsque une/des entête(s) Soap est/sont nécessaire(s), de nouvelles méthodes sont maintenant générées. En effet, la définition des entêtes Soap peut s'avérer compliquée et difficile à comprendre surtout lorsque vous ne maitrisez pas totalement l'utilisation des classes générées. Ainsi la méthode setSoapHeader{soap header name} est générée dans la classe de type Service pour chaque paramètre d'entête Soap attendu. Cette méthode est plutôt simple d'utilisation car les paramètres attendus ressemblent forts à ceux de la méthode native Soapheader::__construct. L'avantage est que la plupart du temps, vous n'aurez que le premier paramètre à définir, c'est-à-dire la valeur d'entête à envoyer, car les appels nécessaires à la définition des entêtes sont encapsulées dans la méthode générée.
- information meta "from schema" : cette nouvelle information est maintenant ajoutées dans le bloc de documentation de chaque classe générée de type Enum et Struct. Cette information est très utile lorsque le WSDL inclut/importe plus d'un schéma et que vous ne savez pas quel schéma déclare l'élément de type Enum ou Struct.
- *WsdlClass::__construct(,$_resetSoapClient = true) : le constructeur généré accepte dorénavant un second paramètre afin de permettre de désactiver la redéfinition de l'objet SoapClient. Ceci est utile lorsque vous avez besoin de conserver l'état de l'objet SoapClient ente deux appels de service distinct.
- WsdlToPhpModel::getValueWithinItsType(,$_knownType = null) : la méthode accepte maintenant un second paramètre, une chaine de caractères, afin d'informer la méthode du type attendu de la valeur. Le comportement par défaut est conservé.
- *Struct*::__construct() : le bloc de documentation et son corps prennent dorénavant en compte le fait de si la classe *WsdlClas est générée ou non. Si la classe *WsdlClass n'est pas générée, alors la méthode fait appel aux propres définisseurs de la classe ce qui est indiqué dans le bloc de documentation.
20 février 2013 - Mises à jour du projet WsdlToPhp et du site depuis la dernière fois
- Mises à jour du projet :
- différentciation entre WsdlToPhpGenerator::manageWsdlNodeElement() et WsdlToPhpGenerator::manageWsdlNodeAttribute(), déployé sur Github, SourceForge et Google Code
- nombreuses mises à jour de la documentation php et des comportements des méthodes de chque classe , déployé sur Github, SourceForge et Google Code
- amélioration de la documentaion PHP générée demandée dans la Github pull request, déployé sur Github, SourceForge et Google Code
- nouvelle fonctionnalité : les classes générées peuvent maintenant être classés par leur, c'est-à-dire selon la valeur retournée par la méthode WsdlToPhpModel::getContextualPart(), les sous-dossiers sont alors inutiliés dans ce cas, déployé sur Github, SourceForge et Google Code
- Mise à jour du site : vous pouvez dorénavant utilisé la nouvelle "Catégorisation Principale des Dossiers" intitulée "Basé sur le type de la classe" dans l'onglet "Options Générales" avant de soumettre votre WSDL
04 février 2013 - Ajout de la nouvelle fonctionnalité "audit" et améliorations apportées
- Mises à jour du projet WsdlToPhp : nouvelle fonctionnalité (audit), déployés sur Github, SourceForge et Google Code
- Audit est une nouvelle fonctionnalité qui permet de déterminer ce qui prend le plus de temps durant le processus de génération complet. Il enregistre les informations (nombre d'appels, temps passé et dernier appel) afin que chaque appel soit audité. L'audit est rempli en appelant la méthode WsdlToPhpGenerator::auditInit() au début d'une méthode et la méthode WsdlToPhpGenerator::audit() pour calculer le temps passé ainsi que le nombre d'appels. Les informations d'audit sont enregistrées dans la variable globale de la classe WsdlToPhpGenerator. L'audit peut être accédé en appelant la méthode WsdlToPhpGenerator::getAudit() qui retourne une tableau associatif des appels audités
- Améliorations de la détermination de l'héritage de classe, de la détermination des types de paramètre et retour des opérations ainsi que de la détermination du type des attributs des structures en parcourant les schémas séquentiellement afin d'analyser plusieurs balises particulières (header, list, union, attribute, input, output)
- Amélioration de la gestion des localisation afin de permettre de charger des schémas stockés localement
- Revue mineur de la déclaration des attributs des classes de type WsdlToPhpModel
- Revue mineur du système de documentation pour la documentation PHP
- Toutes ces mises à jour sont disponibles sur le site and accessibles dès maintenant (sauf pour l'audit qui est utilisé en arrière plan)
29 janvier 2013 - Récupération des types de entêtes SOAP et amélioration du nommage des classes générées
- Récupération du type des entêtes SOAP depuis les WDSDL, déployée sur Github, SourceForge et Google Code
- Mises à jour mineures et amélioration de la génération des classes afin d'avoir des classes (structures, services, énumérations) avec un nom unique (sensiblement à la casse), déployés sur Github, SourceForge et Google Code
22 janvier 2013 - Mise à jour du site et du projet WsdlToPhp
- Mises à jour du site : Le site utilise dorénavant toute la largeur du navigateur
- Les WSDLs sont regroupés par leur date de création (la ligne de couleur bleue indique la date de première publication du WSDL)
- Chaque option de génération est maintenant affichées dans une colonne facilitant la comparaison entre les librairies générées
- Les librairies générées sont regroupées par leur date de création, de la même manière que la liste des WSDLs
- Lorsque vous cliquez sur un fichier pour voir son contenu, l'icône le représentant se change en une icône de chargement durant le chargement du contenu
- Mises à jour du projet WsdlToPhp :
- Récupération du namespace du SOAPHeader et ajout de cette information à la documentation php de l'opération associée, déployé sur Github, SourceForge et Google Code
- Plusieurs mises à jour regroupées : déployées sur Github, SourceForge et Google Code
- Correction de la détermination de la localisation définie par les balises import lorsque le chemin est relatif et contient "../"
- Amélioration de la documentation PHP pour indiquer si le(s) SOAPHeader(s) est/sont obligatoire(s) ou non, par défaut le(s) SOAPHeader(s) est/sont considéré(s) comme obligatoire(s) à moins que l'attribut "required" n'indique le contraire
- Ajout de plusieurs cas d'exemples pour les SOAPHeaders et autres
18 janvier 2013 - Améliorations sur la documentation PHP générée et nouvelle fonctionnalité
- Améliorations globales sur la documentation php et nouvelle fonctionnalité : déployées sur Github, SourceForge et Google Code
- Amélioration de la documentation php pour les marqueurs @uses lorsque les attributs sont hérités (modification du comportement de WsdlToPhpStruct::getAttributes() !)
- Mise à jour mineure lors de la génération de commentaire à partir d'un commentaire de type tableau par la suppression de l'espace après la virgule
- Amélioration de la détection et de la détermination des entêtes SOAP
- Introduction de la valeur globale dédiée à la classe WsdlToPhpGenerator afin de stocker des valeurs globales et de pouvoir les supprimer d'un seul coup
- Ajout de nombreux cas d'exemples pour la détection des entêtes SOAP
17 janvier 2013 - Améliorations diverses du projet
- Amélioration du commentaire principale de code de la classe WsdlTophpGenerator pour http://phpdoc.wsdltophp.com
- Amélioration de l'extraction de la documentation depuis le WSDL pour les structures, déployé sur Github, SourceForge et Google Code
16 janvier 2013 - Nouvelles fonctionnalités et amélioration pour le projet WsdlToPhp
- Nouvelles fonctionnalités et améliorations : déployées sur Github, SourceForge et Google Code
- Nouvelle fonctionnalité : récupération des informations des entêtes qui doivent être envoyées lors de l'appel d'une opération. Si un entête SOAP est requis, il est indiqué dans le commentaire de code de l'opération/de la fonction (SOAPHeader : required). De plus, les noms et types des entêtes SOAP sont extraites du WSDL et ajoutées au commentaire de code de l'opération/de la fonction (SOAPHeaderNames et SOAPHeaderTypes) séparés par une virgules.
- Optimisation du chargement des emplacement WSDL.
- Non ajout des structures "virtuelles" (aka les restrictions qui ne sont pas des énumérations) au tableau du mappage des classes dans ClassMap.
- On s'assure que les informations meta soit nettoyées et générées correctement que ce soit une chaine de caractères ou un tableau de valeur
- Ajout de cas de test
15 janvier 2013 - Amélioration et correction de bug du projet
- Améliorations et corrections de bugs : déployées sur Github, SourceForge et Google Code
- Ajout de la notion de propriétaire afin de connaitre le propriétaire de la valeur/l'attribut en cours ou de la fonction. Le propriétaire doit être un objet du type WsdlToPhpModel.
- On s'assure d'un nommage sensible à la casse pour les methods (accesseurs, affecteurs et opérations) par l'utilisation de la méthode générique WsdltoPhpModel::uniqueName().
- Ordonnancement sensible à la casse des types retournés dans le commentaire de code de la méthode getResult().
- Revue de la méthode WsdlTophpStructValue::getCleanName() afin de corriger le bug #6 déclaré sur Github concernant : "PHP Warning : Strict Standards: Declaration of WsdlToPhpStructValue::getCleanName() should be compatible with WsdlToPhpModel::getCleanName() in WsdlToPhpStructValue.php on line 107"
14 janvier 2013 - Intégration des mises à jour en provenance de Github
- Intégration des mises à jour poussées sur Github concernant les commentaires de doc php, déployé sur Github, SourceForge et Google Code
- Mise à jour mineure afin d'éviter la génération des structures vides (sans aucun attribut) qui n'héritent pas d'une autre structure générée, déployé sur Github, SourceForge et Google Code
02 janvier 2013 - Nouvelle version du projet WsdlToPhp
- Cette nouvelle version rend la classe WsdlToPhp classe dépréciée et remplacée par la classe WsdlToPhpGenerator, de même que le fichier samples.php est déprécié en faveur du fichier samples-generator.php. La classe WsdlToPhpGenerator utiliser un ensemble de classe qui héritent de la nouvelle classe nommée WsdlToPhpModel. Les classes sont :
- WsdlToPhpFunction : une opération
- WsdlToPhpService : un ensemble d'opérations représentées par des objets de type WsdlToPhpFunction
- WsdlToPhpStructAttribute : un attribut d'une structure
- WsdlToPhpStructValue : une valeur d'une structure
- WsdlToPhpStruct : une structure qui représente une requête, une réponse, une énumération de valeurs ou tout objet utile défini par le WSDL
- WsdlToPhpModel : défini les méthodes et fonctionnalités génériques aux classes citées précédemment
- WsdlToPhpGenerator est basé sur la classe originelle WsdlToPhp mais a été entièrement revue afin d'utiliser les nouvelles classes. Ce nouvel ensemble de classe permet d'appliquer les évolutions et corrections de bugs beaucoup plus facilement.
- Cela inclus également des corrections de bugs et certaines incompréhension sur le contenu du WSDL et de ses structures
- Dorénavant, cela ajoute une bonne documentation PHP afin de pouvoir générer la PHPDoc à l'aide de PHPDocumentor. Cela introduit la notion de package, subpackage avec l'amélioration génération de la documentation
- De plus, les classes générées sont strictement séparées par leur nommage :
- {PackageName}Service : classe rassemblant les opérations/méthodes (basé sur leur nom)
- {PackageName}Struct : classe représentant une structure pour une requête ou une réponse
- {PackageName}Enum* : classe représetant les énumérations de valeurs. Chaque valeur est définie avec une constante
- {PackageName}WsdlClass : classe mère de toutes les classes générées. Celle classe défini les méthodes génériques et les configurations/méthodes utiles à l'appel du WebService SOAP
- {PackageName}ClassMap : classe contenant une méthode publique statique finale retournant le tableau d'association entre les entités SOAP et les classes générées
- Vous pouvez visualiser la documentation PHP de cette librairie ici : http://phpdoc.WsdlToPhp.com/.
- Pour encore plus d'informations, lire aussi le commentaire principal dans le fichier de la classe WsdlToPhpGenerator pour voir les fonctionnalités ainsi que les types de tests réalisés.
- Déployé sur Github, SourceForge et Google Code et sur ce site bien entendu.
17 décembre 2012 - Correction de bug sur les classes de type structure
- Correction d'un bug à la génération des types possédant des restrictions mais n'étant pas des énumérations. Récupération de la restriction et ajout de cette information au bloc de commentaire, déployé sur Github, SourceForge et Google Code
06 décembre 2012 - Amélioration du projet WsdlToPhp
- Correction du fichier d'exemple pour les paramètres de type inconnu, mise à jour des commentaires de code pour les classes de service, mise à jour du commentaire de code la méthode getResult afin d'avoir des types de retour unique, mise à jour du commentaire de code du fichier d'auto-chargement, mise à jour des méthodes d'opérations ayant pour paramètre un type inconnu, déployé sur Github, SourceForge and Google Code
- Améliorations pour éviter les alertes PHP et pour mieux déterminer la localisation des schéma d'import, déployé sur Github, SourceForge and Google Code
01 décembre 2012 - Site disponible en Français !
29 novembre 2012 - Ajout du champ de recherche sur le site
- Vous pouvez dorénavant rechercher un WSDL ou une librairie depuis la barre de navigation haute ou depuis la page de recherche
14 novembre 2012 - Revue de code et améliorations
- Revue importante du code sur : documentation PhpDoc des classes générées, définition et identification des noms des structures, définition des types des valeurs des constantes, améliorations sur le nommage des paramètres et sur la détermination de leur présence, améliorations déployées sur Github, SourceForge et Google Code
- Améliorations sur la génération de la librairie et sur la récupération du contenu du WSDL
05 novembre 2012 - Amélioration de l'héritage des classes
- Améliorations sur l'héritage du à la casse et un test de sécurité inutile. Les améliorations ont été effectué après avoir été détectées suite à la génération de PartnerService, améliorations déployées sur Github, SourceForge et Google Code
03 novembre 2012 - Régénération de toutes les librairies sur le site
- Régénération de toutes les librairies afin de tirer partie des mises à jour effectuées jusqu'à ce jour
01 novembre 2012 - Correction d'un bug pour le fichier d'exemple
- Correction d'un bug lors de la génération du fichier d'exemple, tous les "_" étaient supprimés du nom de la classe utilisée, correctif déployé sur Github, SourceForge et Google Code
31 octobre 2012 - Correction de bugs du projet WsdlToPhp
- Correction de bugs : le nom de la variable dans le fichier d'exemple était "$this" au lieu du nom réel de la variable en cours, correctif déployé sur Github, SourceForge et Google Code
- l'emplacement de schémas définis par les balises d'import est dorénavant pris en compte dans la plupart des cas, même si l'emplacement n'est pas contenu par l'attribut dédié à cette information
- les attributs de classe sont maintenant défini de manière unique et non plus plusieurs fois comme auparavant, correctif déployé sur Github, SourceForge et Google Code
- les structures peuvent maintenant être du type défini dans le WSDL en cours
- correction d'un bug lors de la définition de l'option optionSendParametersAsArray qui désactivé optionSendArrayAsParameter même si optionSendArrayAsParameter était activé précédemment, correctif déployé sur Github, SourceForge et Google Code
30 octobre 2012 - Améliorations du projet WsdlToPhp et du site
- Amélioration de la classe WsdlToPhp afin d'éviter des boucles infinies lors de la gestion des l'héritage, correctif déployé sur Github, SourceForge et Google Code
- Amélioration sont effectives sur ce WSDL
- Mise en place de la pagination lors de la visualisation de la liste des WSDLs
- Améliorations techniques diverses sur le site
- Dorénavant, vous pouvez indiquer votre adresse email, ainsi si des erreurs surviennent lors de la génération, j'en suis informé et je vous tiendrai alors au courant des éventuelles corrections apportées.
27 octobre 2012 - Possibilité de créer une librairie nommée différemment à partir du même WSDL
- Correction d'un bug lors de la génération de plusieurs librairies avec le même WSDL mais avec un nom de librairie différente. Le dossier contenant les sources était unique ce qui fait que la visualisation des sources étaient faussées.
23 octobre 2012 - Parcours de la librairie avec Dynatree
- Dorénavant, vous pouvez parcourir la librairie générée afin de visualiser les fichiers générés, cliquez simplement sur l'onglet "Parcourir la Librairie". Voir un exemple de génération : QBWebConnectorSvc. L'arborescence de parcours est générée grâce à l'utilisation de Dynatree.
23 octobre 2012 - Affichage des erreurs du WSDL et gestion des balises d'import de schémas
- Ajout de la gestion des erreurs afin d'en informer l'utilisateur. Voir un exemple sur cette génération : OrderService
- Correction d'un bug lors de la soumission d'un WSDL à partir d'une URI, les balises d'import de schéma n'était pas correctement prises en compte
22 octobre 2012 - Amélioration du site et du projet
- Mise à jour des intitulés des champs des formulaires ainsi que des valeurs d'exemple
- Améliorations pour éviter les alertes PHP et la détection des localisations des schémas