Loïc Vernet COil

Code is clean if it can be understood easily – by everyone on the team. Clean code can be read and enhanced by a developer other than its original author. With understandability comes readability, changeability, extensibility and maintainability.

General rules

Follow standard conventions.
Keep it simple stupid. Simpler is always better. Reduce complexity as much as possible.
Boy scout rule. Leave the campground cleaner than you found it.
Always find root cause. Always look for the root cause of a problem.

Design rules

Let's migrate a Symfony 2.8 LTS application to Symfony 3 LTS

Handle deprecations

First of all, ensure you don't have any deprecated!

The Symfony documentation explains it well, but let's sum up:

install the phpunit bridge ($ composer require --dev symfony/phpunit-bridge)
also check all your pages using web profiler and be ensure there is no deprecation error handled
found errors and need help about how to fix it ? I did a sort of guide.

Tabs and Windows

Function	Shortcut
New Tab	`⌘` + `T`
Close Tab or Window	`⌘` + `W` (same as many mac apps)
Go to Tab	`⌘` + `Number Key` (ie: `⌘2` is 2nd tab)
Go to Split Pane by Direction	`⌘` + `Option` + `Arrow Key`
Cycle iTerm Windows	`⌘` + `backtick` (true of all mac apps and works with desktops/mission control)

	Possible values for ext-name:

	bcmath
	bz2
	calendar
	ctype
	curl
	dba
	dom
	enchant

	#!/bin/bash
	set -euo pipefail
	IFS=$'\n\t'

	# Ubuntu Server

	export DEBIAN_FRONTEND=noninteractive

	echo -e "\e[96m Adding PPA \e[39m"
	sudo add-apt-repository -y ppa:ondrej/apache2


	#
	# Ubuntu 16.06 LTS (Xenial Xerus)
	#
	# Basic packages i usually install.
	#
	# Author: Julius Beckmann <[email protected]>
	#
	# Upgraded Script from 14.04: https://gist.github.com/h4cc/7be7f940325614dc59fb
	#

	<?php

	// ...

	use Doctrine\Common\Collections\ArrayCollection;
	use Symfony\Component\Form\AbstractType;
	use Symfony\Component\Form\Extension\Core\Type\CheckboxType;
	use Symfony\Component\Form\Extension\Core\Type\ChoiceType;
	use Symfony\Component\Form\Extension\Core\Type\PasswordType;
	use Symfony\Component\Form\Extension\Core\Type\RepeatedType;

	App\Model\File:
	type: entity
	table: files
	entityListeners:
	App\Doctrine\EventListener\FileUploadListener:
	prePersist: [upload]
	preUpdate: [upload]
	preRemove: [remove]
	id:
	id:

	<?php

	use Symfony\Component\HttpFoundation\Request;
	use Symfony\Component\Debug\Debug;

	// If you don't want to setup permissions the proper way, just uncomment the following PHP line
	// read http://symfony.com/doc/current/book/installation.html#configuration-and-setup for more information
	//umask(0000);

	// This check prevents access to debug front controllers that are deployed by accident to production servers.

	#! /bin/sh

	output="$(php app/console doctrine:schema:update --dump-sql)";

	echo $output;

	case $output in
	Nothing* ) return 0;;
	esac