Line 11:
Line 11:
{{TemplateDocDevEn}}
{{TemplateDocDevEn}}
−
These are some rules on language, syntax and norm we use in the Dolibarr project:
+
Nachfolgend einige Regeln zu Sprache, Syntax und Norm, die wir im Dolibarr-Projekt verwenden:
−
=Versions=
+
=Versionen=
−
*Dolibarr must work on:
+
*Dollibar muss funktionieren mit:
−
#All OS (Windows, Linux, MACOS...)
+
#Allen Betriebssystemen (Windows, Linux, MACOS...)
−
#PHP {{PHPMinVersion}} (Must work with no need of complementary PHP module, except module to PHP module to access database).
+
#PHP {{PHPMinVersion}} (Muss ohne komplementäres PHP-Modul funktionieren, außer Modul zu PHP-Modul, um auf die Datenbank zuzugreifen).
#MySQL {{MySqlMinVersion}}
#MySQL {{MySqlMinVersion}}
−
=Copyright Norms=
+
=Urheberrechtsnormen=
−
*All PHP files must start with a header that looks like
+
*Alle PHP-Dateien müssen mit einem Header beginnen, der folgendermaßen aussieht
<source lang="php">
<source lang="php">
Line 33:
Line 33:
...
...
</source>
</source>
−
When you edit an existing file of project, you must add a Copyright line under others.
+
Wenn Sie eine vorhandene Projektdatei bearbeiten, müsssen Sie eine neue Copyright-Zeile im Header hinzufügen.
−
=PHP Norms=
+
=PHP-Normen=
==PHP==
==PHP==
−
*Dolibarr is written with PHP and supports all versions of PHP higher than {{PHPMinVersion}}. All files must end with extension .php
+
*Dolibarr is in PHP geschrieben und unterstützt alle Versionen von PHP, welche höher sind, als {{PHPMinVersion}}. Alle Dateien müssen mit der Erweiterung .php enden.
−
*Usage of PHP superglobals variables must use the dedicated operators $_COOKIES, $_SERVER, $_ENV but use the Dolibarr function GETPOST() to get the contents of $_GET or $_POST..
+
*Die Verwendung von PHP superglobalen Variablen muss über die festgelegten Operatoren $_COOKIES, $_SERVER, $_ENV erfolgen. Allerdings muss die Dolibarr-Funktion GETPOST () verwendet werden, um den Inhalt von $_GET oder $_POST abzurufen.
−
*Other operators ($HTTP_SERVER_GET, ...) are now deprecated in PHP, so they must not be used. Code must work if option '''register_long_arrays''' is set to off. Moreover, the code must work when PHP option '''register_globals''' is off (recommended by PHP). It must also work if the option '''register_globals''' is on (by default on a lot of installations).
+
*Andere Operatoren wie ($HTTP_SERVER_GET, ...) sind veraltet und dürfen daher nicht verwendet werden. Der Code muss funktionieren, wenn die Option '''register_long_arrays''' deaktiviert ist. Desweiteren muss der Code funktionieren, wenn die PHP-Option '''register_globals''' deaktiviert ist (wird von PHP empfohlen). Allerdings muss er auch funktionieren wenn die Option '''register_globals''' aktiviert ist (standardmäßig bei vielen Installationen).
−
*Do not use '''<s>PHP_SELF</s>'''. Use instead '''$_SERVER["PHP_SELF"]'''. Also, Dolibarr framework sanitizes content of $_SERVER["PHP_SELF"] variable (into main.inc.php file, before any business code).
+
*Verwenden Sie nicht '''<s>PHP_SELF</s>'''. Stattdessen verwenden Sie '''$_SERVER["PHP_SELF"]'''. Beachten Sie weiterhin, dass das Dolibarr-Framework den Inhalt der Variablen $_SERVER["PHP_SELF"] bereinigt. (Siehe Datei '''main.inc.php''').
−
*When several variables must be initialized with the same value, you must use individual declarations (separated by ;)
+
*Wenn mehrere Variablen mit demselben Wert initialisiert werden müssen, müssen Sie einzelne Deklarationen verwenden (getrennt durch ''';''' ).
<source lang="php">
<source lang="php">
Line 53:
Line 53:
$var3=1;
$var3=1;
</source>
</source>
−
instead of
+
Anstelle von
<source lang="php">
<source lang="php">
$var1=$var2=$var3=1;
$var1=$var2=$var3=1;
</source>
</source>
−
which is slower.
+
, weil es langsamer ist.
<br />
<br />
Line 63:
Line 63:
====Strings====
====Strings====
−
*Strings must be delimited by a single or double quote and a variable within the string must be outside of the quote.
+
*Zeichenfolgen müssen durch einfache oder doppelte Anführungszeichen begrenzt sein. Eine Variable innerhalb der Zeichenfolge muss außerhalb der Anführungszeichen liegen.
<source lang="php">
<source lang="php">
Line 71:
Line 71:
<br />
<br />
−
====Comments====
+
====Kommentare====
−
*Comments must use the C syntax, ie a double slash for a comment on one line and a slash-star to open a bloc for several lines
+
*Kommentare müssen die C-Syntax verwenden, das heißt einen doppelten Schrägstrich für einen Kommentar in einer Zeile oder einen Schrägstrich mit Stern, um einen Block für mehrere Zeilen zu öffnen
<source lang="php">
<source lang="php">