Benutzer-Werkzeuge

Webseiten-Werkzeuge


dev:all:psr:psr-1

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Nächste Überarbeitung
Vorhergehende Überarbeitung
dev:all:psr-1de [12.08.2014 10:23] – angelegt Manuela v.d.Deckendev:all:psr:psr-1 [31.08.2023 01:50] (aktuell) Manuela v.d.Decken
Zeile 5: Zeile 5:
 ===== Übersicht ===== ===== Übersicht =====
  
-  * Dateien MÜSSEN ausschließlich **''<?php''**  (:!: //Anpassung für WB:// <del> und **''<?=''**</del>Tags verwenden.+  * Dateien MÜSSEN ausschließlich **''<?php''** und **''<?=''** Tags verwenden.
   * Dateien MÜSSEN ausschließlich UTF-8 ohne BOM codiert werden.   * Dateien MÜSSEN ausschließlich UTF-8 ohne BOM codiert werden.
-  * Dateien SOLLTEN entweder Symbole (Klassen, Funktionen, Konstanten etc.) deklarieren **ODER** direkt ausführbaren Code (//side-effects//) enthalten. Aber sie SOLLTEN NICHT beides gleichzeitig tun.  +  * Dateien SOLLTEN entweder Symbole (Klassen, Funktionen, Konstanten etc.) deklarieren **ODER** direkt ausführbaren Code (//**side-effects**//) enthalten. Aber sie SOLLTEN NICHT beides gleichzeitig tun.  
-  * Namensräume und Klassen MÜSSEN [[dev:all:psr-0de|PSR-0]] folgen.+  * Namespaces und Klassen MÜSSEN [[dev:all:psr:psr-0|PSR-0]] folgen.
   * Klassennamen MÜSSEN in //**StudlyCaps**// deklariert werden.   * Klassennamen MÜSSEN in //**StudlyCaps**// deklariert werden.
   * Klassenkonstanten MÜSSEN in Großbuchstaben mit _ zwischen einzelnen Worten deklariert werden.   * Klassenkonstanten MÜSSEN in Großbuchstaben mit _ zwischen einzelnen Worten deklariert werden.
Zeile 14: Zeile 14:
  
 ===== Dateien ===== ===== Dateien =====
-==== PHP Tags ==== 
-PHP-Code MUSS ausschließlich den langen **''<?php  ?>''** Tag  (:!: //Anpassung für WB:// <del> oder den kurzen Echo **''<?= ?>''** Tag</del>) benutzen. Es DÜRFEN NICHT andere Tag-Variationen benutzt werden. 
  
 ==== Zeichensatz-Codierung ==== ==== Zeichensatz-Codierung ====
 PHP-Code MUSS ausschließlich UTF-8 ohne BOM verwenden. PHP-Code MUSS ausschließlich UTF-8 ohne BOM verwenden.
 +
 +==== Side Effects ====
 +Eine Datei SOLLTE entweder neue Symbole (Klassen, Funktionen, Konstanten, etc.) deklarieren und keinerlei 'side effects' enthalten, oder aber sie SOLLTE ausführbare Logik mit 'side effects' enthalten, aber sie SOLLTE NICHT beides tun.
 +
 +Die Phrase 'side effects' bedeutet 'ausführbare Logik', die nicht in Klassen oder Funktionen gekapselt ist und in der Regel beim 'Includen' der Datei sofort unkontrolliert ausgeführt wird.
 +'side effects' bezeichnen unter anderem: erzeugen von Ausgaben, benutzen von include() oder require(), verbinden zu externen Services, verändern von INI-Settings, auslösen von Fehlern und Ausnahmen, verändern von globalen oder statischen Variablen, lesen oder schreiben in Dateien oder Datenbanken, und vieles mehr.\\
 +:!: //Anpassung für WB:// Dateien mit 'side effects' MÜSSEN speziell abgesichert werden, damit sie nicht durch z.B. DeepLinks aufgerufen werden und Schaden anrichten können.
 +
 +Das Nachfolgende ist ein Beispiel einer Datei, die sowohl Deklarationen als auch 'side effects' enthält. Ein Beispiel, das zeigt, was man NICHT machen SOLLTE:
 +<code php>
 +// side effect: ändert Ini-Settings
 +ini_set('errot_reporting', E_ALL);
 +
 +// side effect: lädt eine Datei
 +include('file.php');
 +
 +// side effect: erzeugt eine Ausgabe
 +echo '<html>'.PHP_EOL;
 +
 +// Deklaration:
 +function foo()
 +{
 +    // Funktionskörper
 +}
 +</code>
 +Das zweite Beispiel ist eine Datei, die nur Deklarationen ohne alle 'side effects' enthält. Ein Beispiel, das immer zu bevorzugen ist.
 +<code php>
 +// Deklaration
 +function foo()
 +{
 +    // Funktionskörper
 +}
 +
 +// bedingte Deklaration ist *kein* side effect!
 +if (! function_exists('bar')) {
 +    function bar()
 +    {
 +        // Funktionskörper
 +    }
 +}
 +</code>
 +
 +===== Namespaces und Klassennamen =====
 +
 +Die Benennung von Namespaces und Klassen MUSS nach [[dev:all:psr:psr-0|PSR-0]] erfolgen.
 +
 +Das bedeutet, dass jede Klasse in einer eigenen Datei ist und einem Namespace zugewiesen, der wenigstens den Vendor Name als Top-Level hat.
 +
 +Klassennamen MÜSSEN in **StudlyCaps** deklariert werden.
 +
 +:!: //Anpassung für WB:// Interfaces und abstrakte Klassen müssen im Namen zusätzlich mit dem Suffix **Interface** oder **Abstract** ergänzt werden.\\
 +
 +
 +Code der für PHP-5.3 und höher geschrieben wird MUSS formale Namespace nutzen.
 +
 +Beispiel:
 +<code php>
 +<?php
 +// php 5.3 und später:
 +namespace Vendor\Model;
 +
 +class Foo
 +{
 +}
 +</code>
 +<code php>
 +<?php
 +// php 5.3 und später:
 +namespace Vendor\Model;
 +
 +class FooInterface
 +{
 +}
 +</code>
 +
 +
 +===== Klassen- Konstanten, Eigenschaften und Methoden =====
 +Das Term 'Klasse' bezieht sich auf alle Klassen, Interfaces und Traits.
 +
 +==== Konstanten ====
 +Klassenkonstanten MÜSSEN vollständig in Großbuchstaben deklariert werden. Der Unterstrich trennt einzelne Worte.
 +<code php>
 +<?php
 +namespace Vendor\Model;
 +
 +class Foo
 +{
 +    const VERSION = '1.0';
 +    const DATE_APPROVED = '2014-08-12';
 +}
 +</code>
 +
 +==== Eigenschaften ====
 +Dieser Leitfaden vermeidet absichtlich jede Empfehlung in Bezug auf die Verwendung von $**StudlyCaps**, $**camelCase** oder $**under_score** Eigenschaftennamen.\\
 +Welche Namenskonvention auch benutzt wird, sie SOLLTE konsistent in einem vertretbaren Rahmen angewendet werden.
 +
 +:!: //Anpassung an WB:// Es MUSS durchgehend überall das **StudlyCaps** Format benutzt werden, wobei jedem Bezeichner ein Kleinbuchstabe vorangestellt wird, der den Datentyp der Eigenschaft beschreibt. Derzeit definiert sind folgende Zuweisungen:
 +>>'**s**' => String, '**i**' => Integer/Ganzzahl, '**f**' => Fließkommazahl, '**b**' => boolean, '**a**' => Array, '**o**' => Objekt, '**c**' => Callback, '**m**' => mixed, '**r**' => Resource
 +
 +<code php>
 +$sItemName = 'Something';
 +$iUserId   = 2;
 +$fPrice    = 45.25;
 +</code>
 +
 +==== Methoden ====
 +Methodennamen MÜSSEN in **camelCase()** deklariert werden.
 +
 +
 + --- //[[manuela@isteam.de|Manuela v.d.Decken]] 12.08.2014 20:35//
  
  
  
dev/all/psr/psr-1.1407839018.txt.gz · Zuletzt geändert: 03.06.2015 15:54 (Externe Bearbeitung)