Passed
Push — master ( 9fb939...2059dd )
by Brent
03:13
created

Stitcher::parseAdapters()   A

Complexity

Conditions 4
Paths 4

Size

Total Lines 20
Code Lines 11

Duplication

Lines 0
Ratio 0 %

Importance

Changes 0
Metric Value
cc 4
eloc 11
nc 4
nop 2
dl 0
loc 20
rs 9.2
c 0
b 0
f 0
1
<?php
2
3
namespace Brendt\Stitcher;
4
5
use AsyncInterop\Promise;
6
use Brendt\Stitcher\Adapter\Adapter;
7
use Brendt\Stitcher\Exception\InvalidSiteException;
8
use Brendt\Stitcher\Exception\TemplateNotFoundException;
9
use Brendt\Stitcher\Factory\ParserFactory;
10
use Brendt\Stitcher\Factory\TemplateEngineFactory;
11
use Brendt\Stitcher\Site\Page;
12
use Brendt\Stitcher\Site\Site;
13
use Symfony\Component\Config\FileLocator;
14
use Symfony\Component\DependencyInjection\ContainerBuilder;
15
use Symfony\Component\DependencyInjection\Loader\YamlFileLoader;
16
use Symfony\Component\Filesystem\Filesystem;
17
use Symfony\Component\Finder\Finder;
18
use Symfony\Component\Finder\SplFileInfo;
19
use Symfony\Component\Yaml\Exception\ParseException;
20
use Symfony\Component\Yaml\Yaml;
21
22
/**
23
 * The Stitcher class is the core compiler of every Stitcher application. This class takes care of all routes, pages,
24
 * templates and data, and "stitches" everything together.
25
 *
26
 * The stitching process is done in several steps, with the final result being a fully rendered website in the
27
 * `directories.public` folder.
28
 */
29
class Stitcher
30
{
31
    /**
32
     * @var ContainerBuilder
33
     */
34
    protected static $container;
35
36
    /**
37
     * @var array
38
     */
39
    protected static $configDefaults = [
40
        'directories.src'    => './src',
41
        'directories.public' => './public',
42
        'directories.cache'  => './.cache',
43
        'meta'               => [],
44
        'minify'             => false,
45
        'engines.template'   => 'smarty',
46
        'engines.image'      => 'gd',
47
        'engines.optimizer'  => true,
48
        'engines.async'      => true,
49
        'caches.image'       => true,
50
        'optimizer.options'  => [],
51
    ];
52
53
    /**
54
     * A collection of promises representing Stitcher's state.
55
     *
56
     * @var Promise[]
57
     */
58
    private $promises = [];
59
60
    /**
61
     * @var string
62
     */
63
    private $srcDir;
64
65
    /**
66
     * @var string
67
     */
68
    private $publicDir;
69
70
    /**
71
     * @var string
72
     */
73
    private $templateDir;
74
75
    /**
76
     * @see \Brendt\Stitcher\Stitcher::create()
77
     *
78
     * @param string $srcDir
79
     * @param string $publicDir
80
     * @param string $templateDir
81
     */
82
    private function __construct(?string $srcDir = './src', ?string $publicDir = './public', ?string $templateDir = './src/template') {
83
        $this->srcDir = $srcDir;
84
        $this->publicDir = $publicDir;
85
        $this->templateDir = $templateDir;
86
    }
87
88
    /**
89
     * Static constructor
90
     *
91
     * @param string $configPath
92
     * @param array  $defaultConfig
93
     *
94
     * @return Stitcher
95
     *
96
     */
97
    public static function create(string $configPath = './config.yml', array $defaultConfig = []) : Stitcher {
98
        self::$container = new ContainerBuilder();
99
100
        $configPathParts = explode('/', $configPath);
101
        $configFileName = array_pop($configPathParts);
102
        $configPath = implode('/', $configPathParts) . '/';
103
        $configFiles = Finder::create()->files()->in($configPath)->name($configFileName)->depth(0);
104
        $srcDir = null;
105
        $publicDir = null;
106
        $templateDir = null;
107
108
        /** @var SplFileInfo $configFile */
109
        foreach ($configFiles as $configFile) {
110
            $fileConfig = Yaml::parse($configFile->getContents());
111
112
            $config = array_merge(
113
                self::$configDefaults,
114
                $fileConfig,
115
                Config::flatten($fileConfig),
116
                $defaultConfig
117
            );
118
119
            $config['directories.template'] = $config['directories.template'] ?? $config['directories.src'];
120
121
            foreach ($config as $key => $value) {
122
                self::$container->setParameter($key, $value);
123
            }
124
125
            $srcDir = $config['directories.src'] ?? $srcDir;
126
            $publicDir = $config['directories.public'] ?? $publicDir;
127
            $templateDir = $config['directories.template'] ?? $templateDir;
128
        }
129
130
        $stitcher = new self($srcDir, $publicDir, $templateDir);
131
        self::$container->set('stitcher', $stitcher);
132
133
        $serviceLoader = new YamlFileLoader(self::$container, new FileLocator(__DIR__));
134
        $serviceLoader->load('services.yml');
135
136
        return $stitcher;
137
    }
138
139
    /**
140
     * @param string $id
141
     *
142
     * @return mixed
143
     */
144
    public static function get(string $id) {
145
        return self::$container->get($id);
146
    }
147
148
    /**
149
     * @param string $key
150
     *
151
     * @return mixed
152
     */
153
    public static function getParameter(string $key) {
154
        return self::$container->getParameter($key);
155
    }
156
157
    /**
158
     * The core stitcher function. This function will compile the configured site and return an array of parsed
159
     * data.
160
     *
161
     * Compiling a site is done in the following steps.
162
     *
163
     *      - Load the site configuration @see \Brendt\Stitcher\Stitcher::loadSite()
164
     *      - Load all available templates @see \Brendt\Stitcher\Stitcher::loadTemplates()
165
     *      - Loop over all pages and transform every page with the configured adapters (in any are set) @see
166
     *      \Brendt\Stitcher\Stitcher::parseAdapters()
167
     *      - Loop over all transformed pages and parse the variables which weren't parsed by the page's adapters. @see
168
     *      \Brendt\Stitcher\Stitcher::parseVariables()
169
     *      - Add all variables to the template engine and render the HTML for each page.
170
     *
171
     * This function takes two optional parameters which are used to render pages on the fly when using the
172
     * developer controller. The first one, `routes` will take a string or array of routes which should be rendered,
173
     * instead of all available routes. The second one, `filterValue` is used to provide a filter when the
174
     * CollectionAdapter is used, and only one entry page should be rendered.
175
     *
176
     * @param string|array $routes
177
     * @param string       $filterValue
178
     *
179
     * @return array
180
     * @throws TemplateNotFoundException
181
     *
182
     * @see \Brendt\Stitcher\Stitcher::save()
183
     * @see \Brendt\Stitcher\Controller\DevController::run()
184
     * @see \Brendt\Stitcher\Adapter\CollectionAdapter::transform()
185
     */
186
    public function stitch($routes = [], string $filterValue = null) {
187
        /** @var TemplateEngineFactory $templateEngineFactory */
188
        $templateEngineFactory = self::get('factory.template');
189
        $templateEngine = $templateEngineFactory->getDefault();
190
        $blanket = [];
191
192
        $site = $this->loadSite((array) $routes);
193
        $templates = $this->loadTemplates();
194
195
        foreach ($site as $page) {
196
            $templateIsset = isset($templates[$page->getTemplatePath()]);
197
198
            if (!$templateIsset) {
199
                if ($template = $page->getTemplatePath()) {
200
                    throw new TemplateNotFoundException("Template {$template} not found.");
201
                } else {
202
                    throw new TemplateNotFoundException('No template was set.');
203
                }
204
            }
205
206
            $pages = $this->parseAdapters($page, $filterValue);
207
208
            $pageTemplate = $templates[$page->getTemplatePath()];
209
            foreach ($pages as $entryPage) {
210
                $entryPage = $this->parseVariables($entryPage);
211
212
                // Render each page
213
                $templateEngine->addTemplateVariables($entryPage->getVariables());
214
                $blanket[$entryPage->getId()] = $templateEngine->renderTemplate($pageTemplate);
215
                $templateEngine->clearTemplateVariables();
216
            }
217
        }
218
219
        return $blanket;
220
    }
221
222
    /**
223
     * Load a site from YAML configuration files in the `directories.src`/site directory.
224
     * All YAML files are loaded and parsed into Page objects and added to a Site collection.
225
     *
226
     * @param array $routes
227
     *
228
     * @return Site
229
     * @throws InvalidSiteException
230
     * @see \Brendt\Stitcher\Site\Page
231
     * @see \Brendt\Stitcher\Site\Site
232
     */
233
    public function loadSite(array $routes = []) : Site {
234
        /** @var SplFileInfo[] $files */
235
        $files = Finder::create()->files()->in("{$this->srcDir}/site")->name('*.yml');
236
        $site = new Site();
237
238
        foreach ($files as $file) {
239
            try {
240
                $fileContents = (array) Yaml::parse($file->getContents());
241
            } catch (ParseException $e) {
242
                throw new InvalidSiteException("{$file->getRelativePathname()}: {$e->getMessage()}");
243
            }
244
245
            foreach ($fileContents as $route => $data) {
246
                if (count($routes) && !in_array($route, $routes)) {
247
                    continue;
248
                }
249
250
                $page = new Page($route, $data);
251
                $site->addPage($page);
252
            }
253
        }
254
255
        return $site;
256
    }
257
258
    /**
259
     * Load all templates from either the `directories.template` directory. Depending on the configured template
260
     * engine, set with `engines.template`; .html or .tpl files will be loaded.
261
     *
262
     * @return SplFileInfo[]
263
     */
264
    public function loadTemplates() {
265
        /** @var TemplateEngineFactory $templateEngineFactory */
266
        $templateEngineFactory = self::get('factory.template');
267
        $templateEngine = $templateEngineFactory->getDefault();
268
        $templateExtension = $templateEngine->getTemplateExtension();
269
270
        /** @var SplFileInfo[] $files */
271
        $files = Finder::create()->files()->in($this->templateDir)->name("*.{$templateExtension}");
272
        $templates = [];
273
274
        foreach ($files as $file) {
275
            $id = str_replace(".{$templateExtension}", '', $file->getRelativePathname());
276
            $templates[$id] = $file;
277
        }
278
279
        return $templates;
280
    }
281
282
    /**
283
     * This function takes a page and optional entry id. The page's adapters will be loaded and looped.
284
     * An adapter will transform a page's original configuration and variables to one or more pages.
285
     * An entry id can be provided as a filter. This filter can be used in an adapter to skip rendering unnecessary
286
     * pages. The filter parameter is used to render pages on the fly when using the developer controller.
287
     *
288
     * @param Page   $page
289
     * @param string $entryId
290
     *
291
     * @return Page[]
292
     *
293
     * @see  \Brendt\Stitcher\Adapter\Adapter::transform()
294
     * @see  \Brendt\Stitcher\Controller\DevController::run()
295
     */
296
    public function parseAdapters(Page $page, $entryId = null) {
297
        if (!$page->getAdapters()) {
298
            return [$page->getId() => $page];
299
        }
300
301
        $pages = [$page];
302
303
        foreach ($page->getAdapters() as $type => $adapterConfig) {
304
            /** @var Adapter $adapter */
305
            $adapter = self::get("adapter.{$type}");
306
307
            if ($entryId !== null) {
308
                $pages = $adapter->transform($pages, $entryId);
309
            } else {
310
                $pages = $adapter->transform($pages);
311
            }
312
        }
313
314
        return $pages;
315
    }
316
317
    /**
318
     * This function takes a Page object and parse its variables using a Parser. It will only parse variables which
319
     * weren't parsed already by an adapter.
320
     *
321
     * @param Page $page
322
     *
323
     * @return Page
324
     *
325
     * @see \Brendt\Stitcher\Factory\ParserFactory
326
     * @see \Brendt\Stitcher\Parser\Parser
327
     * @see \Brendt\Stitcher\Site\Page::isParsedVariable()
328
     */
329
    public function parseVariables(Page $page) {
330
        foreach ($page->getVariables() as $name => $value) {
331
            if ($page->isParsedVariable($name)) {
332
                continue;
333
            }
334
335
            $page
336
                ->setVariableValue($name, $this->getData($value))
337
                ->setVariableIsParsed($name);
338
        }
339
340
        return $page;
341
    }
342
343
    /**
344
     * This function will save a stitched output to HTML files in the `directories.public` directory.
345
     *
346
     * @param array $blanket
347
     *
348
     * @see \Brendt\Stitcher\Stitcher::stitch()
349
     */
350
    public function save(array $blanket) {
351
        $fs = new Filesystem();
352
353
        foreach ($blanket as $path => $page) {
354
            if ($path === '/') {
355
                $path = 'index';
356
            }
357
358
            $fs->dumpFile($this->publicDir . "/{$path}.html", $page);
359
        }
360
    }
361
362
    /**
363
     * This function will get the parser based on the value. This value is parsed by the parser, or returned if no
364
     * suitable parser was found.
365
     *
366
     * @param $value
367
     *
368
     * @return mixed
369
     *
370
     * @see \Brendt\Stitcher\Factory\ParserFactory
371
     */
372
    private function getData($value) {
373
        /** @var ParserFactory $parserFactory */
374
        $parserFactory = self::get('factory.parser');
375
        $parser = $parserFactory->getByFileName($value);
376
377
        if (!$parser) {
378
            return $value;
379
        }
380
381
        return $parser->parse($value);
382
    }
383
384
    /**
385
     * @param Promise|null $promise
386
     *
387
     * @return Stitcher
388
     */
389
    public function addPromise(?Promise $promise) : Stitcher {
390
        if ($promise) {
391
            $this->promises[] = $promise;
392
        }
393
394
        return $this;
395
    }
396
397
    /**
398
     * @return Promise
399
     */
400
    public function getPromise() : Promise {
401
        return \Amp\all($this->promises);
0 ignored issues
show
Documentation introduced by
$this->promises is of type array<integer,object<AsyncInterop\Promise>>, but the function expects a array<integer,object<Promise>>.

It seems like the type of the argument is not accepted by the function/method which you are calling.

In some cases, in particular if PHP’s automatic type-juggling kicks in this might be fine. In other cases, however this might be a bug.

We suggest to add an explicit type cast like in the following example:

function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
Loading history...
402
    }
403
404
    /**
405
     * @param callable $callback
406
     */
407
    public function done(callable $callback) {
408
        $donePromise = $this->getPromise();
409
410
        $donePromise->when($callback);
411
    }
412
413
}
414
415
416