Discussion :

[Aquaa]

Bonjour

comment trouvez vous la documentation sur www.php.net ?
Je la trouve inférieure à la moyenne et vous ?

[sabotage]

Personnellement je l'aime bien.
Les fonctions sont regroupées par thême, les exemples sont pragmatiques.
Certains articles sont un peu fouillis.

[Doksuri]

personnellement, je la trouve excellente :

• comme l'a dit sabotage, elles sont regroupees par themes

en plus :

• il y a l'utilisation type de la fonction

• il y a un petit resume pour la fonction

• il y a un exemple d'utilisation

• il y a un message d'avertissement si la fonction n'existe plus d'une version de php a l'autre (ou si elle pose probleme)

• il y a des avis

• il y a des suggestion de fonction qui ont un lien avec la fonction que l'on regarde
  ("voir aussi :
  tel fonction
  tel fonction...")

=> pratique si l'on ne connaissait pas une des autre fonctions suggere

• constamment mis a jour (cf les messages d'avertissements d'une version de php a l'autre)

voila, je crois que j'ai fais le tour.
pour moi c'est THE reference si l'on a le moindre probleme avec une fonction

[graphiks]

Bonjour

Je trouve aussi que c'est vraiment une très bonne documentation.
Plein de façon d'accéder aux infos, mais des façons assès simple, du coups on s'y perd pas.

D'autre part, quand l'exemple est pas suffisant pour comprendre, il existe beaucoup de commentaire de personne tiers qui comble le vide.

Une fonction par url est sympa avec ensuite la redirection selon la langue est super pratique, mais pas unique à PHP certe

Sky

[grunk]

Pour avoir du utiliser la doc JAVA et la msdn , je reste attaché à la doc php (peut être car c'est avec elle que j'ai commencé).

- La mise en page , ca n'a l'air de rien comme ça , mais ne pas se retrouver sur une simple page blanche sortie des années 90 ca aide énormément à la compréhension.
Exemple : http://java.sun.com/j2se/1.4.2/docs/...ollection.html

- Le moteur de recherche , juste parfait à mon gout

- Les commentaires , qui sont réellement une source d'information extraordinaire. 9/10 on règle un problème en les lisant.

Seul bémol , le nombre de fonction non documenté qui reste significatif.

[Thes32]

Je suis du même avis que grunk, je trouve la doc beaucoup plus ouverte (avec les commentaires, exemples, etc.) que celles d'autres plateformes (la doc java par exemple).

Le seul grand soucis reste sur les fonctions/notions mal ou non documentés.

[Aquaa]

voici un des exemples qui me dégoute

http://php.net/manual/fr/function.fflush.php

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
8
9
10
11
12
13
 Exemples
 
Exemple #1 Écriture d'un fichier en utilisant fflush()
<?php
$filename = 'bar.txt';
 
$file = fopen($filename, 'r+');
rewind($file);
fwrite($file, 'Foo');
fflush($file);
ftruncate($file, ftell($file));
fclose($file);
?>

dans l'exemple je suis supposé connaitre la fonction rewind et ftruncate pour le comprendre ce dernier.

[speedy_g]

Ben pour ces fonctions, il suffit de les taper dans la barre de recherche et on voit tout de suite ce qu'elle font.

Pour moi c'est même bien, car on voit le couplage des fonctions.

[BornBanane]

L'exemple à la mérite d'être concret. Ce n'est pas qu'une simple utilisation de la fonction avec divers paramètre possible mais un cas d'utilisation.
Rien que pour ces exemples, la doc PHP est vraiment agréable à utiliser.

[Aquaa]

L'exemple à la mérite d'être concret. Ce n'est pas qu'une simple utilisation de la fonction avec divers paramètre possible mais un cas d'utilisation.
Rien que pour ces exemples, la doc PHP est vraiment agréable à utiliser.

justement on pourrait mettre les deux options un simple et celui cité, c'est un peut le bazar de chercher ce que fait "rewind","ftruncate","ftell" juste pour comprendre le principe de "fflush", en plus si on va chercher "rewind" on se trouve avec d'autre fonction qu'on doit chercher d'avantage.
je trouve http://www.w3schools.com/php plus simple est efficace
(en ce qui me concerne).

[Doksuri]

attends, il ne faut pas generaliser...

t'es tombe sur une fonction ou, pour la comprendre, tu dois connnaitre d'autres fonctions..

c'est comme le BMX (pour un exemple Jeun'S)
tu te lances pas dans le BMX de but en blanc, avant t'as appris a faire du velo avec les roulettes, puis t'as retire les roulettes, puis tu t'es bien entraine pour enfin partir sur du BMX

bon, bah la t'es alle un peut trop vite, du coup tu dois apprendre d'autre fonctions en meme temps que celle que tu cherches.

mais c'est pas grave, plus t'en sais, mieux c'est !

[a028762]

le fait que certains sites recopient des extaits assez complets de php.net n'impacte pas la qualité (ou les défauts) de php.net.
C'est sans doute la mesure de personnes qui veulent se glorifier du boulot d'autres personnes ? Des liens auraient sans doute suffit ...

[Doksuri]

Des liens auraient sans doute suffit ...

oula malheureux....
si tu mets un lien, tu dis noir sur blanc a tes amis que ce n'est pas toi qui l'a fait...
si tu recopies, peut-etre que tes amis ne le remarqueront pas....

C'est sans doute la mesure de personnes qui veulent se glorifier du boulot d'autres personnes

=> je crois que t'as mis le doigt dessus

[metagoto]

La doc de php est excellente.

C'est mon avis mais aussi celui de beaucoup. Il est notoirement connu que la doc de php est très bien faite: simple et efficace, elle va à l'essentiel et sa présentation est tout aussi réussie.

Par contre il faut faire attention à ne pas prendre les commentaires de la doc au pied de la lettre. Ce sont juste des commentaires qui n'engagent que leurs auteurs.