LogoLogo
Homepage
  • Documentations for PrestaShop 1.4
  • English documentation 1.4
    • Getting Started
    • Updating PrestaShop
    • User Guide
      • Training
      • Customizing your shop
      • Browsing the front-office
      • Connecting to the PrestaShop back-office
      • Adding Products and Product Categories
      • A Look inside the Catalog
      • Managing Customers
      • Managing Orders
      • Managing Payment Methods
      • Managing Shipping
      • Understanding Statistics
      • Managing Modules
      • Managing Employees
      • Understanding the Preferences
      • Exploring PrestaShop's Tools
      • PrestaShop Support
    • System Administrator Guide
    • Developer Guide
      • Developer tutorials
        • Using the REST webservice
          • Chapter 1 - Creating Access to Back Office
          • Chapter 2 - Discovery - Testing access to the web service with the browser
          • Chapter 3 - First steps - Access the Web service and list client
            • 3.1 - Access the web service
            • 3.2 - Handling errors
            • 3.3 - List clients
          • Chapter 4 - Retrieve Data - Retrieving a Client
          • Chapter 5 - Modification - Update client
          • Chapter 6 - Creation - Remote Online Form
          • Chapter 7 - Removal - Remove customer accounts from the database
          • Chapter 8 - Advanced Use
          • Cheat-sheet - Concepts outlined in this tutorial
        • Understanding and using hooks
        • Synchronization via Hooks
        • Modules, Classes and Controller Override
        • Modules, Override, Web Service
        • Db class good practices for Prestashop 1.4
        • Carrier modules - functions, creation and configuration
        • Creating your own payment module
        • Accelerated Security Course - Episode 1 - Never Trust Foreign Data
        • Accelerated Security Course - Episode 2 - SQL Injections
        • Accelerated Security Course - Episode 3 - XSS
        • Accelerated Security Course - Episode 4 - CSRF
      • Fundamentals
      • Creating a PrestaShop module
      • Development standard
      • Public and overloadable methods
      • Web-service reference
      • How to use the forge to contribute to PrestaShop
      • Rocky's guides
        • PrestaShop 1.4.3 Development Guide
          • Architecture
          • Overriding Files
          • Creating Modules
          • Cookie Structure
          • Database Structure
        • PrestaShop 1.4.3 Performance Guide
    • Designer Guide
      • Coding a theme
      • Design tips
      • Implementing layered navigation in a theme
    • Troubleshooting
    • FAQ
    • User contributions
    • Documentation PDFs
  • Documentation française 1.4
    • Guide de démarrage
    • Mettre à jour PrestaShop
    • Guide de l'utilisateur
      • Formation
      • Personnaliser votre boutique
      • Se connecter au back-office de Prestashop
      • Ajouter des produits et des catégories de produits
      • Un aperçu du catalogue
      • Gérer les clients
      • Gérer les commandes
      • Gérer les méthodes de paiement
      • Gérer le transport
      • Comprendre les statistiques
      • Gérer les modules
      • Gérer les employés
      • Comprendre les préférences
      • Explorer les outils de PrestaShop
      • Obtenir de l'aide
    • Guide de l'administrateur système
    • Guide du développeur
      • Fondamentaux
      • Créer un module PrestaShop
      • Tutoriels pour développeurs
        • Tutoriel Webservice REST
          • Chapitre 1 - Mise en place - Création des accès dans le Back Office
          • Chapitre 2 - Découverte - Tester l'accès au service web avec le navigateur
          • Chapitre 3 - Premiers pas - Accéder au service web et lister les clients
            • 3.1 Accéder au service web
            • 3.2 Gestion des erreurs
            • 3.3 Lister les clients
          • Chapitre 4 - Récuperer des données : Récupérer un client
          • Chapitre 5 - Modification : Mettre à jour un client
          • Chapitre 6 - Création : Formulaire d'ajout à distance
          • Chapitre 7 - Suppression : Retirer des comptes client de la base
          • Chapitre 8 – Utilisation avancée
          • Chapitre 9 - Gestion des images
          • Chapitre 10 - Gestion des prix
          • Mémento : Notions énoncées dans ce tutoriel
        • Mieux comprendre et utiliser les hooks
        • La synchronisation via les Hooks
        • Surcharge et override
        • Modules, surcharge, web service
        • Les bonnes pratiques de la classe Db sur Prestashop 1.4
        • Les modules transporteurs - fonctionnement, création, configuration
        • Cours de sécurité accéléré no. 1 - Never trust foreign data
        • Cours de sécurité accéléré no. 2 - Injections SQL
        • Cours de sécurité accéléré no. 3 - XSS
        • Cours de Sécurité accéléré no. 4 - CSRF
    • Guide du designer
      • Conseils en design
      • Créer un thème
    • Guide du Vendeur
    • Import Wiki FR
      • Dépannage
        • Changer la taille maximum de téléchargement de fichiers
        • Comment ajouter une page à PrestaShop
        • Générer le fichier .htaccess par Prestashop pour avoir des URLs simplifiées
        • Générer un nouveau mot de passe manuellement
        • Import CSV
        • Personnalisation des mails clients
        • Problème d'allocation mémoire chez 1&1
        • Problème pour se connecter après avoir effacé une langue
        • Votre site ne répond plus, une page blanche s’affiche
      • Fidéliser les Clients
      • Gestion des Taxes
      • Installer Un Module
      • Sauvegarder votre Base de Données
    • PDF de la documentation
    • Contributions des utilisateurs
    • Questions fréquentes
  • Documentación española 1.4
    • Introducción
    • Actualización de PrestaShop
    • Guía de Usuario
      • Entrenamiento
      • Personalización de su tienda
      • Exploración del front-office
      • Conexión al back-office PrestaShop
      • Añadir Productos y Categorías de Productos
      • Una Mirada Dentro del Catálogo
      • Gestión de Clientes
      • Gestión de Pedidos
      • Gestión de Métodos de Pago
      • Gestión de Envío
      • Comprensión de las Estadísticas
      • Gestión de Módulos
      • Gestión de Empleados
      • Comprensión de Preferencias
      • Exploración de las herramientas de PrestaShop
      • Soporte PrestaShop
    • Guía del Administrador del Sistema
    • Guía del Desarrollador
      • Aspectos Fundamentales
      • Creación de un módulo de PrestaShop
      • Estándares de desarrollo
      • Manuales de desarrollador
        • Utilización del servicio web REST
          • Capítulo 1 - Creación de Acceso al Back Office
          • Capítulo 2 - Descubrimiento - Pruebas de acceso al servicio web con el navegador
          • Capítulo 3 - Primeros pasos - Acceso al servicio Web y lista de clientes
            • 3.1 - Acceso al servicio web
            • 3.2 - Manejo de errores
            • 3.3 - Enumeración de clientes
          • Capítulo 4 - Recuperación de datos - Recuperación de un cliente
          • Capítulo 5 - Modificación - Actualización de cliente
          • Capítulo 6 - Creación - Formulario En Línea Remoto
          • Capítulo 7 - Eliminación - Eliminar cuentas de clientes de la base de datos
          • Capítulo 8 - Uso avanzado
        • Comprensión y uso de hooks
        • Sincronización a través de Hooks
        • Módulos, Reemplazo, Servicio Web
        • Módulos, Clases y Reemplazo del Controlador
        • Buenas prácticas de Clase DB para Prestashop 1.4
        • Módulos de transportistas - funciones, creación y configuración
        • Curso Acelerado de Seguridad - Episodio 1 - Nunca Confíe en Datos Exteriores
        • Curso Acelerado de Seguridad - Episodio 2 - Inyecciones SQL
        • Curso Acelerado de Seguridad - Episodio 3 - XSS
        • Curso Acelerado de Seguridad - Episodio 4 - CSRF
      • Referencia del servicio web
    • Guía de Diseñador
      • Codificación de un tema
      • Consejos de Diseño
    • Solución de problemas
    • Preguntas Frecuentes
Powered by GitBook
On this page
  • PrestaShop development standard
  • Summary
  • PHP
  • SQL
  • Installing the code validator

Was this helpful?

  1. English documentation 1.4
  2. Developer Guide

Development standard

PreviousCreating a PrestaShop moduleNextPublic and overloadable methods

Last updated 4 years ago

Was this helpful?

Table of contents

/*<![CDATA[*/ div.rbtoc1597330884488 {padding: 0px;} div.rbtoc1597330884488 ul {list-style: disc;margin-left: 0px;} div.rbtoc1597330884488 li {margin-left: 0px;padding-left: 0px;} /*]]>*/

PrestaShop development standard

Summary

PHP

Variable names

  1. Corresponding to data from databases: $my_var.

  2. Corresponding to algorithm: $my_var.

  3. The visibility of a member variable does not affect its name: private $my_var.

Assignments

  1. There should be a space between variable and operators:

$my_var = 17;
$a = $b;

Operators

  1. "+", "-", "*", "/", "=" and any combination of them (e.g. "/=") need a space between their left and right members.

    $a + 17;
    $result = $b / 2;
    $i += 34;
  2. "." does not have a space between its left and right members.

    echo $a.$b;
    $c = $d.$this->foo();

    Recommendation

    For performance reasons, please do not overuse concatenation.

  3. ".=" needs a space between its left and right members.

    $a .= 'Debug';

Statements

  1. if, elseif, while, for: need a space between the if keyword and the bracket ().

    if (<condition>)
    ...
    while (<condition>)
  2. When a combination of if and else is used and both can return a value, the else has to be avoided.

    if (<condition>)
    	return false;
    return true;

    Recommendation

    We recommend one return per method / function

  3. When a method/function returns a boolean and the current method/function's returned value depends on it, the if statement has to be avoided

    public aFirstMethod()
    {
    	return $this->aSecondMethod();
    }
  4. Tests must be grouped by "entity"

    if ($price AND !empty($price))
    	...
    if (!Validate::$myObject OR $myObject->id === NULL)
    	...

Visibility

  1. The visibility must be defined every time, even when it is a public method.

  2. private static function foo()

Method / Function names

  1. Method and function names always use CamelCase: begin with a lowercase character and each following words must begin with an uppercase character.

    public function myExampleMethodWithALotOfWordsInItsName()
  2. Braces introducing method code have to be preceded by a carriage return.

    public function myMethod($arg1, $arg2)
    {
    	...
    }
  3. Method and function names must be explicit, so function names such as b() or ef()are completely forbidden.

    Exceptions

    The only exceptions are the translation function (called l()) and debug the functions (named p() and d()).

Enumeration

Commas have to be followed (and not preceded) by a space.

protected function myProtectedMethod($arg1, $arg2, $arg3 = null)

Objects / Classes

  1. Object name must be singular.

    class Customer
  2. Class name must follow the CamelCase practice, except that the first letter is uppercase.

    class MyBeautifulClass

Defines

  1. Define names must be written in uppercase

  2. Define names have to be prefixed by "PS_" inside the core and module

    define('PS_DEBUG', 1);
    define('PS_MODULE_NAME_DEBUG', 1);
  3. Define names does not allow none alphabetical characters. Except "_".

Keywords

All keywords have to be lowercase: as, case, if, echo, null.

Constants

Constants must be uppercase, except for "true", "false" and "null" which must be lowercase: ENT_NOQUOTE, true.

Configuration variables

Configuration variables follow the same rules as defined above.

Strings

Strings have to be surrounded by simple quotes, never double ones.

echo 'Debug';
$myObj->name = 'Hello '.$name;

Comments

  1. Inside functions and methods, only the "//" comment tag is allowed.

  2. After the "//" comment marker, a space is required: // Comment.

    // My great comment
  3. The "//" comment marker is tolerated at the end of a code line.

    $a = 17 + 23; // A comment inside my example function
  4. Outside of functions and methods, only the "/" and "/" comment markers are allowed.

    /* This method is required for compatibility issues */
    public function foo()
    {
    	// Some code explanation right here
    	...
    }
  5. PHP Doc comment block is required before the declaration of the method.

    /**
     * Return field value if possible (both classical and multilingual fields)
     *
     * Case 1: Return value if present in $_POST / $_GET
     * Case 2: Return object value
     *
     * @param object $obj Object
     * @param string $key Field name
     * @param integer $id_lang Language id (optional)
     * @return string
     */
    protected function getFieldValue($obj, $key, $id_lang = NULL)

    For more informations

Return values

  1. The return statement does not need brackets, except when it deals with a composed expression.

    return $result;
    return ($a + $b);
    return (a() - b());
    return true;
  2. The return statement can be used to break out of a function.

    return;

Call

Function call preceded by a "@" is forbidden but beware with function / method call with login / password or path arguments.

myfunction()
// In the following example, we put a @ for security reasons
@mysql_connect(...);

Tags

  1. There must be an empty line after the PHP opening tag.

    <?php
    
    require_once('my_file.inc.php');
  2. The PHP ending tag is forbidden

Indentation

  1. The tabulation character (" t") is the only indentation character allowed.

  2. Each indentation level must be represented by a single tabulation character.

    function foo($a)
    {
    	if ($a == null)
    		return false;
    	...
    }

Array

  1. The arraykeyword must not be followed by a space.

    array(17, 23, 42);
  2. When too much data is inside an array, the indentation has to follow the following.

    $a = array(
    	36 => $b,
    	$c => 'foo',
    	$d => array(17, 23, 42),
    	$e => array(
    		0 => 'zero',
    		1 => $one
    	)
    );

Bloc

Braces are prohibited when they only define one instruction or a combination of statements.

if (!$result)
	return false;

for ($i = 0; $i < 17; $i++)
	if ($myArray[$i] == $value)
		$result[] = $myArray[$i];
	else
		$failed++;

Security

  1. All user's data (data entered by users) has to be cast.

    $data = Tools::getValue('name');
    
    $myObject->street_number = (int)Tools::getValue('street_number');
  2. All method/function's parameters must be typed (when Array or Object) when received.

    public myMethod(Array $var1, $var2, Object $var3)
  3. For all other parameters, they have to be cast each time they are used, except when they are sent to other methods/functions.

    protected myProtectedMethod($id, $text, $price)
    {
    	$this->id = (int)$id;
    	$this->price = (float)$price;
    	$this->callMethod($id, $price);
    }

Limitations

  1. Source code lines are limited to 150 characters.

  2. Functions and methods lines are limited to 80 characters. Functions must have a good reason to have an overly long name: keep it to the essential!

Other

  1. It is forbidden to use a ternary into another ternary (such as echo ((true ? 'true' : false) ? 't' : 'f');).

  2. We recommend the use of && and || into your conditions: echo ('X' == 0 && 'X' == true

  3. Please don't use reference parameters (such as {{function is_ref_to(&$a, &$b) { ... }}}).

SQL

Table names

  1. Table names must begin with the PrestaShop "DB_PREFIX" prefix.

    ... FROM `'. _DB_PREFIX_.'customer` ...
  2. Table names must have the same name as the object they reflect: "ps_cart".

  3. Table names have to stay singular: "ps_order".

  4. Language data have to be stored in a table named exactly like the object's table, and with the "_lang" suffix "ps_product_lang".

SQL query

  1. Keywords must be written in uppercase.

    SELECT `firstname`
    FROM `'. _DB_PREFIX_.'customer`
  2. Back quotes ("`") must be used around SQL field names and table names.

    SELECT p.`foo`, c.`bar`
    FROM `'. _DB_PREFIX_.'product` p, `'. _DB_PREFIX_.'customer` c
  3. Table aliases have to be named by taking the first letter of each word, and must be lowercase.

    SELECT p.`id_product`, pl.`name`
    FROM `'. _DB_PREFIX_.'product` p
    NATURAL JOIN `'. _DB_PREFIX_.'product_lang` pl
  4. When conflicts between table aliases occur, the second character has to be also used in the name.

    SELECT ca.`id_product`, cu.`firstname`
    FROM `'.DB_PREFIX.'cart` ca, `'. _DB_PREFIX_.'customer` cu
  5. Indentation has to be done for each clause

    $query = 'SELECT pl.`name`
    FROM `'.PS_DBP.'product_lang` pl
    WHERE pl.`id_product` = 17';
  6. It is forbidden to make a JOIN in a WHERE clause.

Installing the code validator

Eclipse integration

Quick links:

You will then have to add the PrestaShop code standard to the Eclipse preferences: go to "PHP Tools" and choose the PS standard that you downloaded earlier (see link above).

If the file does not automatically validate, as it should, you can configure this in the "Preferences" menu, "Validation" option. Otherwise, just right-click on the folder/file in the file-tree, and choose "PHP Tools" in the contextual menu (which you can also be set as a shortcut).

Command line (Linux)

You do not have to use Eclipse to use PHP CodeSniffer, you can also install it so that it can be called from the command line.

  1. Launch PHP CodeSniffer $> phpcs --config-set default_standard Prestashop

Using the program

The various options for this command are well explained in its documentation. For now, here is the easy way to launch it:

$> phpcs --standard=/path/to/norm/Prestashop /folder/or/fileToCheck

In order to only display errors, not warnings:

$> phpcs --standard=/path/to/norm/Prestashop --warning-severity=99 /folder/or/fileToCheck

If you have already manually installed PHP CodeSniffer, the program should be in PEAR's "scripts" folder.

Windows users: although the phpcs.bat file should be in that "scripts" folder, you might have to edit it in order for it to work properly (replace the paths with yours):

path/to/php.exe -d auto_apprend_file="" -d auto_prepend_file -d include_path="path/to/PEAR/" path/to/pear/scripts/phpcs

Integrating the program to Eclipse's console (optional)

  1. Click on the "External tools" button in the icon bar (a green arrow pointing at a small red folder).

  2. Click on the "External tools configuration" tab.

  3. Double-click on "Program" in order to create a configuration:

    1. Location: path to the phpcs program (or phpcs.bat for Windows users).

    2. Arguments: the arguments for the command line, for instance --standard=Prestashop.

The order of the method properties should be: visibility function functionName().

For more informations about the PHP Doc syntax:

This is a brief tutorial on how to install a code validator on your PC and use it to validate your files. The code validator uses PHP CodeSniffer, which is a PEAR package (). The PrestaShop code standard was created specifically for CodeSniffer, using many rules taken from existing standards, with added customized rules in order to better fit our project.

You can download the PrestaShop code standard using Git: (you must perform this step before going any further with this tutorial).

If you use Eclipse, you can integrate code validation within the text editor using a plugin, which is very easy to install: .

The configuration of the plugin is also very simple: . In the list of available packages, only choose PHP CodeSniffer and PEAR if you do not yet have them.

Install PEAR: $> apt-get install php-pear

Install PHP CodeSniffer in PEAR: $> pear install PHP_CodeSniffer

Add the PrestaShop standard that you downloaded from SVN earlier, and place it in PHP CodeSniffer's "Standards" folder. $> git clone /usr/share/php/PHP/CodeSniffer/Standards/Prestashop

static
http://manual.phpdoc.org/HTMLSmartyConverter/HandS/phpDocumentor/tutorial_tags.pkg.html
http://pear.php.net/package/PHP_CodeSniffer/
https://github.com/PrestaShop/PrestaShop-norm-validator
Official installation guide
Official configuration guide
http://www.phpsrc.org/projects/pti/wiki/Installation
http://www.phpsrc.org/projects/pti-php-codesniffer/wiki/Configuration
http://pear.php.net/
http://pear.php.net/package/PHP_CodeSniffer
https://github.com/PrestaShop/PrestaShop-norm-validator
PrestaShop development standard
Summary
PHP
SQL
Installing the code validator
#PHP
#PHP
#SQL
#Variable names
#Strings
#Table names
#Assignments
#Comments
#SQL query
#Operators
#Return values
#Statements
#Call
#Visibility
#Tags
#Method / Function names
#Indentation
#Enumeration
#Array
#Objects / Classes
#Bloc
#Defines
#Security
#Keywords
#Limitations
#Constants
#Other
#Configuration variables