Skip to content

Latest commit

 

History

History
643 lines (573 loc) · 38.2 KB

README.md

File metadata and controls

643 lines (573 loc) · 38.2 KB
Raw

{% raw %} <-- keep this for Jekyll to fully bypass this documents, because of the Twig tags.

Symfony Website Checklist 📑

Summary

Elevator pitch

This project lists all the mandatory steps I recommend to build a website using:

  • HTTPS + HTML output,
  • A local, PHP-integrated server first, Docker as a "maybe" later on,
  • Symfony,
  • Twig,
  • Doctrine ORM,
  • Any RDBMS.

This project assumes you start from zero.

This project README will remain in one file to ease searching from a browser.

All the files referenced in this document can be found in the /files-you-will-need directory of this repository. This directory reflects the exact, expected directory tree as you grow it.

Philosophy

The idea behind this is as follows:
The exhaustive version of a HowTo would be the official documentation.
The slightly slower version of this would be to watch tutorials and use cases from SymfonyCasts.
The faster way would be to read The Fast Track, precisely written by Fabien Potencier.
A complementary faster way would be to read the framework best practices (mostly focused on Symfony).
The fastest way to me, trading possibilities for opinions, should be this repository.

All contributions and suggestions are welcome. 😇

1. Set up your environment

This section applies to any local, host OS or Docker project construction.

If you intend to use Docker the super fast way, you can bypass this section.

  1. Set up PHP/latest.
    On Linux, use your package manager (like Aptitude or Yum). sudo su && apt-get update && apt-get install php8 at least.
    On MacOS, use Brew through brew install php.
    On Windows:
    • Download it from windows.php.net (take the latest version, VS16 x64 Thread Safe, with OpenSSL)
    • Unzip it to C:\php[VERSION DIGITS].
    • Then change your PATH system variable (Windows + R, type PATH, hit Enter, click on Environment Variables , then your user variables, edit the PATH entry and append the previously unzipped directory path to it).
  2. Copy php.ini-development to php.ini in your
  3. Configure your PHP locally for your dev environment.
    • Set memory_limit to 8M
    • Set max_ececution_time to 200
    • Set upload_max_filesize to 200M
    • Uncomment the extension_dir directive. Careful: it's different on Windows vs the rest of the world.
    • Uncomment to enable the following extensions: bz2, curl, gd, intl, mbstring, mysqli, openssl, pdo_mysql, sodium.
    • Define the date.timezone directive to your local timezone.
      • Mine is "Europe/Paris", for instance.
      • The complete list is here.
  4. On Windows, download and install Composer Setup and Symfony Setup.
  5. Check that you got everything OK using symfony check:requirements in any environement. Ignore the "Enable or install a PHP accelerator" advice in development.
  6. Start from an empty directory, use symfony new [your_project_directory_name].
  7. Create a README.md file inside the root directory and put everything you can document inside, at least those sections:
    • The title of the project.
    • The purpose of the project.
    • How to set it up.
    • How to run basic commands it requires to work (including Docker).
    • Contribution / modification instructions.
    • Architectures / coding / technology choices.
  8. Add a readme-sources directory at the root of your project. Anything that is included in MarkDown documentation goes there.
  9. Install a RDMBS (let's start with that, right?), like MySQL, MariaDB, or PostGreSQL. Same again:
    • On Windows, just download the installers and set them up as services, don't use standalone Zip files.
    • On MacOSX, use Brew through brew install mysql then brew services start mysql.
  10. Set up your DotEnv files:
    • Create a .env.local file by copying the .env one.
    • Change the APP_SECRET value to anything.
    • Change the DATABASE_URL to the appropriate values to connect to your RDBMS.
  11. If you use PHPStorm, use File > Manage IDE settings > Import settings and pick up the phpstorm-settings.zip included in this repository.
  12. Configure Git:
    • git config --global rebase.autostash true
    • git config --global rebase.autosquash true
    • git config --global rebase.abbreviateCommands true
    • git config --global rebase.instructionFormat "[%an @ %ar] %s"
    • git config --global core.excludesfile ~/.gitignore
    • git config --global core.autocrlf false
    • echo ".idea" >> ~/.gitignore
    • echo ".DS_Store" >> ~/.gitignore
    • echo ".vscode" >> ~/.gitignore

2. Set up a new Symfony project

  1. Install PHP-Stan as a dev dependency (composer require --dev phpstan/phpstan).
    • You can do this in a separate directory outside your project as a better practice.
    • Create your configuration file for PHP-Stan if you know what you're doing. If you don't, just use the one in this repository (phpstan.neon).
    • Let it at the root of your project for now.
    • Also install additional Symfony and Doctrine plugins:
      • composer require --dev phpstan/extension-installer,
      • composer require --dev phpstan/phpstan-symfony,
      • composer require --dev phpstan/phpstan-doctrine.
    • Make sure PHP-Stan also checks the config directory, and goes to the maximum level. Mine looks like this:
parameters:
    level: 9
    paths:
        - config
        - src
        - tests
    checkGenericClassInNonGenericObjectType: false
    ignoreErrors:
        - '#Property .* is never written, only read\.#'
    symfony:
        container_xml_path: var/cache/dev/App_KernelDevDebugContainer.xml
  1. Install PHP-CS-Fixer as a dev dependency (composer require --dev friendsofphp/php-cs-fixer).
    • You can do this in a separate directory outside your project as a better practice.
    • Create your configuration file for PHP-CS-Fixer if you know what you're doing. If you don't, just use the one in this repository (.php-cs-fixer.dist.php).
    • Let it at the root of your project for now.
  2. Install Psalm as a dev dependency (composer require --dev vimeo/psalm).
    • You can do this in a separate directory outside your project as a better practice.
    • Create your configuration file for Psalm if you know what you're doing (php vendor/bin/psalm --init). If you don't, just use the one in this repository (psalm.xml).
    • Let it at the root of your project for now.
    • Also install additional Symfony and Doctrine plugins: composer require --dev psalm/plugin-symfony and composer require --dev weirdan/doctrine-psalm-plugin.
  3. Create a shell command to start them, at the root of your directory (you can safely copy the ones in this repository).
    • Give them short names so you don't lose time calling them manually.
    • Don't start their names with "php", they all share this and slows down your CLI calls.
    • Call them csfixer, stan and psalm, with appropriate shell extensions (.bat or .sh).
  4. Add a .editorconfig file at the root directory of your project to ensure your IDE settings don't get messed up.
    • At least set it up so you use UTF-8, LF characters for newlines and 4 spaces as tabulations.
    • If you don't, just use the one in this repository (.editorconfig).
  5. If you know what you're doing, use REDIS to store PHP sessions at least. Try it for custom cache pools (this goes beyond the purpose of this document).
  6. Make sure you provide the appropriate DSN for your databases and the right serverVersion parameter. Use dynamic parameters with $ to set them up.
  7. In your composer.json file, group requirements, to allow better upgrades, like:
    • PHP-related
    • Extension polyfills (like ext-ctype, etc.)
    • Composer-related (Flex, package deprecations, etc.)
    • Symfony core-related
    • Symfony non-core-related (Webpack, Sensio, SymfonyCasts, etc.)
    • Twig-related
    • Doctrine or any other DB stuff-related
    • Other external libraries
    • Same for require-dev: group by Symfony-related, PHP-CS-Fixer, static analyzers, etc.

3. Set up your Twig templates

  1. Identify your application domains. If you have no idea what this means, or which to use, simply go with Admin and Front, plus one for each of your application "modules".
  2. Install Twig and the extensions you're going to use.
    • composer require twig
    • composer require twig/extra-bundle
  3. Create global variables for Twig that you're going to need, simply edit config/packages/twig.yaml as follows:
twig:
    # ...
    globals:
        # Used for the tab title 
        globals_website_title_suffix: ' | Your website suffix'
        # Used for OpenGraph
        globals_website_url: 'https://your.super.url'
        # Used at many places
        globals_website_name: 'Your website name'
        # Used for schema.org data
        globals_website_subtitle: 'Something like your slogan'
        # Used for OpenGraph data
        globals_website_description: 'The long description, mostly for <meta> tags and OpenGraph description.'
        # You'll need to change this if you want to enable Facebook Sharer
        globals_facebook_app_id: '1111111111111111'
    # ...
  1. For the following steps, if you want to be lazy, just copy the templates from this repository for a start:
    • admin_layout.html.twig goes to templates/admin
    • front_layout.html.twig goes to templates/front
    • base.html.twig goes to templates
  2. If you didn't copy the files from the previous step, then do as follows:
    • Create a layout file inside each domain subdirectory, name it as follows: [domain]_layout.html.twig.
    • Add a base class block to your <html> tag in base.html.twig template and override it in each [domain]_layout.html.twig templates.
    • Define your metadata in your base.html.twig, at least (including default strategy):
      • <html> defaults: language and direction.
      • The viewport strategy for CSS processing. If you don't know what to put, use defaults: <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover">.
      • OpenGraph metadata.
      • HTML metadata, including a unique description under 150 characters.
      • Schema.org metadata.
      • Twitter / Facebook metadata.
      • Webpack Encore styles and scripts tags.
      • Dynamic <title> markup with a default suffix containing your website name (you can cut it off to ~50 characters).
      • UTF-8 charset.
      • A canonical markup for SEO (<link rel="canonical" href="{{ url(app.request.attributes.get('_route'), app.request.attributes.get('_route_params')) }}">).
      • Alternate languages using <link> if applicable, including the default one.
      • Platform-specific tags for Windows Tiles and Apple Web Apps (including a browserconfig.xml file).
      • Overridable blocks for all of these.
  3. Your /templates directory should at least contain:
    • admin
    • common
    • front
    • registration
    • security
    • base.html.twig
  4. Make sure all the files and directories under /templates use snake_case only for their filenames.
  5. Add file input previews to all image fields using a LiipImagineBundle preset through a custom form theme (add it in config/twig.yaml).
  6. Customize your error pages.
    • The whole tutorial is in the documentation (https://symfony.com/doc/current/controller/error_pages.html).
    • This implies that you change at least the basic messages: HTTP 500, 404 and 403 (if you don't use them, you app seems weird or overcomfident).
    • Basically, this simply means you need to create templates in templates/bundles/TwigBundle/Exception, don't forget to start with a generic one: error.html.twig.
    • Test them during development (there's a simple way to do that, you don't need to generate the errors, the framework will create artificial routes for you)
    • Use a friendly message for the content, put something nice (and funny, to compensante the sadness of viewing error pages), with jokes linked to your website contents.
    • Include a way for people to go on browsing. You have to have all main navigation, menus and incentives to redirect users to the most common pages.
  7. Customize your error (flash) messages:
    • Add classes to your messages. Design them so that they use iconic fonts, like Fontello.
    • Use the PSR-3 error types if you lack imagination (info notice warning error) and add "success", too.
    • Make sure they don't take too much place nor break your design but can be stacked.
    • Output them with |raw to use links and HTML, but NEVER output anything from the user or not sanitized in their contents (could be a security flaw).
  8. Add a template with breadcrumbs:
    • Any controller action should provide an array of elements (link title, link text, order, hypermedia URL). Or auto-generated breadcurmb items.
    • Add schema.org breadcrumb data, using JSON-LD, following Google recommendations.
    • Using defensive programming (if not set, no breadcrumb, no JSON-LD).
    • Make sure your breadcrumb order is coherent across pages.
    • Use the template in this repository as a start if needed (files-you-will-need/templates/common/_breadcrumb.html.twig).
  9. Make sure your <title> markup doesn't contain any HTML markup nor non-escaped special characters. Do the same for all the <head> contents.
  10. Make sure your assets are loaded in order: CSS > fonts > JS modules > JS (using async/defer) > images > audio > video.
  11. Check your HTML 5 semantics. Make sure you're using it, and using it properly.
  12. Implement <noscript> alternates, this is getting almost deprecated, but it's not yet totally the case.
  13. Use the dns-prefetch for anything located on other domains, preconnect for potential follow-ups, preload for probable further needs and preload for certain calls.
  14. Validate all your whole page template using production environment and the W3C HTML Validator. Do the same for CSS.

4. Produce your models

  1. List all your entities, think about them until you can't find new fields/properties to add.
  2. Add Doctrine DBAL + ORM (composer require orm).
  3. If you want to use migrations, add Doctrine Migrations (composer require migrations).
    • If you have no idea what to do and work alone on your project, don't use them (composer remove doctrine/migrations, same for dependencies).
    • If you end up using them, create a /migrations directory at the root directory of your project.
  4. Install the MakerBundle (composer require --dev maker).
  5. Use the MakerBundle to generate their CRUDL. For each entity, run php bin/console make:crud.
  6. Create a Model directory under /src to store all models that are not entities.
  7. Make sure all the files and directories under /src use CamelCase only for their filenames.
  8. Check that your entities are valid using php bin/console doctrine:schema:validate.
  9. If you're using migrations, check that you're good with php bin/console doctrine:migrations:up-to-date.
  10. Slugify all your public content URLs in the form of [domain]/[entity type]/{slug}-{id} using AsciiSlugger. Remove the words shorter than 3 characters.
  11. Make sure if entites are tightly linked and fetching one of them always requires/triggers another one, use fetch="EAGER"``on your ManyToOne` relations.
  12. Make sure your setters return the current class at worst, unless very specific needs require otherwise, to enable chaining.

5. Set up translations (even if you only use one language)

  1. Install the Translation component: composer require symfony/translation.
  2. Set up your default language in config/packages/translation.yaml. Mine looks like this (for non-geographic English as the default language):
framework:
    # ...
    default_locale: en
    translator:
        default_path: '%kernel.project_dir%/translations'
        fallbacks:
            - en
    # ...
  1. Set up your languages logic in config/services.yaml. Mine looks like this:
parameters:
    # ...
    app.supported_locales:
        - en
        - fr
    # ...
  1. Create a messages.[yourdefaultlanguage].yaml in the translations folder. Don't use ICU unless you know why.
  2. Create a validators.[yourdefaultlanguage].yaml in the translations folder. Don't use ICU unless you know why.
  3. Repeat last two steps for each additional language you'll need.
  4. Whatever you'll do, make sure you keep alphabetical / ASCII order for translation keys inside YAML files.
  5. Whatever you'll do, make sure you'll ONLY use YAML-parse syntax for keys (e.g. front.forms.users.create.name.help).
  6. Make sure all the files and directories under /translations use snake_case only for their filenames.

6. Set up your basic application logic

  1. Create a subdirectory for each of your domains, at least for Admin and Front (that's already enough):
    • In src/Controller.
    • In src/Form.
    • In src/Model.
  2. Do the same in the Twig /templates directory: create /admin and /front subdirectories in it.
  3. Move your CRUDL controllers to src/Controller/Admin, and their templates to templates/admin.
  4. Update the namespaces, templates name references in the controllers and templates according to last point.
  5. Inside each messages.[language].yaml translations file, start root keys with your domains, all snake case. At least they should look like this:
front:

admin:
  1. Add constraint validation to the maximum properties you can set to in your entity files.
    • Run composer require symfony/validator doctrine/annotations.
    • This supposes, at least:
      • That ALL your fields have a @Assert
  2. Make sure all your entities are historizable, which means they should have creation and last modification dates attached:
    • To achieve that, use a PHP trait in all your entities.
    • If you have no idea what this means, simply use the file HistoryTrackableEntity.php in this repository.
    • Put the trait in your src/Entities directory.
    • Add an @ORM\HasLifecycleCallbacks annotation to all your entities.
    • Add use HistoryTrackableEntity; after each Entity class opening bracket (first line, before constants and properties).
    • Update the database (php bin/console doctrine:schema:update or use migrations if you chose to use them).
  3. Review ALL your forms, they need to have:
    • empty_data provided, especially for non-nullable fields.
    • help for all fields with filling guidelines.
    • A clear label for all fields.
    • A placeholder for all fields ('attr' => ['placeholder' => 'your.placeholder.translation.key']).
    • Localized form errors.
  4. Define a custom, static menu configuration. If you want a dynamic one or use a premade bundle like KnpMenuBundle, it's up to you.
    • Create model/Admin/AdminMenus.php and model/Front/FrontMenus.php files.
    • Just make them use a multidimensional public static array $adminMenuTree = []; array structure that returns all menus. See included FrontMenus.php class.
    • Create a Twig extension to output them, either use make:twig-extension or just copy the one included in this repository (MenuExtension.php).
    • Then make a common template for menus (templates/common/_menu.html.twig) or just copy the one included in this repository.
  5. Remove the dead code in your entity repositories (src/Repository).
  6. Unify templates as much as you can:
    • Move any MakerBundle-generated _delete_form.html.twig and _form.html.twig to templates/admin/common.
    • Update all the CRUDL templates so they use those.
    • Delete the remaining, unused templates.
  7. Make sure your app doesn't send emails, apart from user account management (account creation, password reset). Most of them are not necessary.
  8. As much as you can, try to offer an eco-friendly version of your app. To do so:
    • Use cookies (since they're functional, they're GPDR-compliant) to remember usage choice.
    • Create eco-friendly and regular Twig layouts.
    • Pick up the top layout from your cookies as defined above.
    • Use a CSS purger to remove unused CSS.
    • Load only one compressed, optimized, alternate CSS stylesheet.
    • Include all accessibility HTML (don't forget ARIA, remove the decorative HTML by using the same Twig conditions on cookies.
    • When cookies are not set, redirect the user to a minimal choice page.
    • Try to lazy load images and other assets, depending on the parts above the fold.
    • If your application logic requires an update because of that, you need to rethink how it works.
    • Don't include unnecessary content, like unused styles from web fonts, hidden images, etc.
    • Don't forget responsive web integration as well.
  9. Make sure people can't manipulate entites that they're not supposed to:
    • Because of roles hiearchy
    • Because of missing roles
    • Because of bad Security API use
    • Because of no ownership checks on entities
    • Because of bad HTTP methods
  10. Don't forget to add a human-readable sitemap of your website.
  11. Don't forget to add a SEO-oriented XML sitemap.
    • You can make it dynamic and use caching (Symfony action caching and/or Twig {cache} markup).
    • You can generate it statically, too.
    • Test that they don't go over 50 000 URLs. Include a sitemap index if it happens, with links to chunks.
    • Include all your public static routes, and loop through the significant content by priority.
    • Ignore callbacks, dynamic URLs, canonical URLs, assets.
    • The crawlers will find the rest if it appears on links and test a lot of URLs from external mesh.
  12. Consider implementing service workers caching if they can help. This can be longer when added in the end.

7. Secure your app

  1. Make a User class using the MakerBundle: php bin/console make:user.
  2. Make a authentication plugin using the MakerBundle: php bin/console make:auth. Pick a custom authenticator name.
  3. Don't forget to make the appropriate CRUDL using the MakerBundle: php bin/console make:crud.
  4. Modify the new and edit actions of the generated controller so that they encode passwords using UserPasswordHasherInterface.
  5. Define your roles in config/packages/security.yaml. Mine looks like this (read the comments):
security:
    enable_authenticator_manager: true
    password_hashers:
        Symfony\Component\Security\Core\User\PasswordAuthenticatedUserInterface: 'auto'
        App\Entity\User:
            algorithm: auto

    providers:
        app_user_provider:
            entity:
                class: App\Entity\User
                property: email # Can be anything you want
    firewalls:
        dev:
            pattern: ^/(_(profiler|wdt)|css|images|js)/
            security: false
        main:
            lazy: true
            provider: app_user_provider
            custom_authenticator: App\Security\AppAuthenticator # Use your custom authenticator name here
            logout:
                path: app_logout
                target: app_home # Set this to your public homepage, that defaults to "/" at least 

    access_control:
    # Uncomment this after step 6. in this chapter
    # - { path: ^/admin, roles: ROLE_ADMIN }

    role_hierarchy:
        # Administers the whole website
        ROLE_ADMIN: ROLE_USER
        # Simple role added by Symfony
        ROLE_USER:
  1. Then create your admin user while the CRUDL are public, and set yourself to the maximum administrator role level.
  2. Once your admin user is created:
    • Uncomment the access_control directive in the file above
    • Prefix your generated UserController with: #[Route('admin/user')].
    • Do the same for ALL the controllers you set:
      • behind the src/Controller/Admin directory,
      • the admin ones wherever they are,
      • and all the generated CRUDL ones.
  3. Use the MakerBundle to make a registration process (php bin/console make:registration-form).
  4. The SecurityController.php and RegistrationController.php stay at the root of src/Controller directory.
  5. Run composer require tgalopin/html-sanitizer-bundle and sanitize all user-generated fields that are displayed without escaping.
  6. Configure the framework.trusted_hosts and framework.trusted_headers parameters in your config/packages/prod/framework.yaml file (or any environment file needed).
  7. Check your app through https://github.com/fabpot/local-php-security-checker on a regular basis (add it to your CI and your local habits).
  8. Every time you add an action, before you even start writing it, check the security first. Do the same when you're done.
  9. Make sure you use absolutely generic and unique error messages for login and password reset actions. Don't reveal what was wrong on user side.
  10. Test your application against security tools, like testing your dependencies on the frontend and backend, HTTP attacks, OWASP vulnerabilities.

8. Use TailwindCSS for styles and RWI

  1. Update config/twig.yaml and set this:
twig:
    # ...
    form_themes: [ 'tailwind_2_layout.html.twig' ]
    # ...
  1. Add Webpack Encore, with PurgeCSS and PostCSS:
    • Install Node (pick the latest LTS version):
      • On Windows and MacOS, just use the installer and restart your shell.
      • On Linux, use your package manager (like Aptitude or Yum). sudo su && apt-get update && apt-get install nodejs npm at least.
    • Run composer require encore and npm install.
    • Run npm install -D tailwindcss postcss-loader purgecss-webpack-plugin glob-all path autoprefixer.
    • Setup Webpack, PostCSS and Tailwind.
      • If you don't know what this means, simply copy/overwrite the following files from this repository to your project root directory:
        • postcss.config.js
        • tailwind.config.js
        • webpack.config.js
    • Run npm run build.
  2. Make sure you have the following structure at least in assets:
    • controllers
    • favicon
    • fonts
    • images
    • styles
    • app.js
    • bootstrap.js
    • controllers.json
  3. Create a favicon and add its configuration to your base.html.twig and assets/favicon/browserconfig.xml. Use a favicon generator for that and a manifest file.
  4. Create a default OpenGraph image for your site and put it in assets/images (name it ogimage.jpg if you copied the included files of this project).
  5. Prepare an external shell script to start your project from your user home directory. See an example with start-project included scripts.
  6. Try to prepare and use srcset with multiple resolution sources, to adapt to screen resolution.
  7. Try to prefer SVG to images sources, which also avoids using image sprites (iconic fonts can also do the same).
  8. Make sure you always use WOFF2 at least when it comes to web fonts inclusion.
  9. Try to output the height and width dimensions on all image sources to allow X/Y space reservation on browsers.
  10. Make sure all images have a descriptive alt attribute which explains what they contain.
  11. Don't put any JavaScript inside the <body> markup. At worst put it all just before the </body> closing tag.
  12. Configure a CDN for your assets with if this is within your reach. Start with a tight policy and expand durations if it all works correctly.

9. Pre-flight checks

  1. Run symfony check:security to validate that your project has no known vulnerabilities from its dependencies.
  2. Check that you got everything OK using symfony check:requirements while on the production server (see above). This time, pay attention to OPCache (see below).
  3. Create a deployment script for your non-dev environments.
    • If you don't know what you're doing, use the one provided in this repository (production-deployment.sh.dist) for a start.
    • On your non-dev environments, copy the production-deployment.sh.dist to [environment]-deployment.sh.
    • Check that they're in the .gitignore and only on destination servers filesystems. Don't version the final ones.
    • Use those scripts to clear OpCache and realpath caches.
  4. Make sure your application only uses HTTPS. Your config/services.yaml should contain this:
parameters:
    # ...
    router.request_context.scheme: 'https'
    asset.request_context.secure: true
    router:
        request_context:
        scheme: 'https'
    asset:
        request_context:
            secure: true
    # ...
  1. Validate your project with PHP-Stan (using the shell scripts created in #1.).
  2. Validate your project with Psalm (using the shell scripts created in #1.).
  3. Validate your project with PHP-CS-Fixer (using the shell scripts created in #1.).
  4. If needed, configure your CI. There's an included sample file for GitLab CI inside this project, see .gitlab-ci.yml (checks that you didn't forget PHP-CS-Fixer).
  5. Add a robots.txt file inside the public directory. Use the one provided in this repository for a start.
  6. Add a site.webmanifest file inside the public directory. Use the one provided in this repository for a start.
  7. Enable it by adding this to your base.html.twig file: <link rel="manifest" href="{{ asset('site.webmanifest') }}">.
  8. Finally, you can start your project (locally) using:
    • symfony local:server:ca:install
    • symfony server:start -d
    • npm run watch
  9. And you can prepare your assets for deployment using: npm run build.
  10. Configure your non-dev environments (this goes way beyond this project boundaries ^^). If your non-dev servers are Apache, you can use composer require symfony/apache-pack.
  11. Start writing PHPUnit tests under the tests/ directory. You will need WAY less of them as long as your code passes PHP-Stan and Psalm maximum level scans.
  12. On production servers, make sure (if you have access to the PHP configuration and your project is the only one, which it should be):
    • PHP memory_limit is set just around 8M for CLI and 1M for web SAPIs. More if PHP processes files.
    • PHP max_execution_time is set to 1200 for CLI and 30 for wep SAPIs. More for CLI if your app has heavy CLI processing.
    • PHP realpath_cache_size is set to 512K for CLI and 16M for wep SAPIs.
    • PHP realpath_cache_ttl is set to 600 for CLI and 2000 for wep SAPIs.
    • PHP OpCache is configured:
      • opcache.preload=[your project path]/config/preload.php and set parameters.container.dumper.inline_factories: true in config/services.yaml
      • opcache.preload_user=www-data
      • opcache.memory_consumption=1M
      • opcache.max_accelerated_files=100000
      • opcache.validate_timestamps=0 (WARNING: this implies that your deployment scripts empty OpCache pools)
    • You dump the autoloader classmap statically in your deployment script (composer dump-autoload --no-dev --classmap-authoritative).
    • You have chmod'ed (755) your upload, cache and logs directories. Use umask if necessary.
    • You deploy via Git exclusively:
      • git fetch --all
      • git rev-parse refs/remotes/origin/master (or any deployment branch)
      • git checkout -f master (or any deployment branch)
    • You have entities updated through deployment. Migrations if you're not alone, straight schema update if you are (see above).
  13. Start profiling your app:
    • Use a free BlackFire environment (limited, if you're not an individual, consider buying a license) and profile your app.
    • Use the Symfony profiler (composer require --dev symfony/profiler-pack) and take a look at:
      • Your queries. You can reduce them to the minimum (between 0 and 1 per page) easily.
      • Use Twig {% cache 'your_key' ttl(600) %}{% endcache %} for anything locally cacheable especially the results of Twig functions that use DB.
      • Otherwise, add caching to your controllers and models:
        • Create a cache pool.
        • Use it by memoizing your actions.
  14. Add expiration headers to anything that simply returns entities for a given HTTP request, give them at least 10 minutes, at best a day or more.
  15. Add validation headers to any complex action that has non-linear behaviour.
  16. Make sure you have resized all user-generated images with LiipImagineBundle (composer require liip/imagine-bundle) and use srcset HTML5 attribute.
  17. Make sure you have optimized all your theme images using TinyPng.
  18. Make sure you have no remaining missing translations (php bin/console debug:translation [your locale]).
  19. Make sure you browser console is absolutely empty, no:
    • CORS alerts (make sure your CORS policy is set)
    • JavaScript errors
    • Bad cookie API usages
    • 404 on files
    • Other browser warnings
    • Obsolete calls / libraries.
  20. Check that your services definitions are OK using php bin/console lint:container.
  21. Unless your website ecosystem doesn't like it, configure your web server to use SameSite / strict cookies.
  22. Define a custom (random) string for the APP_SECRET variable in your DotEnv file, one for each different environement.
  23. Fix your Composer dependencies versions in your composer.json file. Make them use only patch upgrades within Semantic versioning.
  24. On production, check that your website displays correctly when using an agressive ad blocker.
  25. Test your application on the most used browsers and platforms. Unless your business rules explicit otherwise:
    • Chrome on Windows (latest 2 major versions)
    • Chrome on MacOS (latest 2 major versions)
    • Chrome on Android (latest 5 major versions)
    • Safari on iOS (latest 5 major versions)
    • Safari on MacOS (latest 2 major versions)
    • Firefox on Windows (latest major version)
    • Firefox on MacOS (latest major version)
    • Firefox on Android (latest major version)
    • Edge on Windows (latest major version)
  26. Test your application on regular screen definitions:
    • < 640px width, portrait and landscape
    • < 768px width, portrait and landscape
    • < 1024px width, portrait and landscape
    • < 1280px width, portrait and landscape
    • < 1920px width, portrait and landscape
    • < 2560px width, landscape
    • > 2560px width (up to 3860px), landscape
  27. Test RTL language if applicable.
  28. Use OpQuast checklists to further investigate potential design/UX flaws.
  29. Make sure your server supports and actually uses Gzip compression.
  30. Configure default cache headers for all assets on your web server, especially if you use a CDN, and test those headers.

10. Dockerize your project

  1. Create a docker-sources directory inside the project root directory. You'll put your Docker Compose files inside.
  2. Create a docker-sources/containers-config directory inside. You'll put your Dockerfiles inside, named according to the container name.
  3. Create a environment-files directory inside the project root directory, and move all your DotEnv files inside.
  4. Make Symfony aware that they moved, modify your composer.json file as follows:
{
    "...": "...",
    "extra": {
        "...": "...",
        "runtime": {
            "dotenv_path": "environment-files/.env"
        }
    }
}
  1. Create at least a global-docker-compose.yml inside docker-sources.
  2. Create at least a [environment-name]-docker-compose.yml inside docker-sources (like dev-docker-compose.yml).
  3. Notify your Docker Compose files that the environment files they should use are inside this directory.
  4. Add a shell script inside the project root to start the project Docker containers fast (a sample one is included in this repository: build-and-run-dev-docker-containers.bat).

The rest will be part of your project choices. ;)

Image taken from free image stock UnSplash / Guillaume Jaillet.

{% endraw %} <-- keep this for Jekyll to fully bypass this documents, because of the Twig tags.