Avis sur le PSR-1: norme de codage de base

Après avoir lu PSR-1, certaines réflexions sont venues que j'aimerais partager avec la communauté de programmation afin d'obtenir des histoires sur votre expérience.






PSR-1: Basic Coding Standard - Une norme qui recommande des règles pour le formatage et le codage. Le style  est la façon d'écrire du code et l'  écriture  est ce qu'il faut écrire.





Le sous-texte PSR-1 indique que vous ne devez pas utiliser de mélange de code et de conclusions logiques du code. Je le dis un peu pas clairement, mais alors vous comprendrez que PSR-1 ne recommande pas d'écrire une classe, de l'afficher à l'écran et d'initialiser les propriétés dans un seul fichier.





Tous les fichiers PHP doivent utiliser soit  <?php



ou  <?=



. Tout est évident et compréhensible ici, la première balise parle de la déclaration de la section de code php, et la seconde est un court enregistrement  <?php echo



, c'est-à-dire la sortie.





Les fichiers doivent également être encodés en UTF-8 sans BOM, ce qui est logique. Il y a eu certains cas dans un projet où il y avait plusieurs programmeurs. Donc, là, on a réussi à insérer un symbole de nomenclature et à cause de cela, les fichiers d'analyse sont tombés en panne.





Il indique également qu'il n'est pas recommandé d'utiliser plusieurs effets secondaires. Avec la traduction, je ne vais pas toujours bien ... Autrement dit, nous ne pouvons pas prendre et écrire dans le fichier:





<?php
// side effect: change ini settings
ini_set('error_reporting', E_ALL);

// side effect: loads a file
include "file.php";

// side effect: generates output
echo "<html>\n";

// declaration
function foo()
{
    // function body
}
      
      



Eh bien, ici, le moment est extrêmement controversé. Bien que la norme recommande l'utilisation d'un chargeur automatique selon ses normes PSR-0 et PSR-4. D'une part, oui, mais il peut y avoir une initialisation d'application à un seul point d'entrée. Bref, le moment est douteux. Dans le même Yii2, cette approche n'est pas suivie ... Je ne ferais pas attention à cette recommandation même.





(namespace). , , .  StudlyCaps



. PHP < 7.0, , .





,  DATE_APPROVED



. , – . .





. PSR-1 : $StudlyCaps



$camelCase



,  $under_score



. . , , , ,  $camelCase



. , , ... , .  camelCase



.





Avec la dénomination des méthodes dans le format,  camelCase()



 je suis entièrement d'accord et je le maintiens. Il est logique de nommer les classes avec une majuscule, les constantes avec une minuscule, les méthodes avec une minuscule. Et, en principe, vous pouvez distinguer l'un de l'autre simplement en écrivant.





Merci pour votre attention, j'espère que le matériel a été utile, bien qu'il s'agisse d'une déclaration de réflexion sur la lecture du PSR-1.








All Articles