|
Publicité ' | ||||||||||||||||||||||||
|
|
#1 |
|
Membre régulier
![]() Inscription : avril 2005 Messages : 360 ![]() |
Bonjour,
Qu'est ce que cela veux dire un "code propre "selon-vous ?
|
|
|
00
|
|
|
#2 |
![]() ![]() |
Un code propre, ça veut dire deux choses :
1°) un code propre à voir, c'est vrai, bien indenté, avec une cohérence dans les noms de variables et de fonctions, etc... 2°) mais ça veut aussi un dire un code sans erreurs conceptuelles, sans erreurs grossières, sans désoptimisations (exemple : "$mavar"), sans lourdeurs... etc... en bref, un code dont la sémantique est cohérente... si on utilise des guillemets simples et la concaténation pour les variables, le faire tout le temps, et n'utiliser les guillemets double que quand c'est nécessaire ("\r\n" par exemple) si on utilise sprintf, l'utiliser tout temps... etc...
__________________
Rédacteur "éclectique" (XML, IRC, Web...) Les Règles du Forum - Mon Site Web sur DVP.com (Développement Web, PHP, (X)HTML/CSS, SQL, XML, IRC) je ne répondrai à aucune question technique via MP, MSN ou Skype : les Forums sont là pour ça !!! Merci de me demander avant de m'ajouter à vos contacts sinon je bloque ! pensez à la balise [code] (bouton #) et au tag (en bas)
|
|
|
10
|
|
|
#3 |
|
Expert Confirmé
![]() Maxime PasquierExpert PHP Inscription : novembre 2004 Messages : 2 123 ![]() |
ca dépend, si c'est de l'HTML ca peut dire valide W3C.
si c'est du PHP, voir le post de Swoög, auquel j'ajoute : ca peut aussi dire utiliser les balise code ou bbcode pour que les membres du forum se casse pas les yeux dessus, et pas forcement poster tout le code, mais les parties judicieuses pour analyser le probleme rapidement (avec les numéro de lignes si possible etc.) le plus souvent moi je dis : balise code et code pas valide ...
__________________
Pour une bien meilleur lisibilité, utilisez la balise [code], c'est le [#] dans votre éditeur. Mon espace Développez : mes Créations. Rencontre & Carte des Membres de Developpez.com, version 3.0 |
|
|
10
|
|
|
#4 |
|
Expert Confirmé
![]() ![]() Développeur informatique Inscription : février 2005 Messages : 3 030 ![]() |
Je vais rejoindre les dires de Swoög concernant la cohérence et être fidèle à ça manière de codé du début à la fin.
Quand on prend un projet entier d'une autre personne il y a la phase ou il faut comprendre ça manière de voir les choses. Si au bout 1/2 heure nous nous aperçevont qu'il a son propre protocole d'écriture de code ça devient plus facile pour la suite même si ce qu'il a fait n'est pas forcément bien ficelé mais dans l'essentiel c'est d'arriver à comprendre vite. Pour mon projet perso j'ai établie un protocole unique sur le nommage de mes variable. Ex $arrObjUtilisateur; => Tableau d'Objet Utilisateur $objUTilisateur; Obj Utilisateur $arrXxxx; => Tableau de .... $i , $j, $k, $l , ... Variable d'incrémentation ou décrémentation. ... Dans mon projet c'est ainsi tous le temps. Apres ça reste discutable sur les nom ou la maniere mais tant que je reste fidèle. Le but est de rester compréhensible et se dire tous le temps: "Et si autre dev voit mon code est-ce qu'il va comprendre? et si je reviens 6 mois plus tard est-ce que je vais comprendre". Code propre c'est aussi un code organisé, structuré. Pas des même requêtes qui se trouve dans différent fichiers ou il faut courir après parce que la structure de la base de données a changé. Certe c'est pas tous le jours qu'ont change la structure d'une table mais quand ça arrive t'es degue. |
|
|
10
|
|
|
#5 |
|
Membre émérite
![]() |
Je permet d'ajouter èa ce post très bien quelque petit détails qui peuvent etre bien, les commentaires (on en mets pas suffisament ou encore pas aux bons endroits)
Je crois qu'un entete dans chaque page sur l'utilité et la finalité du script est intéressant a avoir, comme ca dans la réutilisation de code on peut savoir rapidement de quoi il en est La description des fonction que l'on créé ainsi que la description des paramètres se vaut un outils important dans la structure et la propreté Et finalement si une journée on programme et sommes très "dans notre bulle" on peut créere des algorithme qui peuvent etre difficile a comprendre plutard s'il comporte beaucoup de ligne de code...un petit commentaire sur les parties moins évidante est grandement apprécié Pour ma part, je me garde un fichier de variable session pour identifié à quelle page on les initialisent, les détruient, leur attribuent de nouvelle valeur...C'est plus facile de les retrouver dans une application comportant plusieurs plusieurs page
__________________
La perfection n'est pas un but, l'amélioration constante devrait l'être! La position des Développeurs de developpez avec les explications |
|
|
10
|
|
|
#6 |
|
Expert Confirmé
![]() Maxime PasquierExpert PHP Inscription : novembre 2004 Messages : 2 123 ![]() |
genre ca : http://www.developpez.net/forums/sho...28#post1112428
ca donne pas envie de le lire, apres tu notera qu'il y a quand meme de l'indentation etc.
__________________
Pour une bien meilleur lisibilité, utilisez la balise [code], c'est le [#] dans votre éditeur. Mon espace Développez : mes Créations. Rencontre & Carte des Membres de Developpez.com, version 3.0 |
|
|
00
|
|
|
#7 |
|
Membre émérite
![]() |
en tant que non gourou de php, j'aurai envie de rajouter qu'un code propre c'est aussi un code suffisamment clair et commenté pour qu'une autre personne puisse plonger dans le code sans se noyer.
|
|
|
00
|
|
|
#8 | |
![]() ![]() Jean-Pierre Inscription : août 2005 Messages : 333 ![]() |
Citation:
Si l'on parle de (X)HTML (par exemple) et W3C; on fait plutôt référence à de la sémantique web (rigueur dans la structuration grammaticale des pages, séparations du contenu et du contenant)... ...Et si on parle du W3C en général, il s'agit plutôt de normes (recommandations ou standards) de conceptions uniformisées. A mon avis, même si on peut jouer sur les mots, je pense que ce n'est pas une bonne idée d'assimiler W3C et le fait de "coder proprement". Ce que j'appelerais du code propre (et je suis assez stricte avec moi-même dans le domaine ) :
Evidemment, il est difficile de respecter toutes ces directives, et pour ainsi dire, j'ai rarement vu des scripts ou applications PHP respectant parfaitement ces (mes) conventions, mais enfin, les perfectionnistes comprendront |
|
|
|
00
|
|
|
#9 |
|
Expert Confirmé
![]() ![]() Développeur informatique Inscription : février 2005 Messages : 3 030 ![]() |
Autre chose. Si vous connaissez un peut l'objet et que vous travaillez en équipe ne faite pas d'objet parce qu'il y a pas pire qu'une personne qui utilise l'objet sans aucune logique c'est pire que tous.
|
|
|
00
|
|
|
#10 |
|
Membre habitué
![]() Inscription : avril 2005 Messages : 271 ![]() |
Un code propre c'est :
1) un code sans superflu Exemple pour le html : j'ai l'habitude de travailler avec des graphiste intégrateur qui conçoivent les pages web avec des tableaux imbriqué dans des tableaux eux même dans des tableaux.. Qui répètent dans chaque page les mêmes morceaux de code. Le code est horrible à dynamiser, imaintenable, totalement inévolutif => vive xhtml et css2 !! 2) Bien commenté Pour ma part (dans mes bon jour je met presque 25% de code dans mes script) 3) Respecter ses convention Convention de nomage, de répartition du code dans les fichiers etc... L'utilisation de fichier de configuration est fortement conseillé.. +) Rédiger une note sur la programmation pour ses successeurs Bref faire tou ce que je ne fait pas ^^ Bon code @ tous
__________________
Orthographe => Message Privé constructif svp |
|
|
00
|
|
|
#11 | |
![]() ![]() Jean-Pierre Inscription : août 2005 Messages : 333 ![]() |
Citation:
En plus d'utiliser une classe par bloc ! D'un extrème à l'autre
|
|
|
|
00
|
|
|
#12 | |
|
Membre régulier
![]() Inscription : avril 2005 Messages : 360 ![]() |
Merci pour vos réponses ça m'a fait vraiment plaisir de recevoir pleines de reponses car ça ne m'arrive pas souvent.
D'autre part, berceker united a dit Citation:
J'ai bien compris ce que veut dire un code libre, mais est ce que tout le monde l utilise?
|
|
|
|
00
|
|
|
#13 |
|
Membre émérite
![]() |
Ben je crois qu'il voulais dire par utiliser l'objet en équipe n'étant pas une bonne idée si ca modélisation des classes n'a pas bien été fait à la base
Travailler en équipe sur un projet codé en objet peut se faire a condition d'avoir bien fait le diagramme de classe avec la notion UML par exemple... ainsi une personne peut travailler sur une classe et une autre, sur une autre classe ainsi de suite sans se piller sur les pieds Les gens qui code objet sans trop savoir où ils vont, vont avoir tendence a créer des objet superflux sans respecter les patron de conception Orienté-Objet qui sont là, la plupart du temps, pour simplifier et apporter une résolution logique face a une situation...patron parlant ici de Singleton, Bridge,Visiteur, Expert...etc yen a plein
__________________
La perfection n'est pas un but, l'amélioration constante devrait l'être! La position des Développeurs de developpez avec les explications |
|
|
00
|
|
|
#14 | |
![]() ![]() Jean-Pierre Inscription : août 2005 Messages : 333 ![]() |
Citation:
Il n'est pas nécessaire d'avoir recours à UML (et tous ses différents diagrammes) ni même aux design patterns lorsqu'on travaille sur des projets PHP amateurs ou "semi-pro", d'une complexité relative. Avoir recours à ces méthodes d'analyse / conception devient indispensable lorsqu'on doit résoudre des problèmes complexes, avec un délai et de l'argent en jeu... Pour exemple, la plus part des projets OpenSource PHP que je connais, hebergés typiquement par SourceForge (ou non), mettent tout leur code source à disposition sur CVS, à partir de là, contribue qui veut (qui pourra), sans organisation autour de diagrammes UML (doc. et discussion faisant foi). ...Surtout que les versions antérieures à PHP 5 ne permettent pas (ou difficilement) l'utilisation des diagrammes de conception UML. Ce qu'il voulait dire plus haut est très simple, ne pas faire de l'orienté objet pour faire joli, et éviter de faire de l'orienté objet en équipe tant qu'on en a pas acquis les fondamentaux... Bonne journée ! |
|
|
|
00
|
|
|
#15 |
|
Nouveau Membre du Club
![]() |
1 - toujours commenter son code
2 - respecter les conventions W3C 3 - ca c'est mon avis mais : coder en XHTML strict 4 - utiliser la méthode MVC et ne pas programmer "en spaghetti" 5 - bien indenter son code. je pense que c'est tout.... |
|
|
00
|
|
|
#16 |
|
Expert Confirmé
![]() ![]() Développeur informatique Inscription : février 2005 Messages : 3 030 ![]() |
Concernant la conception objet ozzmax résume un peut mes pensé mais je parle par expérience malheureuse que j'ai vécus ou il y avait un developpeur qui connaissait pas réellement la notion objet mais utilisais plutot les facilités de syntaxe. En gros un objet était un sac à fonction avec des variables (attribut) visible depuis chaque "fonction" point barre! ça n'allait pas plus loin. Je du passer derriere lui. J'ai pété un plomb, arrêter une semaine certifié par le medecin
. La classe faisait >3000 lignes.Donc si vous voulez vous lancer dans l'objet faite le chez vous mais ne le faite pas subire au autre parce que le resultat peut être pire qu'en procédurale. |
|
|
00
|
|
|
#17 |
|
Membre régulier
![]() Inscription : avril 2005 Messages : 360 ![]() |
Je vois que travailler en faisant un code propre est difficile et travailler avec l objet est pire si j ai bien compris ce que vous venez de dire.
J ai etudié l objet et la conception avec l objet mais je l ai jamais utilisé dans un projet meme si j en veux vraiment. Il faut juste les moyens pour en faire un Merci pour vous tous. |
|
|
00
|
|
|
#18 | |
![]() ![]() Jean-Pierre Inscription : août 2005 Messages : 333 ![]() |
Citation:
Cela dit, je serais bien curieux de savoir à quel genre de développeur tu as eu à faire C'est une aberration... |
|
|
|
00
|
|
|
#19 | |||
|
Expert Confirmé
![]() ![]() Développeur informatique Inscription : février 2005 Messages : 3 030 ![]() |
Citation:
Donc pour pas que ça arrive à d'autre ne faite pas d'objet en équipe si vous n'avez pas de notions. Autre chose : LES COMMENTAIRES COHERANT. C'est pas tous de placer un commentaire mais faut il qu'elle soit compréhensible et utile. Des fois je vois ça Code :
__________________
Mon avatar ? Ce n'est rien, c'est juste la tête que je fais lorsque je vois un code complètement frappa dingue !... |
|||
|
|
00
|
|
|
#20 | |||
|
Membre émérite
![]() |
Citation:
Les commentaires dans le code doivent etre là pour nous renseigner sur quelque chose de compliquer pas pour expliquer la ligne qui suit... Alors comme ton avis, un sur-commentairage ne fait qu'alourdir le code dponc le rendant difficile a comprendre à simple lecture
__________________
La perfection n'est pas un but, l'amélioration constante devrait l'être! La position des Développeurs de developpez avec les explications |
|||
|
|
00
|
Copyright © 2000-2013 - www.developpez.com