Zend FR

gostbuster · 25-03-2009 16:18:35

Bonjour à tous,

Au risque de passer pour un bel abruti, je suis toujours en galère de documentation.

Par exemple, là, je voudrais instancier un Zend_Dojo_Form_Element_TextBox, seulement je voudrais lui attribuer des paramètres de configurations.

J'ai donc consulté la doc et l'api et je ne trouve pas.

J'ai bien lu dans la doc que par exemple pour construire l'objet cité ci-dessus :

Code:

$form->addElement(
    'TextBox',
    'foo',
    array(
        'value'      => 'some text',
        'label'      => 'TextBox',
        'trim'       => true,
        'propercase' => true,
    )
);

Jusque là, pas de problème.

Maintenant je veux activer d'autres options, par exemple j'ai essayé :

Code:

'uppercase' => true

et en effet cela fonctionne SAUF que je l'ai mis au pif.

Ainsi j'aurais aimé savoir comment faire pour connaitre a chaque fois les possibilité des options des méthodes et des constructeurs......

Je ne suis pas un expert, mais par exemple en JAVA je n'ai jamais eu de problème avec la javadoc. sous eclipse, il montrait toutes les possibilités offertes par les constructeurs....

Avec zend, je galère sniffffff :'(

Julien · 25-03-2009 17:53:38

C'est vrai que des fois, la doc en ligne est soit pas à jour, soit incomplète, soit fausse (c'est plus rare).

Pour moi la meilleure doc d'un produit open-source est sa source, et ses tests. Un ctl+click et c'est bon ;-)

Vincent · 26-03-2009 13:11:27

Salut Jeremy,

Tu as l'IDE Zend Studio For Eclipse (payant) qui te propose une aide à partir de la doc' avec différentes options possibles. Mais bon, comme toi, en tant que débutant je galère un peu parfois... Je pense que les ressources mises à disposition (bien que colossales !) pourraient encore être améliorées pour faciliter la prise en main du produit.

Dernière modification par miboo (26-03-2009 13:12:40)

gostbuster · 26-03-2009 13:34:05

Hey salut !

Je suis tout à fait d'accord avec toi. Malheureusement, ici il n'y a pas les moyens d'acheter un produit Zend, donc obligé d'utiliser un ide Alternatif GRATUIT, et je pense aussi que la doc manque cruellement d'explication.

Julien, tu as raison de dire que la source est un bon outil pour se documenter, mais je pense cependant qu'une bonne doc à la manière de javadoc serait un excellent moyen de développer rapidement.

Par exemple, sur cet extrait issu de la javadoc(http://java.sun.com/j2se/1.4.2/docs/api … rderLayout(int,%20int)) :

Code:

BorderLayout

public BorderLayout(int hgap,
                    int vgap)

    Constructs a border layout with the specified gaps between components. The horizontal gap is specified by hgap and the vertical gap is specified by vgap.

Parameters:
    hgap - the horizontal gap.
    vgap - the vertical gap.

Les paramètres sont bien expliqués, et on voit aussi toutes les possibilités offertes par le constructeur (cf la page fourni en lien).

Avec zend, c'est vachement plus compliqué,

Vincent · 26-03-2009 13:40:26

Tu devrais regarder ces deux sujets :

http://www.z-f.fr/forum/viewtopic.php?id=1994

http://www.z-f.fr/forum/viewtopic.php?id=1978

gostbuster · 26-03-2009 13:43:04

Je vais jeter un coup d'oeil merci, !

keilnoth · 26-03-2009 19:15:09

Il me semble qu'il y a une documentation de l'API en @phpdoc qui est certes très brutale mais qui a le mérite d'exister. Par contre le site framework.zend.com est down en ce moment donc impossible de poster l'URL.

EDIT : valà, c'est reviendu : http://framework.zend.com/apidoc/core/

Dernière modification par keilnoth (26-03-2009 19:39:00)

gostbuster · 27-03-2009 14:38:26

Salut,

Au début je pensais que tu parlais d'une doc couplée à l'autocomplétion (description des methodes disponibles etc...) mais en fait tu parles bien de l'API doc, j'utilise aussi cette doc pour essayer de trouver des infos, mais avouons tout de même que c'est pas très détaillé. Exemple :

Zend_Dojo_Form (extrait):

Code:

  Constructor __construct (line 212)

Constructor

$spec may be:

    * string: name of element
    * array: options with which to configure element
    * Zend_Config: Zend_Config with options for configuring element

    * throws: Zend_Form_Exception if no element name after initialization
    * access: public

void __construct (string|array|Zend_Config $spec, [ $options = null])

    * string|array|Zend_Config $spec
    * $options

Il manque bel est bien la description de toutes les options possibles non ?

keilnoth · 29-03-2009 03:31:12

C'est fort possible. Je n'utilise absolument pas ces documentations. Pour moi la meilleure doc est le code. Et j'utilise des sites de références pour m'inspirer.

Zend FR

#1 25-03-2009 16:18:35

Utilisation de l'api et de la doc,décidement j'ai du mal

Code:

Code:

#2 25-03-2009 17:53:38

Re: Utilisation de l'api et de la doc,décidement j'ai du mal

#3 26-03-2009 13:11:27

Re: Utilisation de l'api et de la doc,décidement j'ai du mal

#4 26-03-2009 13:34:05

Re: Utilisation de l'api et de la doc,décidement j'ai du mal

Code:

#5 26-03-2009 13:40:26

Re: Utilisation de l'api et de la doc,décidement j'ai du mal

#6 26-03-2009 13:43:04

Re: Utilisation de l'api et de la doc,décidement j'ai du mal

#7 26-03-2009 19:15:09

Re: Utilisation de l'api et de la doc,décidement j'ai du mal

#8 27-03-2009 14:38:26

Re: Utilisation de l'api et de la doc,décidement j'ai du mal

Code:

#9 29-03-2009 03:31:12

Re: Utilisation de l'api et de la doc,décidement j'ai du mal

Pied de page des forums