Konfigurujeme Symfony pomocí YAMLu

YAML umožňuje přehlednou a jednoduchou konfiguraci Symfony. Framework poskytuje možnost nastavení i v jiných formátech (PHP, XML) nebo anotacemi v kódu. Jak jednoduše a efektivně YAML využít se dozvíte v tomto článku.

Seriál: Symfony po krůčkách (18 dílů)

  1. Symfony po krůčkách – Event Dispatcher 30.11.2015
  2. Symfony Console jako první rande se Symfony 7.12.2015
  3. Symfony po krůčkách – Filesystem a Finder 14.12.2015
  4. Symfony po krůčkách – Paralýza možností? OptionsResolver tě zachrání 21.12.2015
  5. Symfony po krůčkách – spouštíme procesy 4.1.2016
  6. Symfony po krůčkách – Translation – překlady jednoduše 11.1.2016
  7. Symfony po krůčkách – Validator (1) 18.1.2016
  8. Symfony po krůčkách – Validator (2) 25.1.2016
  9. Symfony po krůčkách – Routing 1.2.2016
  10. Symfony po krůčkách – MicroKernel 9.2.2016
  11. Konfigurujeme Symfony pomocí YAMLu 16.2.2016
  12. Symfony po krůčkách – oblékáme MicroKernel 23.2.2016
  13. Symfony po krůčkách – ClassLoader 29.2.2016
  14. Symfony po krůčkách – Twig 8.3.2016
  15. Symfony po krůčkách – Twig II. 15.3.2016
  16. Symfony po krůčkách – DomCrawler a CssSelector 23.3.2016
  17. Symfony po krůčkách – HTTP fundamentalista 12.4.2016
  18. Symfony po krůčkách – ušli jsme pořádný kus 19.4.2016

Co YAML vlastně je a k čemu slouží?

Zkratka YAML vznikla z věty Ain’t Markup Language. Už sám název napovídá, že se nejedná o značkovací jazyk. Dle oficiální dokumentace jde o lidsky přívětivý standard k serializaci dat pro všechny programovací jazyky.

V zápisu nehledejte žádné složitosti

Pro jednoduché datové typy (string, boolean, float nebo integer) má stejnou syntaxi jako PHP. Na rozdíl od PHP rozlišuje pole na sekvence – v PHP indexované pole [‘pdo_pgsql’] a hash v PHP asociativní pole [‘driver‘ => ‘pdo_pgsql’].

YAML syntaxe v kostce

Ukážeme si několik příkladů, které v konfiguraci využijeme nejčastěji. Více se dočtete v oficiální dokumentaci.

Řetězce

Přestože YAML umožňuje více způsobů pro zápis řetězců, doporučuji stringy uvádět do uvozovek. Symfony 3 totiž jiný formát nerespektuje.

Čísla

Se zapisují identicky s PHP.

  • Integer: 319
  • Float: 31.9
  • Hexadecimální: 0x13f

NULL

Akceptovány jsou hodnoty null nebo ~.

Boolean

Stejně, jak jsme zvyklí Z PHP zapisujeme true/false.

Kolekce

YAML rozlišuje dva druhy – sekvence a hash (mapování).

  • Sekvence (PHP indexované pole)

YAML zápis

- "XML"
- "PHP"
- "YML"

PHP ekvivalent

['XML', 'PHP', 'YML']
  • Hash (PHP asociativní pole) lze uvést dvěma způsoby

YAML zápis

database: 
    host: "localhost"
    username: "roxtri"
    password: "yamlConfig"

nebo

{database: {host: "localhost", username: "roxtri", password: "yamlConfig"}}

PHP ekvivalent

[
    'database' => [
        'host' => 'localhost',
        'username' => 'roxtri',
        'password' => 'yamlConfig'
    ]
];

Ovšem, pozor na tento způsob zápisu!

YAML syntaxe

database: [ host: "localhost", username: "roxtri", password: "yamlConfig" ]

PHP ekvivalent

[
    'database' =>
    [
        0 => ['host' =>'localhost'],
        1 => ['username' =>'roxtri'],
        2 => ['password' =>'yamlConfig']
    ]
];

YAML Component

K převodu YAML na PHP pole a samozřejmě také reverzní konverzi Symfony poskytuje komponentu YAML. Respektuje specifikaci verze YAML 1.2. Podívejme se, jak je její použití jednoduché.

K instalaci můžeme využít Composer

composer require symfony/yaml

Pro konverzi YAML na PHP pole souží Parser

// index.php
require_once __DIR__ . '/vendor/autoload.php';

$yaml = new Symfony\Component\Yaml\Parser();
$phpArray = $yaml->parse(file_get_contents('/path/to/file.yml'));
// /path/to/file.yml
locales: ["cs", "en"]
default_format: "json"
log_history: true
price: 2000

PHP výstup

[
    'locales' =>
    [
        0 => 'cs',
        1 => 'en'
    ],
    'default_format' => 'json',
    'log_history' => true,
    'price' => 2000
];

Jak načítání konfigurace funguje?

Nejprve dojde k nalezení zdrojů pomocí třídy FileLocator, poté k načtení příslušným loaderem. Symfony poskytuje pro tyto účely komponentu Config. Ta umožňuje nalezení, načtení, slučování, automatického vyplňování a ověřování konfigurační hodnoty jakéhokoliv druhu, bez ohledu na jejich zdroj (YAML, XML, INI soubory, nebo například databáze).

Lokalizace zdrojů

Načítání konfigurace začíná hledáním zdrojů. K tomuto účelu slouží třída FileLocator, která v konstruktoru přijímá cestu nebo pole cest k adresářům, kde jsou konfigurační soubory umístěny. Na locatoru zavoláme metodu locate, kdy první argument je název souboru, druhý nepovinný udává cestu, kde bude soubor hledán jako první, třetí určuje, zda se vrátí hodnoty z prvního nalezeného souboru nebo pole všech nalezených.

Podívejme se na jednoduchou ukázku

K instalaci opět použijeme Composer

composer require symfony/yaml
// index.php
require_once __DIR__'./vendor/autoload.php';

$locator = new Symfony\Component\Config\FileLocator(__DIR__.'/app/config');
$yamlUserFiles = $locator->locate('config.yml');

Načítání konfigurace

Pro každý typ zdroje (YAML, XML…) musí být definován loader (implementující LoaderInterface, potomek abstraktní třídy FileLoader) umožňující rekurzivní načítání dalších zdrojů.

V každém konfiguračním YAML souboru můžeme implementovat sekci imports. Ta slouží k načítání dalších konfiguračních souborů:

// config.yml
imports:
  - { resource: parameters.yml }
  - { resource: security.yml }

Konfigurace routování

Specifikuje mapování URL k příslušnému controlleru. Nejčastěji využijeme soubor v cestě app/config/routing.yml, ale v config.yml lze lokalizaci libovolně upravit.

# app/config/config.yml
framework:
    # ...
    router: { resource: "%kernel.root_dir%/config/routing.yml" }

PHP zápis

[
    'framework' => [
        'router' => [
            'resource' => '%kernel.root_dir%/config/routing.yml'
        ]
    ]
];

Zase o krok dál

Číst i psát konfigurační soubory v YAMLu již zvládáme levou zadní. Narazíte-li na nastavení, která jste se v článku nedočetli, jistě odpověď naleznete v oficiální dokumentaci Symfony či samotného Yamlu. Tento formát pro svou jednoduchost a přehlednost je dobrý v podstatě pro všechna nastavení: překladů, rout, služeb i definování parametrůZpůsob konfigurace Symfony je velmi propracovaný, věnuje se mu komponenta Config.

Programátorská víla z jižních Čech. V současnosti pracuji na pozici programáor/analytik ve Waldviertler Sparkasse BANK AG. Nejčastěji si hraji se Symfony, Nette, Doctrine, Codeception. Mám ráda přehledný a dobře čitelný kód. Mimo computer science jsem ráda v přírodě.

Věděli jste, že nám můžete zasílat zprávičky? (Jen pro přihlášené.)

Komentáře: 4

Přehled komentářů

Slavomir Konfigurace Symfony v XML.
Nikol Ježková Re: Konfigurace Symfony v XML.
Lukáš Brzák Super
Nikol Ježková Re: Super
Zdroj: https://www.zdrojak.cz/?p=17399