Dois-je utiliser une terminologie ou un jargon pour nommer les fonctions PHP ?

La terminologie et le jargon ont leurs avantages et leurs inconvénients lorsqu'il s'agit de nommer des fonctions PHP. La terminologie apporte professionnalisme et précision, tandis que le jargon est facile à comprendre et à retenir. Dans la pratique, l’utilisation de la terminologie est importante pour le professionnalisme, mais le jargon est plus facile à comprendre pour les utilisateurs non experts. Les meilleures pratiques incluent le maintien de la cohérence des noms, une intention claire et la prise en compte du niveau d'expertise de votre public.

Nom des fonctions PHP : terminologie ou jargon ?

L'utilisation de terminologie ou de jargon pour nommer des fonctions PHP a toujours été une question controversée. Certains développeurs estiment que l'utilisation de la terminologie est plus professionnelle et précise, tandis que d'autres estiment que l'utilisation du jargon est plus facile à comprendre et à mémoriser.

Avantages de l'utilisation de la terminologie :

• Professionnalisme : L'utilisation de la terminologie peut donner à votre code un aspect plus professionnel et formel.
• Précision : La terminologie fournit une description claire et concise de ce que fait une fonction.
• Évitez toute ambiguïté : En utilisant la terminologie, vous réduisez le risque que le nom de votre fonction soit mal compris.

Avantages de l'utilisation du jargon :

• Élégance : Le jargon est plus facile à comprendre, en particulier pour les utilisateurs non techniques.
• Mémoire : Le jargon courant est plus facile à retenir, surtout lorsque l'on discute de code avec des collègues ou des membres de la communauté.
• Fun : Utiliser un peu de jargon peut ajouter du plaisir à votre code et le rendre plus attrayant.

Exemple pratique :

Considérons la fonction suivante, utilisée pour obtenir des données utilisateur de la base de données :

Utilisation de la terminologie :

function getUserDataByUId($userId) { ... }

Utilisation du jargon :

function getUserById($id) { ... }

Dans ce cas, "UId" est le terme standard en SQL pour l'ID utilisateur. Cependant, « id » est un jargon plus courant et plus facile à comprendre pour les utilisateurs non techniques.

Meilleures pratiques :

En fin de compte, l'utilisation de la terminologie ou du jargon dépend de votre situation spécifique. Cependant, voici quelques bonnes pratiques à considérer :

• Soyez cohérent dans votre dénomination. Si vous choisissez d’utiliser des termes, utilisez-les toujours.
• Expliquez clairement vos intentions. Assurez-vous que les noms des fonctions décrivent clairement ce qu'elles font, quelle que soit la langue que vous utilisez.
• Pensez à votre public. Si vous travaillez avec des utilisateurs non experts, l'utilisation d'un jargon simple peut être plus appropriée.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!