├── .gitignore
├── .runway-config.json
├── .vscode
    └── settings.json
├── LICENSE
├── README.md
├── app
    ├── config
    │   ├── config.php
    │   ├── log_handlers.php
    │   └── routes.php
    ├── logger.php
    └── resources
    │   ├── scripts
    │       └── index.ts
    │   ├── scss
    │       ├── main.scss
    │       ├── modules
    │       │   └── _all.scss
    │       ├── partials
    │       │   ├── _base.scss
    │       │   └── _hello.scss
    │       └── vendor
    │       │   ├── .gitkeep
    │       │   └── _bootstrap.scss
    │   └── views
    │       ├── 404.latte
    │       ├── 404.twig
    │       ├── index.latte
    │       ├── index.twig
    │       ├── layout.latte
    │       └── layout.twig
├── bin
    └── .gitkeep
├── composer.json
├── package-lock.json
├── package.json
├── phpcs.xml
├── public
    ├── .htaccess
    ├── crossdomain.xml
    ├── favicon.ico
    ├── index.php
    ├── resources
    │   └── img
    │   │   └── .gitignore
    └── robots.txt
├── runway
├── src
    └── Acme
    │   └── Demo
    │       ├── Commands
    │           ├── .gitkeep
    │           └── ExampleCommand.php
    │       ├── Controllers
    │           ├── API.php
    │           └── Demo.php
    │       ├── Exception
    │           └── .gitkeep
    │       ├── Model
    │           └── .gitkeep
    │       ├── Test
    │           └── .gitkeep
    │       ├── Trait
    │           └── .gitkeep
    │       └── Util
    │           └── .gitkeep
├── tsconfig.json
├── var
    ├── cache
    │   └── .gitkeep
    └── logs
    │   └── .gitkeep
└── webpack.config.js


/.gitignore:
--------------------------------------------------------------------------------
1 | /vendor/
2 | composer.lock
3 | node_modules
4 | public/resources/compiled
5 | var/cache
6 | var/logs
7 | dist/


--------------------------------------------------------------------------------
/.runway-config.json:
--------------------------------------------------------------------------------
1 | {
2 |   "index_root": "public/index.php",
3 |   "app_root": "src/Acme/Demo/",
4 |   "root_paths": ["."]
5 | }
6 | 


--------------------------------------------------------------------------------
/.vscode/settings.json:
--------------------------------------------------------------------------------
1 | {
2 |     "editor.tabSize": 4,
3 |     "phpcs.ignorePatterns": [
4 |         "vendor/"
5 |     ]
6 | }


--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
 1 | MIT License
 2 | 
 3 | Copyright (c) 2013 Daniel Melzer <daniel@melzer.ws>
 4 | Copyright (c) 2017 Mark Hughes <m@rkhugh.es>
 5 | 
 6 | Permission is hereby granted, free of charge, to any person obtaining a copy
 7 | of this software and associated documentation files (the "Software"), to deal
 8 | in the Software without restriction, including without limitation the rights
 9 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 | copies of the Software, and to permit persons to whom the Software is
11 | furnished to do so, subject to the following conditions:
12 | 
13 | The above copyright notice and this permission notice shall be included in
14 | all copies or substantial portions of the Software.
15 | 
16 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
22 | THE SOFTWARE.
23 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | # Flight Skeleton
 2 | 
 3 | This skeleton provides a quick start for the development of an application with the [Flight](http://flightphp.com) PHP microframework. The
 4 | goal here is to get going as fast as possible.
 5 | 
 6 | It also adds support for Runway (CLI), Sass, Twig or Latte, and even TypeScript (it also includes Volta for npm version managing)!
 7 | 
 8 | ## Downloading the skeleton
 9 | 
10 | First, check that you have installed and configured a web server (such as Nginx) with PHP 8 or higher.
11 | 
12 | You can either use this [template on github](https://github.com/markhughes/flight-skeleton/generate), or use git to clone this repo:
13 | 
14 | `$ git clone https://github.com/markhughes/flight-skeleton.git my-app-name`
15 | 
16 | ## Creating the application
17 | 
18 | If you want to define global constants or other settings, you can use the `config.php` in `app/config/`.
19 | 
20 | ### Routing
21 | 
22 | To define your routes, use the file `app/config/routes.php`:
23 | 
24 | ```php
25 | <?php
26 | 
27 | Flight::route("/", ["\Acme\Demo\Controllers\Demo", "index"]);
28 | ```
29 | 
30 | An example API router has been created in `src/Acme/Demo/Controllers/API.php` where `Flight::json` is used to send the response back.
31 | 
32 | ### Controllers
33 | 
34 | Place your code in the `src` folder. All classes from here are autoloaded by their namespace. For an example, have a look in the demo code in `src/Acme/demo/Controllers/Demo.php`. As you can see, the controller uses the namespace `Acme\Demo\Controllers`.
35 | 
36 | ### Templates
37 | 
38 | Twig and Latte templates are loaded by default from `app/resouces/views/`. You can change this by editing the path set in `FLIGHT_SET_VARS` from the `app/config/config.php` file.
39 | 
40 | You should call `Flight::render("template name", [ ... optional contenxt ... ])` directly, and .twig or .latte is added for you.
41 | 
42 | You can easily change the template engine in `app/config/config.php` and change `TEMPLATE_ENGINE` to either `twig` or `latte`
43 | 
44 | ### Logging
45 | 
46 | Your application logs into `var/logs`. Should you want to, you can add more loggers in `app/config/logger_handlers.php`, or completely reconfigure it in
47 | `app/logger.php`.
48 | 
49 | You can then at any time log messages, for example:
50 | 
51 | ```php
52 | $logger->info('hello world!');
53 | ```
54 | 
55 | ### Webpack
56 | 
57 | Compile your scripts using `npm run build` which will throw it all together in `public/dist/main.js` - check the webpack docs on how to use it more effectively. Your entrypoint is located in `app/resources/scripts/index.ts` if you don't want to use TypeScript just rename index.ts to index.js.
58 | 
59 | You can also run `npm run dev` to start webpack in watch mode, great for development.
60 | 
61 | ### Commands
62 | 
63 | Using Runway you can add commands into the application.
64 | 
65 | ```
66 | ./runway example:example-command
67 | ```
68 | 
69 | Will execute the command in src/Acme/Demo/Comands/ExampleCommand.php
70 | 
71 | Runway has a few strict restrictions for commands:
72 | 
73 | 1. They must be in a directory called "commands"
74 | 2. The file name must end in Command.php
75 | 
76 | ## Volta
77 | 
78 | This project uses [Volta](https://volta.sh/) to manage the node and npm version, it is optional to setup but it is a great tool to manage your JavaScript toolchain.
79 | 
80 | # License
81 | 
82 | The skeleton is licensed under the [MIT](https://opensource.org/licenses/MIT) license.
83 | 


--------------------------------------------------------------------------------
/app/config/config.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | // -------------------------------------------------- //
 4 | // APP CONFIG
 5 | // -------------------------------------------------- //
 6 | 
 7 | define("APP_NAME", "my_app");
 8 | define("DEBUG", true);
 9 | define("TEMPLATE_ENGINE", "twig"); // can be twig or latte
10 | 
11 | //... add more here for your app!
12 | 
13 | // -------------------------------------------------- //
14 | // FLIGHT CONFIG
15 | // -------------------------------------------------- //
16 | 
17 | define("FLIGHT_SET_VARS", [
18 |     'flight.views.path' => __DIR__ . "/../resources/views/"
19 | ]);
20 | 
21 | // -------------------------------------------------- //
22 | // TWIG CONFIG
23 | // -------------------------------------------------- //
24 | // Not using Twig? Remove this section! 
25 | 
26 | if (TEMPLATE_ENGINE === "twig") {
27 |     define("TWIG_CONFIG", [
28 |         "cache" => __DIR__ . "/../../var/cache/twig/",
29 |         "debug" => DEBUG,
30 |     ]);
31 | }
32 | 
33 | // -------------------------------------------------- //
34 | // LATTE CONFIG
35 | // -------------------------------------------------- //
36 | // Not using Latte? Remove this section! 
37 | 
38 | if (TEMPLATE_ENGINE === "latte") {
39 |     define("LATTE_CACHE_DIR", __DIR__ . "/../../var/cache/latte/");
40 | }
41 | 


--------------------------------------------------------------------------------
/app/config/log_handlers.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | use Monolog\Logger;
 3 | use Monolog\Handler\StreamHandler;
 4 | use Monolog\Handler\FirePHPHandler;
 5 | 
 6 | function create_log_handlers()
 7 | {
 8 |     return [
 9 |         new StreamHandler(__DIR__ . "/../../var/logs/application.log", Logger::DEBUG),
10 |         new FirePHPHandler(),
11 |     ];
12 | }
13 | 


--------------------------------------------------------------------------------
/app/config/routes.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | // -------------------------------------------------- //
 4 | // ROUTES
 5 | // -------------------------------------------------- //
 6 | 
 7 | Flight::route("/", ["\Acme\Demo\Controllers\Demo", "index"]);
 8 | Flight::route("/api/message", ["\Acme\Demo\Controllers\API", "message"]);
 9 | 
10 | // -------------------------------------------------- //
11 | // MAPPINGS
12 | // -------------------------------------------------- //
13 | 
14 | Flight::map("notFound", fn() => Flight::render("404", []));
15 | 
16 | Flight::map("error", fn(Throwable $exception) => $logger->error($exception));
17 | 


--------------------------------------------------------------------------------
/app/logger.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | // Setup logger
4 | $logger = new \Monolog\Logger(APP_NAME);
5 | foreach (create_log_handlers() as $logHandler) {
6 |     $logger->pushHandler($logHandler);
7 | }
8 | 


--------------------------------------------------------------------------------
/app/resources/scripts/index.ts:
--------------------------------------------------------------------------------
 1 | // Hello! If you don't want typescript, just rename this file to index.js.
 2 | require('bootstrap');
 3 | require('../scss/main.scss')
 4 | 
 5 | console.log('hello world!')
 6 | 
 7 | window.addEventListener('load', async () => {
 8 |     const result = await fetch('/api/message');
 9 |     const data = await result.json();
10 | 
11 |     document.getElementById('api-route-payload').innerText = data.message;
12 | });
13 | 


--------------------------------------------------------------------------------
/app/resources/scss/main.scss:
--------------------------------------------------------------------------------
1 | // Modules and Variables
2 | @import "partials/base";
3 | 
4 | // Vendor sheets
5 | @import "vendor/bootstrap";
6 | 
7 | // Partials
8 | @import "partials/hello"
9 | 


--------------------------------------------------------------------------------
/app/resources/scss/modules/_all.scss:
--------------------------------------------------------------------------------
1 | // Load modules here
2 | 


--------------------------------------------------------------------------------
/app/resources/scss/partials/_base.scss:
--------------------------------------------------------------------------------
1 | // If you don't want compass just remove this next line
2 | //@import "compass";
3 | 
4 | // Variables
5 | $background-colour: #9fa492;
6 | 
7 | // Include our modules
8 | @import "../modules/all";
9 | 


--------------------------------------------------------------------------------
/app/resources/scss/partials/_hello.scss:
--------------------------------------------------------------------------------
1 | // Just a quick example
2 | body {
3 |     background-color: $background-colour;
4 | }
5 | 
6 | .hello {
7 |     font-size: 24px;
8 | }


--------------------------------------------------------------------------------
/app/resources/scss/vendor/.gitkeep:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/markhughes/flight-skeleton/c2d7b9e5a09afb2ac9275290169684aecde6f137/app/resources/scss/vendor/.gitkeep


--------------------------------------------------------------------------------
/app/resources/scss/vendor/_bootstrap.scss:
--------------------------------------------------------------------------------
1 | @import "~bootstrap/scss/bootstrap";
2 | 


--------------------------------------------------------------------------------
/app/resources/views/404.latte:
--------------------------------------------------------------------------------
 1 | <!DOCTYPE html>
 2 | <html lang="en">
 3 |     <head>
 4 |         <meta charset="utf-8">
 5 |         <title>Page Not Found :(</title>
 6 |         <style>
 7 |             ::-moz-selection {
 8 |                 background: #b3d4fc;
 9 |                 text-shadow: none;
10 |             }
11 | 
12 |             ::selection {
13 |                 background: #b3d4fc;
14 |                 text-shadow: none;
15 |             }
16 | 
17 |             html {
18 |                 padding: 30px 10px;
19 |                 font-size: 20px;
20 |                 line-height: 1.4;
21 |                 color: #737373;
22 |                 background: #9fa492;
23 |                 -webkit-text-size-adjust: 100%;
24 |                 -ms-text-size-adjust: 100%;
25 |             }
26 | 
27 |             html,
28 |             input {
29 |                 font-family: system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", "Noto Sans", "Liberation Sans", Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";
30 |             }
31 | 
32 |             body {
33 |                 max-width: 500px;
34 |                 _width: 500px;
35 |                 padding: 30px 20px 50px;
36 |                 border: 1px solid #b3b3b3;
37 |                 border-radius: 4px;
38 |                 margin: 0 auto;
39 |                 box-shadow: 0 1px 10px #a7a7a7, inset 0 1px 0 #fff;
40 |                 background: #fcfcfc;
41 |             }
42 | 
43 |             h1 {
44 |                 margin: 0 10px;
45 |                 font-size: 50px;
46 |                 text-align: center;
47 |             }
48 | 
49 |             h1 span {
50 |                 color: #bbb;
51 |             }
52 | 
53 |             h3 {
54 |                 margin: 1.5em 0 0.5em;
55 |             }
56 | 
57 |             p {
58 |                 margin: 1em 0;
59 |             }
60 | 
61 |             ul {
62 |                 padding: 0 0 0 40px;
63 |                 margin: 1em 0;
64 |             }
65 | 
66 |             .container {
67 |                 max-width: 380px;
68 |                 _width: 380px;
69 |                 margin: 0 auto;
70 |             }
71 | 
72 |             input::-moz-focus-inner {
73 |                 padding: 0;
74 |                 border: 0;
75 |             }
76 |         </style>
77 |     </head>
78 |     <body>
79 |         <div class="container">
80 |             <h1>Not found <span>:(</span></h1>
81 |             <p>Sorry, but the page you were trying to view does not exist.</p>
82 |         </div>
83 |     </body>
84 | </html>


--------------------------------------------------------------------------------
/app/resources/views/404.twig:
--------------------------------------------------------------------------------
 1 | <!DOCTYPE html>
 2 | <html lang="en">
 3 |     <head>
 4 |         <meta charset="utf-8">
 5 |         <title>Page Not Found :(</title>
 6 |         <style>
 7 |             ::-moz-selection {
 8 |                 background: #b3d4fc;
 9 |                 text-shadow: none;
10 |             }
11 | 
12 |             ::selection {
13 |                 background: #b3d4fc;
14 |                 text-shadow: none;
15 |             }
16 | 
17 |             html {
18 |                 padding: 30px 10px;
19 |                 font-size: 20px;
20 |                 line-height: 1.4;
21 |                 color: #737373;
22 |                 background: #9fa492;
23 |                 -webkit-text-size-adjust: 100%;
24 |                 -ms-text-size-adjust: 100%;
25 |             }
26 | 
27 |             html,
28 |             input {
29 |                 font-family: system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", "Noto Sans", "Liberation Sans", Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";
30 |             }
31 | 
32 |             body {
33 |                 max-width: 500px;
34 |                 _width: 500px;
35 |                 padding: 30px 20px 50px;
36 |                 border: 1px solid #b3b3b3;
37 |                 border-radius: 4px;
38 |                 margin: 0 auto;
39 |                 box-shadow: 0 1px 10px #a7a7a7, inset 0 1px 0 #fff;
40 |                 background: #fcfcfc;
41 |             }
42 | 
43 |             h1 {
44 |                 margin: 0 10px;
45 |                 font-size: 50px;
46 |                 text-align: center;
47 |             }
48 | 
49 |             h1 span {
50 |                 color: #bbb;
51 |             }
52 | 
53 |             h3 {
54 |                 margin: 1.5em 0 0.5em;
55 |             }
56 | 
57 |             p {
58 |                 margin: 1em 0;
59 |             }
60 | 
61 |             ul {
62 |                 padding: 0 0 0 40px;
63 |                 margin: 1em 0;
64 |             }
65 | 
66 |             .container {
67 |                 max-width: 380px;
68 |                 _width: 380px;
69 |                 margin: 0 auto;
70 |             }
71 | 
72 |             input::-moz-focus-inner {
73 |                 padding: 0;
74 |                 border: 0;
75 |             }
76 |         </style>
77 |     </head>
78 |     <body>
79 |         <div class="container">
80 |             <h1>Not found <span>:(</span></h1>
81 |             <p>Sorry, but the page you were trying to view does not exist.</p>
82 |         </div>
83 |     </body>
84 | </html>


--------------------------------------------------------------------------------
/app/resources/views/index.latte:
--------------------------------------------------------------------------------
 1 | {layout 'layout.latte'}
 2 | 
 3 | 
 4 | {block content}
 5 | 
 6 | <!-- Add your site or application content here -->
 7 | 
 8 | <main role="main" class="container">
 9 |   <h1 class="mt-5">{$introduction_title}</h1>
10 |   <p>{$introduction_text}</p>
11 |   It comes configured ready to go with:
12 |   <ul>
13 |   <li><a href="https://github.com/mikecao/flight">Flight</a></li>
14 |   <li><a href="https://github.com/twigphp/Twig">Twig</a> or <a href="https://latte.nette.org/">Latte</a> (this is Latte right now!)</li>
15 |   <li><a href="https://github.com/composer/composer">Composer</a></li>
16 |   <li><a href="https://github.com/Seldaek/monolog">Monolog</a></li>
17 |   <li><a href="https://github.com/webpack/webpack">Webpack</a></li>
18 |   <li id="api-route-payload"></li>
19 |   </ul>
20 | 
21 |   <b>and</b> you can even optionally use:
22 |   <ul>
23 |   <li><a href="https://github.com/microsoft/TypeScript">TypeScript</a></li>
24 |   <li><a href="https://github.com/sass/sass">Sass</a></li>
25 |   </ul>
26 | </main>
27 | 
28 | 
29 | {/block}
30 | 


--------------------------------------------------------------------------------
/app/resources/views/index.twig:
--------------------------------------------------------------------------------
 1 | {% extends "layout.twig" %}
 2 | 
 3 | {% block content %}
 4 | 
 5 | <!-- Add your site or application content here -->
 6 | 
 7 | <main role="main" class="container">
 8 |   <h1 class="mt-5">{{ introduction_title }}</h1>
 9 |   <p>{{ introduction_text }}</p>
10 |   It comes configured ready to go with:
11 |   <ul>
12 |   <li><a href="https://github.com/mikecao/flight">Flight</a></li>
13 |   <li><a href="https://github.com/twigphp/Twig">Twig</a> or <a href="https://latte.nette.org/">Latte</a> (this is Twig right now!)</li>
14 |   <li><a href="https://github.com/composer/composer">Composer</a></li>
15 |   <li><a href="https://github.com/Seldaek/monolog">Monolog</a></li>
16 |   <li><a href="https://github.com/webpack/webpack">Webpack</a></li>
17 |   <li id="api-route-payload"></li>
18 |   </ul>
19 | 
20 |   <b>and</b> you can even optionally use:
21 |   <ul>
22 |   <li><a href="https://github.com/microsoft/TypeScript">TypeScript</a></li>
23 |   <li><a href="https://github.com/sass/sass">Sass</a></li>
24 |   </ul>
25 | </main>
26 | 
27 | 
28 | {% endblock %}
29 | 


--------------------------------------------------------------------------------
/app/resources/views/layout.latte:
--------------------------------------------------------------------------------
 1 | <!DOCTYPE html>
 2 | <!--[if lt IE 7]><html class="no-js lt-ie9 lt-ie8 lt-ie7"> <![endif]-->
 3 | <!--[if IE 7]><html class="no-js lt-ie9 lt-ie8"> <![endif]-->
 4 | <!--[if IE 8]><html class="no-js lt-ie9"> <![endif]-->
 5 | <!--[if gt IE 8]><!--><html class="no-js"> <!--<![endif]-->
 6 |     <head>
 7 |         <meta charset="utf-8">
 8 |         <meta http-equiv="X-UA-Compatible" content="IE=edge">
 9 |         <title>Hello world!</title>
10 |         <meta name="description" content="">
11 |         <meta name="viewport" content="width=device-width, initial-scale=1">
12 | 
13 |         <!-- For better performance, move this to the end of your body, but you will see page flicker. -->
14 |         <script src="/dist/main.js"></script>
15 |     </head>
16 | 
17 |     <body>
18 | 
19 |         <!--[if lt IE 7]>
20 |         <p class="browsehappy">You are using an <strong>outdated</strong> browser. Please <a href="http://browsehappy.com/">upgrade your browser</a> to improve your experience.</p>
21 |         <![endif]-->
22 | 
23 |         {block content}{/block}
24 | 
25 |     </body>
26 | </html>
27 | 


--------------------------------------------------------------------------------
/app/resources/views/layout.twig:
--------------------------------------------------------------------------------
 1 | <!DOCTYPE html>
 2 | <!--[if lt IE 7]><html class="no-js lt-ie9 lt-ie8 lt-ie7"> <![endif]-->
 3 | <!--[if IE 7]><html class="no-js lt-ie9 lt-ie8"> <![endif]-->
 4 | <!--[if IE 8]><html class="no-js lt-ie9"> <![endif]-->
 5 | <!--[if gt IE 8]><!--><html class="no-js"> <!--<![endif]-->
 6 |     <head>
 7 |         <meta charset="utf-8">
 8 |         <meta http-equiv="X-UA-Compatible" content="IE=edge">
 9 |         <title>Hello world!</title>
10 |         <meta name="description" content="">
11 |         <meta name="viewport" content="width=device-width, initial-scale=1">
12 | 
13 |         <!-- For better performance, move this to the end of your body, but you will see page flicker. -->
14 |         <script src="/dist/main.js"></script>
15 |     </head>
16 | 
17 |     <body>
18 | 
19 |         <!--[if lt IE 7]>
20 |         <p class="browsehappy">You are using an <strong>outdated</strong> browser. Please <a href="http://browsehappy.com/">upgrade your browser</a> to improve your experience.</p>
21 |         <![endif]-->
22 | 
23 |         {% block content %}{% endblock %}
24 | 
25 |     </body>
26 | </html>
27 | 


--------------------------------------------------------------------------------
/bin/.gitkeep:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/markhughes/flight-skeleton/c2d7b9e5a09afb2ac9275290169684aecde6f137/bin/.gitkeep


--------------------------------------------------------------------------------
/composer.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "name": "markhughes/flight-skeleton",
 3 |   "description": "Skeleton for applications based on the Flight PHP microframework.",
 4 |   "license": "MIT",
 5 |   "version": "1.0.0",
 6 |   "keywords": [
 7 |     "flight",
 8 |     "skeleton"
 9 |   ],
10 |   "authors": [
11 |     {
12 |       "name": "Mark Hughes",
13 |       "email": "m@rkhugh.es",
14 |       "homepage": "https://ma.rkhugh.es"
15 |     },
16 |     {
17 |       "name": "Daniel Melzer",
18 |       "email": "daniel@melzer.ws",
19 |       "homepage": "http://daniel.melzer.ws"
20 |     }
21 |   ],
22 |   "require": {
23 |     "php": ">=8.0",
24 |     "mikecao/flight": "~3.12",
25 |     "monolog/monolog": "^3.7.0",
26 |     "twig/twig": "~3.14",
27 |     "flightphp/runway": "^1.1",
28 |     "latte/latte": "^3.0"
29 |   },
30 |   "autoload": {
31 |     "psr-0": {
32 |       "": "src/"
33 |     }
34 |   }
35 | }
36 | 


--------------------------------------------------------------------------------
/package.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "name": "flight-skeleton",
 3 |     "version": "1.2.0-alt",
 4 |     "description": "This skeleton provides you a quick start for the development of an application with the [Flight](http://flightphp.com) PHP microframework.",
 5 |     "private": "true",
 6 |     "scripts": {
 7 |         "build": "webpack",
 8 |         "dev": "webpack --watch --progress",
 9 |         "test": "echo \"Error: no test specified\" && exit 1"
10 |     },
11 |     "repository": {
12 |         "type": "git",
13 |         "url": "git+https://github.com/markhughes/flight-skeleton.git"
14 |     },
15 |     "author": "",
16 |     "license": "MIT",
17 |     "bugs": {
18 |         "url": "https://github.com/markhughes/flight-skeleton/issues"
19 |     },
20 |     "homepage": "https://github.com/markhughes/flight-skeleton#readme",
21 |     "devDependencies": {
22 |         "autoprefixer": "^10.4.13",
23 |         "css-loader": "^6.7.2",
24 |         "postcss-loader": "^7.2.4",
25 |         "sass": "^1.50.1",
26 |         "sass-loader": "^12.6.0",
27 |         "style-loader": "^3.3.1",
28 |         "ts-loader": "^9.4.1",
29 |         "typescript": "^4.9.3",
30 |         "webpack": "^5.94.0",
31 |         "webpack-cli": "^4.0.0"
32 |     },
33 |     "dependencies": {
34 |         "bootstrap": "^5.2.3",
35 |         "popper.js": "^1.16.1"
36 |     },
37 |     "volta": {
38 |         "node": "18.12.1",
39 |         "npm": "9.1.2"
40 |     }
41 | }
42 | 


--------------------------------------------------------------------------------
/phpcs.xml:
--------------------------------------------------------------------------------
  1 | <?xml version="1.0"?>
  2 | <ruleset xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" name="PSR12" xsi:noNamespaceSchemaLocation="../../../phpcs.xsd">
  3 |     <description>The PSR-12 coding standard.</description>
  4 |     <arg name="tab-width" value="4"/>
  5 | 
  6 |     <!-- 2. General -->
  7 | 
  8 |     <!-- 2.1 Basic Coding Standard -->
  9 | 
 10 |     <!-- Code MUST follow all rules outlined in PSR-1. -->
 11 |     <rule ref="PSR1"/>
 12 | 
 13 |     <!-- The term 'StudlyCaps' in PSR-1 MUST be interpreted as PascalCase where the first letter of each word is capitalized including the very first letter. -->
 14 | 
 15 |     <!-- 2.2 Files -->
 16 | 
 17 |     <!-- All PHP files MUST use the Unix LF (linefeed) line ending only. -->
 18 |     <rule ref="Generic.Files.LineEndings">
 19 |         <properties>
 20 |             <property name="eolChar" value="\n"/>
 21 |         </properties>
 22 |     </rule>
 23 | 
 24 |     <!-- All PHP files MUST end with a non-blank line, terminated with a single LF. -->
 25 |     <rule ref="PSR2.Files.EndFileNewline"/>
 26 | 
 27 |     <!-- The closing ?> tag MUST be omitted from files containing only PHP. -->
 28 |     <rule ref="PSR2.Files.ClosingTag"/>
 29 | 
 30 |     <!-- 2.3 Lines -->
 31 | 
 32 |     <!-- There MUST NOT be a hard limit on line length.
 33 |     The soft limit on line length MUST be 120 characters.
 34 |     Lines SHOULD NOT be longer than 80 characters; lines longer than that SHOULD be split into multiple subsequent lines of no more than 80 characters each. -->
 35 |     <rule ref="Generic.Files.LineLength">
 36 |         <properties>
 37 |             <property name="lineLimit" value="120"/>
 38 |             <property name="absoluteLineLimit" value="0"/>
 39 |         </properties>
 40 |     </rule>
 41 | 
 42 |     <!-- There MUST NOT be trailing whitespace at the end of lines.
 43 |     Blank lines MAY be added to improve readability and to indicate related blocks of code except where explicitly forbidden. -->
 44 |     <rule ref="Squiz.WhiteSpace.SuperfluousWhitespace"/>
 45 |     <rule ref="Squiz.WhiteSpace.SuperfluousWhitespace.StartFile">
 46 |         <severity>0</severity>
 47 |     </rule>
 48 |     <rule ref="Squiz.WhiteSpace.SuperfluousWhitespace.EndFile">
 49 |         <severity>0</severity>
 50 |     </rule>
 51 |     <rule ref="Squiz.WhiteSpace.SuperfluousWhitespace.EmptyLines">
 52 |         <severity>0</severity>
 53 |     </rule>
 54 | 
 55 |     <!-- There MUST NOT be more than one statement per line. -->
 56 |     <rule ref="Generic.Formatting.DisallowMultipleStatements"/>
 57 | 
 58 |     <!-- 2.4 Indenting -->
 59 | 
 60 |     <!-- Code MUST use an indent of 4 spaces for each indent level, and MUST NOT use tabs for indenting. -->
 61 |     <rule ref="Generic.WhiteSpace.ScopeIndent">
 62 |         <properties>
 63 |             <property name="ignoreIndentationTokens" type="array">
 64 |                 <element value="T_COMMENT"/>
 65 |                 <element value="T_DOC_COMMENT_OPEN_TAG"/>
 66 |             </property>
 67 |         </properties>
 68 |     </rule>
 69 |     <rule ref="Generic.WhiteSpace.DisallowTabIndent"/>
 70 | 
 71 |     <!-- 2.5 Keywords and Types -->
 72 | 
 73 |     <!-- All PHP reserved keywords and types [1][2] MUST be in lower case.
 74 |     Any new types and keywords added to future PHP versions MUST be in lower case. -->
 75 |     <rule ref="Generic.PHP.LowerCaseKeyword"/>
 76 |     <rule ref="Generic.PHP.LowerCaseConstant"/>
 77 |     <rule ref="Generic.PHP.LowerCaseType"/>
 78 | 
 79 |     <!-- Short form of type keywords MUST be used i.e. bool instead of boolean, int instead of integer etc. -->
 80 |     <!-- checked by PSR12.Keywords.ShortFormTypeKeywords -->
 81 | 
 82 |     <!-- 3. Declare Statements, Namespace, and Import Statements -->
 83 | 
 84 |     <!-- The header of a PHP file may consist of a number of different blocks. If present, each of the blocks below MUST be separated by a single blank line, and MUST NOT contain a blank line. Each block MUST be in the order listed below, although blocks that are not relevant may be omitted.
 85 | 
 86 |     Opening php tag.
 87 |     File-level docblock.
 88 |     One or more declare statements.
 89 |     The namespace declaration of the file.
 90 |     One or more class-based use import statements.
 91 |     One or more function-based use import statements.
 92 |     One or more constant-based use import statements.
 93 |     The remainder of the code in the file. -->
 94 |     <!-- checked by PSR12.Files.FileHeader -->
 95 | 
 96 |     <!-- When a file contains a mix of HTML and PHP, any of the above sections may still be used. If so, they MUST be present at the top of the file, even if the remainder of the code consists of a closing PHP tag and then a mixture of HTML and PHP. -->
 97 | 
 98 |     <!-- When the opening php tag is on the first line of the file, it MUST be on its own line with no other statements unless it is a file containing markup outside of PHP opening and closing tags. -->
 99 | 
100 |     <!-- Import statements MUST never begin with a leading backslash as they must always be fully qualified. -->
101 |     <!-- checked by PSR12.Files.ImportStatement -->
102 | 
103 |     <!-- Compound namespaces with a depth of more than two MUST NOT be used. -->
104 |     <!-- checked by PSR12.Namespaces.CompoundNamespaceDepth -->
105 | 
106 |     <!-- When wishing to declare strict types in files containing markup outside PHP opening and closing tags, the declaration MUST be on the first line of the file and include an opening PHP tag, the strict types declaration and closing tag. -->
107 |     <!-- Declare statements MUST contain no spaces and MUST be exactly declare(strict_types=1) (with an optional semi-colon terminator). -->
108 |     <!-- Block declare statements are allowed and MUST be formatted as below. -->
109 |     <!-- checked by PSR12.Files.DeclareStatement -->
110 | 
111 |     <!-- 4. Classes, Properties, and Methods -->
112 | 
113 |     <!-- Any closing brace MUST NOT be followed by any comment or statement on the same line. -->
114 |     <!-- checked by PSR12.Classes.ClosingBrace -->
115 | 
116 |     <!-- When instantiating a new class, parentheses MUST always be present even when there are no arguments passed to the constructor. -->
117 |     <!-- checked by PSR12.Classes.ClassInstantiation -->
118 | 
119 |     <!-- 4.1 Extends and Implements -->
120 | 
121 |     <!-- The extends and implements keywords MUST be declared on the same line as the class name. -->
122 |     <!-- The opening brace for the class MUST go on its own line; the closing brace for the class MUST go on the next line after the body. -->
123 |     <!-- Opening braces MUST be on their own line and MUST NOT be preceded or followed by a blank line. -->
124 |     <!-- Closing braces MUST be on their own line and MUST NOT be preceded by a blank line. -->
125 |     <!-- Lists of implements and, in the case of interfaces, extends MAY be split across multiple lines, where each subsequent line is indented once. When doing so, the first item in the list MUST be on the next line, and there MUST be only one interface per line. -->
126 |     <rule ref="PSR2.Classes.ClassDeclaration"/>
127 | 
128 |     <!-- 4.2 Using traits -->
129 | 
130 |     <!-- The use keyword used inside the classes to implement traits MUST be declared on the next line after the opening brace. -->
131 |     <!-- Each individual trait that is imported into a class MUST be included one-per-line and each inclusion MUST have its own use import statement. -->
132 |     <!-- When the class has nothing after the use import statement, the class closing brace MUST be on the next line after the use import statement. Otherwise, it MUST have a blank line after the use import statement. -->
133 |     <!-- When using the insteadof and as operators they must be used as follows taking note of indentation, spacing, and new lines. -->
134 |     <!-- checked by PSR12.Traits.UseDeclaration -->
135 | 
136 |     <!-- 4.3 Properties and Constants -->
137 | 
138 |     <!-- Visibility MUST be declared on all properties. -->
139 |     <!-- The var keyword MUST NOT be used to declare a property. -->
140 |     <!-- There MUST NOT be more than one property declared per statement. -->
141 |     <!-- Property names MUST NOT be prefixed with a single underscore to indicate protected or private visibility.
142 |     That is, an underscore prefix explicitly has no meaning. -->
143 |     <!-- There MUST be a space between type declaration and property name. -->
144 |     <rule ref="PSR2.Classes.PropertyDeclaration"/>
145 | 
146 |     <!-- Visibility MUST be declared on all constants if your project PHP minimum version supports constant visibilities (PHP 7.1 or later). -->
147 |     <!-- checked by PSR12.Properties.ConstantVisibility -->
148 | 
149 |     <!-- 4.4 Methods and Functions -->
150 | 
151 |     <!-- Visibility MUST be declared on all methods. -->
152 |     <rule ref="Squiz.Scope.MethodScope"/>
153 |     <rule ref="Squiz.WhiteSpace.ScopeKeywordSpacing"/>
154 | 
155 |     <!-- Method names MUST NOT be prefixed with a single underscore to indicate protected or private visibility. That is, an underscore prefix explicitly has no meaning. -->
156 |     <rule ref="PSR2.Methods.MethodDeclaration"/>
157 |     <rule ref="PSR2.Methods.MethodDeclaration.Underscore">
158 |         <type>error</type>
159 |         <message>Method name "%s" must not be prefixed with an underscore to indicate visibility</message>
160 |     </rule>
161 | 
162 |     <!-- Method and function names MUST NOT be declared with space after the method name. The opening brace MUST go on its own line, and the closing brace MUST go on the next line following the body. There MUST NOT be a space after the opening parenthesis, and there MUST NOT be a space before the closing parenthesis. -->
163 |     <rule ref="PSR2.Methods.FunctionClosingBrace"/>
164 |     <rule ref="Squiz.Functions.FunctionDeclaration"/>
165 |     <rule ref="Squiz.Functions.LowercaseFunctionKeywords"/>
166 | 
167 |     <!-- 4.5 Method and Function Arguments -->
168 | 
169 |     <!-- In the argument list, there MUST NOT be a space before each comma, and there MUST be one space after each comma. -->
170 |     <!-- When using the reference operator & before an argument, there MUST NOT be a space after it. -->
171 |     <!-- There MUST NOT be a space between the variadic three dot operator and the argument name. -->
172 |     <!-- When combining both the reference operator and the variadic three dot operator, there MUST NOT be any space between the two of them. -->
173 |     <rule ref="Squiz.Functions.FunctionDeclarationArgumentSpacing">
174 |         <properties>
175 |             <property name="equalsSpacing" value="1"/>
176 |         </properties>
177 |     </rule>
178 | 
179 |     <!-- Method and function arguments with default values MUST go at the end of the argument list. -->
180 |     <rule ref="PEAR.Functions.ValidDefaultValue"/>
181 | 
182 |     <!-- Argument lists MAY be split across multiple lines, where each subsequent line is indented once. When doing so, the first item in the list MUST be on the next line, and there MUST be only one argument per line.
183 |     When the argument list is split across multiple lines, the closing parenthesis and opening brace MUST be placed together on their own line with one space between them. -->
184 |     <rule ref="Squiz.Functions.MultiLineFunctionDeclaration"/>
185 | 
186 |     <!-- When you have a return type declaration present, there MUST be one space after the colon followed by the type declaration. The colon and declaration MUST be on the same line as the argument list closing parenthesis with no spaces between the two characters. -->
187 |     <!-- checked by PSR12.Functions.ReturnTypeDeclaration -->
188 | 
189 |     <!-- In nullable type declarations, there MUST NOT be a space between the question mark and the type. -->
190 |     <!-- checked by PSR12.Functions.NullableTypeDeclaration -->
191 | 
192 |     <!-- 4.6 abstract, final, and static -->
193 | 
194 |     <!-- When present, the abstract and final declarations MUST precede the visibility declaration. -->
195 |     <!-- When present, the static declaration MUST come after the visibility declaration. -->
196 |     <!-- checked by PSR2.Methods.MethodDeclaration included above -->
197 | 
198 |     <!-- 4.7 Method and Function Calls -->
199 | 
200 |     <!-- When making a method or function call, there MUST NOT be a space between the method or function name and the opening parenthesis, there MUST NOT be a space after the opening parenthesis, and there MUST NOT be a space before the closing parenthesis. In the argument list, there MUST NOT be a space before each comma, and there MUST be one space after each comma. -->
201 |     <!-- Argument lists MAY be split across multiple lines, where each subsequent line is indented once. When doing so, the first item in the list MUST be on the next line, and there MUST be only one argument per line. A single argument being split across multiple lines (as might be the case with an anonymous function or array) does not constitute splitting the argument list itself. -->
202 |     <rule ref="Generic.Functions.FunctionCallArgumentSpacing"/>
203 |     <rule ref="PSR2.Methods.FunctionCallSignature"/>
204 |     <rule ref="PSR2.Methods.FunctionCallSignature.SpaceAfterCloseBracket">
205 |         <severity>0</severity>
206 |     </rule>
207 |     <rule ref="PSR2.Methods.FunctionCallSignature.OpeningIndent">
208 |         <severity>0</severity>
209 |     </rule>
210 | 
211 |     <!-- 5. Control Structures -->
212 | 
213 |     <!-- The general style rules for control structures are as follows:
214 |     There MUST be one space after the control structure keyword
215 |     There MUST NOT be a space after the opening parenthesis
216 |     There MUST NOT be a space before the closing parenthesis
217 |     There MUST be one space between the closing parenthesis and the opening brace
218 |     The structure body MUST be indented once
219 |     The body MUST be on the next line after the opening brace
220 |     The closing brace MUST be on the next line after the body
221 |     The body of each structure MUST be enclosed by braces. This standardizes how the structures look and reduces the likelihood of introducing errors as new lines get added to the body. -->
222 |     <rule ref="Squiz.ControlStructures.ControlSignature"/>
223 |     <rule ref="Squiz.WhiteSpace.ControlStructureSpacing.SpacingAfterOpen"/>
224 |     <rule ref="Squiz.WhiteSpace.ControlStructureSpacing.SpacingBeforeClose"/>
225 |     <rule ref="Squiz.WhiteSpace.ScopeClosingBrace"/>
226 |     <rule ref="Squiz.ControlStructures.ForEachLoopDeclaration"/>
227 |     <rule ref="Squiz.ControlStructures.ForLoopDeclaration">
228 |         <properties>
229 |             <property name="ignoreNewlines" value="true"/>
230 |         </properties>
231 |     </rule>
232 |     <rule ref="Squiz.ControlStructures.ForLoopDeclaration.SpacingAfterOpen">
233 |         <severity>0</severity>
234 |     </rule>
235 |     <rule ref="Squiz.ControlStructures.ForLoopDeclaration.SpacingBeforeClose">
236 |         <severity>0</severity>
237 |     </rule>
238 |     <rule ref="Squiz.ControlStructures.LowercaseDeclaration"/>
239 |     <rule ref="Generic.ControlStructures.InlineControlStructure"/>
240 | 
241 |     <!-- exclude this message as it is already checked in Generic.PHP.LowerCaseKeyword -->
242 |     <rule ref="Squiz.ControlStructures.ForEachLoopDeclaration.AsNotLower">
243 |         <severity>0</severity>
244 |     </rule>
245 | 
246 |     <!-- 5.1 if, elseif, else -->
247 | 
248 |     <!-- else and elseif are on the same line as the closing brace from the earlier body. -->
249 |     <!-- checked by Squiz.ControlStructures.ControlSignature included above -->
250 | 
251 |     <!-- The keyword elseif SHOULD be used instead of else if so that all control keywords look like single words. -->
252 |     <rule ref="PSR2.ControlStructures.ElseIfDeclaration"/>
253 | 
254 |     <!-- Expressions in parentheses MAY be split across multiple lines, where each subsequent line is indented at least once. When doing so, the first condition MUST be on the next line. The closing parenthesis and opening brace MUST be placed together on their own line with one space between them. Boolean operators between conditions MUST always be at the beginning or at the end of the line, not a mix of both. -->
255 |     <!-- checked by PSR12.ControlStructures.ControlStructureSpacing -->
256 |     <!-- checked by PSR12.ControlStructures.BooleanOperatorPlacement -->
257 |     <!-- checked by Squiz.ControlStructures.ControlSignature -->
258 | 
259 |     <!-- 5.2 switch, case -->
260 | 
261 |     <!-- The case statement MUST be indented once from switch, and the break keyword (or other terminating keywords) MUST be indented at the same level as the case body. There MUST be a comment such as // no break when fall-through is intentional in a non-empty case body. -->
262 |     <rule ref="PSR2.ControlStructures.SwitchDeclaration"/>
263 | 
264 |     <!-- Expressions in parentheses MAY be split across multiple lines, where each subsequent line is indented at least once. When doing so, the first condition MUST be on the next line. The closing parenthesis and opening brace MUST be placed together on their own line with one space between them. Boolean operators between conditions MUST always be at the beginning or at the end of the line, not a mix of both. -->
265 |     <!-- checked by PSR12.ControlStructures.ControlStructureSpacing -->
266 |     <!-- checked by PSR12.ControlStructures.BooleanOperatorPlacement -->
267 |     <!-- checked by Squiz.ControlStructures.ControlSignature -->
268 | 
269 |     <!-- 5.3.1 while -->
270 | 
271 |     <!-- Expressions in parentheses MAY be split across multiple lines, where each subsequent line is indented at least once. When doing so, the first condition MUST be on the next line. The closing parenthesis and opening brace MUST be placed together on their own line with one space between them. Boolean operators between conditions MUST always be at the beginning or at the end of the line, not a mix of both. -->
272 |     <!-- checked by PSR12.ControlStructures.ControlStructureSpacing -->
273 |     <!-- checked by PSR12.ControlStructures.BooleanOperatorPlacement -->
274 |     <!-- checked by Squiz.ControlStructures.ControlSignature -->
275 | 
276 |     <!-- 5.3.2 do while -->
277 | 
278 |     <!-- Expressions in parentheses MAY be split across multiple lines, where each subsequent line is indented at least once. When doing so, the first condition MUST be on the next line. Boolean operators between conditions MUST always be at the beginning or at the end of the line, not a mix of both. -->
279 |     <!-- checked by PSR12.ControlStructures.ControlStructureSpacing -->
280 |     <!-- checked by PSR12.ControlStructures.BooleanOperatorPlacement -->
281 |     <!-- checked by Squiz.ControlStructures.ControlSignature -->
282 | 
283 |     <!-- 5.4 for -->
284 | 
285 |     <!-- Expressions in parentheses MAY be split across multiple lines, where each subsequent line is indented at least once. When doing so, the first expression MUST be on the next line. The closing parenthesis and opening brace MUST be placed together on their own line with one space between them. -->
286 |     <!-- checked by PSR12.ControlStructures.ControlStructureSpacing -->
287 |     <!-- checked by PSR12.ControlStructures.BooleanOperatorPlacement -->
288 |     <!-- checked by Squiz.ControlStructures.ControlSignature -->
289 | 
290 |     <!-- 5.5 foreach -->
291 | 
292 |     <!-- exclude these messages as they are already checked by PSR2.ControlStructures.ControlStructureSpacing -->
293 |     <rule ref="Squiz.ControlStructures.ForEachLoopDeclaration.SpaceAfterOpen">
294 |         <severity>0</severity>
295 |     </rule>
296 |     <rule ref="Squiz.ControlStructures.ForEachLoopDeclaration.SpaceBeforeClose">
297 |         <severity>0</severity>
298 |     </rule>
299 | 
300 |     <!-- 5.6 try, catch, finally -->
301 | 
302 |     <!-- 6. Operators -->
303 | 
304 |     <!-- When space is permitted around an operator, multiple spaces MAY be used for readability purposes. -->
305 |     <!-- All operators not described here are left undefined. -->
306 | 
307 |     <!-- 6.1. Unary operators -->
308 | 
309 |     <!-- The increment/decrement operators MUST NOT have any space between the operator and operand. -->
310 |     <rule ref="Generic.WhiteSpace.IncrementDecrementSpacing"/>
311 | 
312 |     <!-- Type casting operators MUST NOT have any space within the parentheses. -->
313 |     <rule ref="Squiz.WhiteSpace.CastSpacing"/>
314 | 
315 |     <!-- 6.2. Binary operators -->
316 | 
317 |     <!-- All binary arithmetic, comparison, assignment, bitwise, logical, string, and type operators MUST be preceded and followed by at least one space. -->
318 |     <!-- checked by PSR12.Operators.OperatorSpacing -->
319 | 
320 |     <!-- 6.3. Ternary operators -->
321 | 
322 |     <!-- The conditional operator, also known simply as the ternary operator, MUST be preceded and followed by at least one space around both the ? and : characters. -->
323 |     <!-- When the middle operand of the conditional operator is omitted, the operator MUST follow the same style rules as other binary comparison operators. -->
324 |     <!-- checked by PSR12.Operators.OperatorSpacing -->
325 | 
326 |     <!-- 7. Closures -->
327 | 
328 |     <!-- Closures MUST be declared with a space after the function keyword, and a space before and after the use keyword. -->
329 |     <!-- The opening brace MUST go on the same line, and the closing brace MUST go on the next line following the body. -->
330 |     <!-- There MUST NOT be a space after the opening parenthesis of the argument list or variable list, and there MUST NOT be a space before the closing parenthesis of the argument list or variable list. -->
331 |     <!-- In the argument list and variable list, there MUST NOT be a space before each comma, and there MUST be one space after each comma. -->
332 |     <!-- Closure arguments with default values MUST go at the end of the argument list. -->
333 |     <!-- Argument lists and variable lists MAY be split across multiple lines, where each subsequent line is indented once. When doing so, the first item in the list MUST be on the next line, and there MUST be only one argument or variable per line. -->
334 |     <!-- When the ending list (whether of arguments or variables) is split across multiple lines, the closing parenthesis and opening brace MUST be placed together on their own line with one space between them. -->
335 |     <!-- checked by Squiz.Functions.MultiLineFunctionDeclaration -->
336 | 
337 |     <!-- If a return type is present, it MUST follow the same rules as with normal functions and methods; if the use keyword is present, the colon MUST follow the use list closing parentheses with no spaces between the two characters. -->
338 |     <!-- checked by PSR12.Functions.ReturnTypeDeclaration -->
339 | 
340 |     <!-- 8. Anonymous Classes -->
341 | 
342 |     <!-- Anonymous Classes MUST follow the same guidelines and principles as closures in the above section. -->
343 |     <!-- The opening brace MAY be on the same line as the class keyword so long as the list of implements interfaces does not wrap. If the list of interfaces wraps, the brace MUST be placed on the line immediately following the last interface. -->
344 |     <!-- checked by PSR12.Classes.AnonClassDeclaration -->
345 | 
346 | </ruleset>
347 | 


--------------------------------------------------------------------------------
/public/.htaccess:
--------------------------------------------------------------------------------
  1 | # Flight rewrite rules
  2 | RewriteEngine On
  3 | RewriteCond %{REQUEST_FILENAME} !-f
  4 | RewriteCond %{REQUEST_FILENAME} !-d
  5 | RewriteRule ^(.*)$ index.php [QSA,L]
  6 | 
  7 | # Apache Server Configs v1.1.0 | MIT License
  8 | # https://github.com/h5bp/server-configs-apache
  9 | 
 10 | # (!) Using `.htaccess` files slows down Apache, therefore, if you have access
 11 | # to the main server config file (usually called `httpd.conf`), you should add
 12 | # this logic there: http://httpd.apache.org/docs/current/howto/htaccess.html.
 13 | 
 14 | # ##############################################################################
 15 | # # CROSS-ORIGIN RESOURCE SHARING (CORS)                                       #
 16 | # ##############################################################################
 17 | 
 18 | # ------------------------------------------------------------------------------
 19 | # | Cross-domain AJAX requests                                                 |
 20 | # ------------------------------------------------------------------------------
 21 | 
 22 | # Enable cross-origin AJAX requests.
 23 | # http://code.google.com/p/html5security/wiki/CrossOriginRequestSecurity
 24 | # http://enable-cors.org/
 25 | 
 26 | # <IfModule mod_headers.c>
 27 | #    Header set Access-Control-Allow-Origin "*"
 28 | # </IfModule>
 29 | 
 30 | # ------------------------------------------------------------------------------
 31 | # | CORS-enabled images                                                        |
 32 | # ------------------------------------------------------------------------------
 33 | 
 34 | # Send the CORS header for images when browsers request it.
 35 | # https://developer.mozilla.org/en/CORS_Enabled_Image
 36 | # http://blog.chromium.org/2011/07/using-cross-domain-images-in-webgl-and.html
 37 | # http://hacks.mozilla.org/2011/11/using-cors-to-load-webgl-textures-from-cross-domain-images/
 38 | 
 39 | <IfModule mod_setenvif.c>
 40 |     <IfModule mod_headers.c>
 41 |         <FilesMatch "\.(gif|ico|jpe?g|png|svgz?|webp)$">
 42 |             SetEnvIf Origin ":" IS_CORS
 43 |             Header set Access-Control-Allow-Origin "*" env=IS_CORS
 44 |         </FilesMatch>
 45 |     </IfModule>
 46 | </IfModule>
 47 | 
 48 | # ------------------------------------------------------------------------------
 49 | # | Web fonts access                                                           |
 50 | # ------------------------------------------------------------------------------
 51 | 
 52 | # Allow access from all domains for web fonts
 53 | 
 54 | <IfModule mod_headers.c>
 55 |     <FilesMatch "\.(eot|font.css|otf|ttc|ttf|woff)$">
 56 |         Header set Access-Control-Allow-Origin "*"
 57 |     </FilesMatch>
 58 | </IfModule>
 59 | 
 60 | 
 61 | # ##############################################################################
 62 | # # ERRORS                                                                     #
 63 | # ##############################################################################
 64 | 
 65 | # ------------------------------------------------------------------------------
 66 | # | 404 error prevention for non-existing redirected folders                   |
 67 | # ------------------------------------------------------------------------------
 68 | 
 69 | # Prevent Apache from returning a 404 error for a rewrite if a directory
 70 | # with the same name does not exist.
 71 | # http://httpd.apache.org/docs/current/content-negotiation.html#multiviews
 72 | # http://www.webmasterworld.com/apache/3808792.htm
 73 | 
 74 | Options -MultiViews
 75 | 
 76 | # ------------------------------------------------------------------------------
 77 | # | Custom error messages / pages                                              |
 78 | # ------------------------------------------------------------------------------
 79 | 
 80 | # You can customize what Apache returns to the client in case of an error (see
 81 | # http://httpd.apache.org/docs/current/mod/core.html#errordocument), e.g.:
 82 | 
 83 | ErrorDocument 404 /404.html
 84 | 
 85 | 
 86 | # ##############################################################################
 87 | # # INTERNET EXPLORER                                                          #
 88 | # ##############################################################################
 89 | 
 90 | # ------------------------------------------------------------------------------
 91 | # | Better website experience                                                  |
 92 | # ------------------------------------------------------------------------------
 93 | 
 94 | # Force IE to render pages in the highest available mode in the various
 95 | # cases when it may not: http://hsivonen.iki.fi/doctype/ie-mode.pdf.
 96 | 
 97 | <IfModule mod_headers.c>
 98 |     Header set X-UA-Compatible "IE=edge"
 99 |     # `mod_headers` can't match based on the content-type, however, we only
100 |     # want to send this header for HTML pages and not for the other resources
101 |     <FilesMatch "\.(appcache|crx|css|eot|gif|htc|ico|jpe?g|js|m4a|m4v|manifest|mp4|oex|oga|ogg|ogv|otf|pdf|png|safariextz|svgz?|ttf|vcf|webapp|webm|webp|woff|xml|xpi)$">
102 |         Header unset X-UA-Compatible
103 |     </FilesMatch>
104 | </IfModule>
105 | 
106 | # ------------------------------------------------------------------------------
107 | # | Cookie setting from iframes                                                |
108 | # ------------------------------------------------------------------------------
109 | 
110 | # Allow cookies to be set from iframes in IE.
111 | 
112 | # <IfModule mod_headers.c>
113 | #   Header set P3P "policyref=\"/w3c/p3p.xml\", CP=\"IDC DSP COR ADM DEVi TAIi PSA PSD IVAi IVDi CONi HIS OUR IND CNT\""
114 | # </IfModule>
115 | 
116 | # ------------------------------------------------------------------------------
117 | # | Screen flicker                                                             |
118 | # ------------------------------------------------------------------------------
119 | 
120 | # Stop screen flicker in IE on CSS rollovers (this only works in
121 | # combination with the `ExpiresByType` directives for images from below).
122 | 
123 | # BrowserMatch "MSIE" brokenvary=1
124 | # BrowserMatch "Mozilla/4.[0-9]{2}" brokenvary=1
125 | # BrowserMatch "Opera" !brokenvary
126 | # SetEnvIf brokenvary 1 force-no-vary
127 | 
128 | 
129 | # ##############################################################################
130 | # # MIME TYPES AND ENCODING                                                    #
131 | # ##############################################################################
132 | 
133 | # ------------------------------------------------------------------------------
134 | # | Proper MIME types for all files                                            |
135 | # ------------------------------------------------------------------------------
136 | 
137 | <IfModule mod_mime.c>
138 | 
139 |   # Audio
140 |     AddType audio/mp4                                   m4a f4a f4b
141 |     AddType audio/ogg                                   oga ogg
142 | 
143 |   # JavaScript
144 |     # Normalize to standard type (it's sniffed in IE anyways):
145 |     # http://tools.ietf.org/html/rfc4329#section-7.2
146 |     AddType application/javascript                      js
147 |     AddType application/json                            json
148 | 
149 |   # Video
150 |     AddType video/mp4                                   mp4 m4v f4v f4p
151 |     AddType video/ogg                                   ogv
152 |     AddType video/webm                                  webm
153 |     AddType video/x-flv                                 flv
154 | 
155 |   # Web fonts
156 |     AddType application/font-woff                       woff
157 |     AddType application/vnd.ms-fontobject               eot
158 | 
159 |     # Browsers usually ignore the font MIME types and sniff the content,
160 |     # however, Chrome shows a warning if other MIME types are used for the
161 |     # following fonts.
162 |     AddType application/x-font-ttf                      ttc ttf
163 |     AddType font/opentype                               otf
164 | 
165 |     # Make SVGZ fonts work on iPad:
166 |     # https://twitter.com/FontSquirrel/status/14855840545
167 |     AddType     image/svg+xml                           svg svgz
168 |     AddEncoding gzip                                    svgz
169 | 
170 |   # Other
171 |     AddType application/octet-stream                    safariextz
172 |     AddType application/x-chrome-extension              crx
173 |     AddType application/x-opera-extension               oex
174 |     AddType application/x-shockwave-flash               swf
175 |     AddType application/x-web-app-manifest+json         webapp
176 |     AddType application/x-xpinstall                     xpi
177 |     AddType application/xml                             atom rdf rss xml
178 |     AddType image/webp                                  webp
179 |     AddType image/x-icon                                ico
180 |     AddType text/cache-manifest                         appcache manifest
181 |     AddType text/vtt                                    vtt
182 |     AddType text/x-component                            htc
183 |     AddType text/x-vcard                                vcf
184 | 
185 | </IfModule>
186 | 
187 | # ------------------------------------------------------------------------------
188 | # | UTF-8 encoding                                                             |
189 | # ------------------------------------------------------------------------------
190 | 
191 | # Use UTF-8 encoding for anything served as `text/html` or `text/plain`.
192 | AddDefaultCharset utf-8
193 | 
194 | # Force UTF-8 for certain file formats.
195 | <IfModule mod_mime.c>
196 |     AddCharset utf-8 .atom .css .js .json .rss .vtt .webapp .xml
197 | </IfModule>
198 | 
199 | 
200 | # ##############################################################################
201 | # # URL REWRITES                                                               #
202 | # ##############################################################################
203 | 
204 | # ------------------------------------------------------------------------------
205 | # | Rewrite engine                                                             |
206 | # ------------------------------------------------------------------------------
207 | 
208 | # Turning on the rewrite engine and enabling the `FollowSymLinks` option is
209 | # necessary for the following directives to work.
210 | 
211 | # If your web host doesn't allow the `FollowSymlinks` option, you may need to
212 | # comment it out and use `Options +SymLinksIfOwnerMatch` but, be aware of the
213 | # performance impact: http://httpd.apache.org/docs/current/misc/perf-tuning.html#symlinks
214 | 
215 | # Also, some cloud hosting services require `RewriteBase` to be set:
216 | # http://www.rackspace.com/knowledge_center/frequently-asked-question/why-is-mod-rewrite-not-working-on-my-site
217 | 
218 | <IfModule mod_rewrite.c>
219 |     Options +FollowSymlinks
220 |   # Options +SymLinksIfOwnerMatch
221 |     RewriteEngine On
222 |   # RewriteBase /
223 | </IfModule>
224 | 
225 | # ------------------------------------------------------------------------------
226 | # | Suppressing / Forcing the "www." at the beginning of URLs                  |
227 | # ------------------------------------------------------------------------------
228 | 
229 | # The same content should never be available under two different URLs especially
230 | # not with and without "www." at the beginning. This can cause SEO problems
231 | # (duplicate content), therefore, you should choose one of the alternatives and
232 | # redirect the other one.
233 | 
234 | # By default option 1 (no "www.") is activated:
235 | # http://no-www.org/faq.php?q=class_b
236 | 
237 | # If you'd prefer to use option 2, just comment out all the lines from option 1
238 | # and uncomment the ones from option 2.
239 | 
240 | # IMPORTANT: NEVER USE BOTH RULES AT THE SAME TIME!
241 | 
242 | # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
243 | 
244 | # Option 1: rewrite www.example.com → example.com
245 | 
246 | <IfModule mod_rewrite.c>
247 |     RewriteCond %{HTTPS} !=on
248 |     RewriteCond %{HTTP_HOST} ^www\.(.+)$ [NC]
249 |     RewriteRule ^ http://%1%{REQUEST_URI} [R=301,L]
250 | </IfModule>
251 | 
252 | # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
253 | 
254 | # Option 2: rewrite example.com → www.example.com
255 | 
256 | # Be aware that the following might not be a good idea if you use "real"
257 | # subdomains for certain parts of your website.
258 | 
259 | # <IfModule mod_rewrite.c>
260 | #    RewriteCond %{HTTPS} !=on
261 | #    RewriteCond %{HTTP_HOST} !^www\..+$ [NC]
262 | #    RewriteCond %{HTTP_HOST} !=localhost [NC]
263 | #    RewriteCond %{HTTP_HOST} !=127.0.0.1
264 | #    RewriteRule ^ http://www.%{HTTP_HOST}%{REQUEST_URI} [R=301,L]
265 | # </IfModule>
266 | 
267 | 
268 | # ##############################################################################
269 | # # SECURITY                                                                   #
270 | # ##############################################################################
271 | 
272 | # ------------------------------------------------------------------------------
273 | # | Content Security Policy (CSP)                                              |
274 | # ------------------------------------------------------------------------------
275 | 
276 | # You can mitigate the risk of cross-site scripting and other content-injection
277 | # attacks by setting a Content Security Policy which whitelists trusted sources
278 | # of content for your site.
279 | 
280 | # The example header below allows ONLY scripts that are loaded from the current
281 | # site's origin (no inline scripts, no CDN, etc). This almost certainly won't
282 | # work as-is for your site!
283 | 
284 | # To get all the details you'll need to craft a reasonable policy for your site,
285 | # read: http://html5rocks.com/en/tutorials/security/content-security-policy (or
286 | # see the specification: http://w3.org/TR/CSP).
287 | 
288 | # <IfModule mod_headers.c>
289 | #    Header set Content-Security-Policy "script-src 'self'; object-src 'self'"
290 | #    <FilesMatch "\.(appcache|crx|css|eot|gif|htc|ico|jpe?g|js|m4a|m4v|manifest|mp4|oex|oga|ogg|ogv|otf|pdf|png|safariextz|svgz?|ttf|vcf|webapp|webm|webp|woff|xml|xpi)$">
291 | #        Header unset Content-Security-Policy
292 | #    </FilesMatch>
293 | # </IfModule>
294 | 
295 | # ------------------------------------------------------------------------------
296 | # | File access                                                                |
297 | # ------------------------------------------------------------------------------
298 | 
299 | # Block access to directories without a default document.
300 | # Usually you should leave this uncommented because you shouldn't allow anyone
301 | # to surf through every directory on your server (which may includes rather
302 | # private places like the CMS's directories).
303 | 
304 | <IfModule mod_autoindex.c>
305 |     Options -Indexes
306 | </IfModule>
307 | 
308 | # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
309 | 
310 | # Block access to hidden files and directories.
311 | # This includes directories used by version control systems such as Git and SVN.
312 | 
313 | <IfModule mod_rewrite.c>
314 |     RewriteCond %{SCRIPT_FILENAME} -d [OR]
315 |     RewriteCond %{SCRIPT_FILENAME} -f
316 |     RewriteRule "(^|/)\." - [F]
317 | </IfModule>
318 | 
319 | # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
320 | 
321 | # Block access to backup and source files.
322 | # These files may be left by some text editors and can pose a great security
323 | # danger when anyone has access to them.
324 | 
325 | <FilesMatch "(^#.*#|\.(bak|config|dist|fla|inc|ini|log|psd|sh|sql|sw[op])|~)$">
326 |     Order allow,deny
327 |     Deny from all
328 |     Satisfy All
329 | </FilesMatch>
330 | 
331 | # ------------------------------------------------------------------------------
332 | # | Secure Sockets Layer (SSL)                                                 |
333 | # ------------------------------------------------------------------------------
334 | 
335 | # Rewrite secure requests properly to prevent SSL certificate warnings, e.g.:
336 | # prevent `https://www.example.com` when your certificate only allows
337 | # `https://secure.example.com`.
338 | 
339 | # <IfModule mod_rewrite.c>
340 | #    RewriteCond %{SERVER_PORT} !^443
341 | #    RewriteRule ^ https://example-domain-please-change-me.com%{REQUEST_URI} [R=301,L]
342 | # </IfModule>
343 | 
344 | # ------------------------------------------------------------------------------
345 | # | HTTP Strict Transport Security (HSTS)                                      |
346 | # ------------------------------------------------------------------------------
347 | 
348 | # Force client-side SSL redirection.
349 | 
350 | # If a user types "example.com" in his browser, the above rule will redirect
351 | # him to the secure version of the site. That still leaves a window of oppor-
352 | # tunity (the initial HTTP connection) for an attacker to downgrade or redirect
353 | # the request. The following header ensures that browser will ONLY connect to
354 | # your server via HTTPS, regardless of what the users type in the address bar.
355 | # http://tools.ietf.org/html/draft-ietf-websec-strict-transport-sec-14#section-6.1
356 | # http://www.html5rocks.com/en/tutorials/security/transport-layer-security/
357 | 
358 | # (!) Remove the `includeSubDomains` optional directive if the subdomains are
359 | # not using HTTPS.
360 | 
361 | # <IfModule mod_headers.c>
362 | #    Header set Strict-Transport-Security "max-age=16070400; includeSubDomains"
363 | # </IfModule>
364 | 
365 | # ------------------------------------------------------------------------------
366 | # | Server software information                                                |
367 | # ------------------------------------------------------------------------------
368 | 
369 | # Avoid displaying the exact Apache version number, the description of the
370 | # generic OS-type and the information about Apache's compiled-in modules.
371 | 
372 | # ADD THIS DIRECTIVE IN THE `httpd.conf` AS IT WILL NOT WORK IN THE `.htaccess`!
373 | 
374 | # ServerTokens Prod
375 | 
376 | 
377 | # ##############################################################################
378 | # # WEB PERFORMANCE                                                            #
379 | # ##############################################################################
380 | 
381 | # ------------------------------------------------------------------------------
382 | # | Compression                                                                |
383 | # ------------------------------------------------------------------------------
384 | 
385 | <IfModule mod_deflate.c>
386 | 
387 |     # Force compression for mangled headers.
388 |     # http://developer.yahoo.com/blogs/ydn/posts/2010/12/pushing-beyond-gzipping
389 |     <IfModule mod_setenvif.c>
390 |         <IfModule mod_headers.c>
391 |             SetEnvIfNoCase ^(Accept-EncodXng|X-cept-Encoding|X{15}|~{15}|-{15})$ ^((gzip|deflate)\s*,?\s*)+|[X~-]{4,13}$ HAVE_Accept-Encoding
392 |             RequestHeader append Accept-Encoding "gzip,deflate" env=HAVE_Accept-Encoding
393 |         </IfModule>
394 |     </IfModule>
395 | 
396 |     # Compress all output labeled with one of the following MIME-types
397 |     # (for Apache versions below 2.3.7, you don't need to enable `mod_filter`
398 |     #  and can remove the `<IfModule mod_filter.c>` and `</IfModule>` lines
399 |     #  as `AddOutputFilterByType` is still in the core directives).
400 |     <IfModule mod_filter.c>
401 |         AddOutputFilterByType DEFLATE application/atom+xml \
402 |                                       application/javascript \
403 |                                       application/json \
404 |                                       application/rss+xml \
405 |                                       application/vnd.ms-fontobject \
406 |                                       application/x-font-ttf \
407 |                                       application/x-web-app-manifest+json \
408 |                                       application/xhtml+xml \
409 |                                       application/xml \
410 |                                       font/opentype \
411 |                                       image/svg+xml \
412 |                                       image/x-icon \
413 |                                       text/css \
414 |                                       text/html \
415 |                                       text/plain \
416 |                                       text/x-component \
417 |                                       text/xml
418 |     </IfModule>
419 | 
420 | </IfModule>
421 | 
422 | # ------------------------------------------------------------------------------
423 | # | Content transformations                                                    |
424 | # ------------------------------------------------------------------------------
425 | 
426 | # Prevent some of the mobile network providers from modifying the content of
427 | # your site: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.9.5.
428 | 
429 | # <IfModule mod_headers.c>
430 | #    Header set Cache-Control "no-transform"
431 | # </IfModule>
432 | 
433 | # ------------------------------------------------------------------------------
434 | # | ETag removal                                                               |
435 | # ------------------------------------------------------------------------------
436 | 
437 | # Since we're sending far-future expires headers (see below), ETags can
438 | # be removed: http://developer.yahoo.com/performance/rules.html#etags.
439 | 
440 | # `FileETag None` is not enough for every server.
441 | <IfModule mod_headers.c>
442 |     Header unset ETag
443 | </IfModule>
444 | 
445 | FileETag None
446 | 
447 | # ------------------------------------------------------------------------------
448 | # | Expires headers (for better cache control)                                 |
449 | # ------------------------------------------------------------------------------
450 | 
451 | # The following expires headers are set pretty far in the future. If you don't
452 | # control versioning with filename-based cache busting, consider lowering the
453 | # cache time for resources like CSS and JS to something like 1 week.
454 | 
455 | <IfModule mod_expires.c>
456 | 
457 |     ExpiresActive on
458 |     ExpiresDefault                                      "access plus 1 month"
459 | 
460 |   # CSS
461 |     ExpiresByType text/css                              "access plus 1 year"
462 | 
463 |   # Data interchange
464 |     ExpiresByType application/json                      "access plus 0 seconds"
465 |     ExpiresByType application/xml                       "access plus 0 seconds"
466 |     ExpiresByType text/xml                              "access plus 0 seconds"
467 | 
468 |   # Favicon (cannot be renamed!)
469 |     ExpiresByType image/x-icon                          "access plus 1 week"
470 | 
471 |   # HTML components (HTCs)
472 |     ExpiresByType text/x-component                      "access plus 1 month"
473 | 
474 |   # HTML
475 |     ExpiresByType text/html                             "access plus 0 seconds"
476 | 
477 |   # JavaScript
478 |     ExpiresByType application/javascript                "access plus 1 year"
479 | 
480 |   # Manifest files
481 |     ExpiresByType application/x-web-app-manifest+json   "access plus 0 seconds"
482 |     ExpiresByType text/cache-manifest                   "access plus 0 seconds"
483 | 
484 |   # Media
485 |     ExpiresByType audio/ogg                             "access plus 1 month"
486 |     ExpiresByType image/gif                             "access plus 1 month"
487 |     ExpiresByType image/jpeg                            "access plus 1 month"
488 |     ExpiresByType image/png                             "access plus 1 month"
489 |     ExpiresByType video/mp4                             "access plus 1 month"
490 |     ExpiresByType video/ogg                             "access plus 1 month"
491 |     ExpiresByType video/webm                            "access plus 1 month"
492 | 
493 |   # Web feeds
494 |     ExpiresByType application/atom+xml                  "access plus 1 hour"
495 |     ExpiresByType application/rss+xml                   "access plus 1 hour"
496 | 
497 |   # Web fonts
498 |     ExpiresByType application/font-woff                 "access plus 1 month"
499 |     ExpiresByType application/vnd.ms-fontobject         "access plus 1 month"
500 |     ExpiresByType application/x-font-ttf                "access plus 1 month"
501 |     ExpiresByType font/opentype                         "access plus 1 month"
502 |     ExpiresByType image/svg+xml                         "access plus 1 month"
503 | 
504 | </IfModule>
505 | 
506 | # ------------------------------------------------------------------------------
507 | # | Filename-based cache busting                                               |
508 | # ------------------------------------------------------------------------------
509 | 
510 | # If you're not using a build process to manage your filename version revving,
511 | # you might want to consider enabling the following directives to route all
512 | # requests such as `/css/style.12345.css` to `/css/style.css`.
513 | 
514 | # To understand why this is important and a better idea than `*.css?v231`, read:
515 | # http://stevesouders.com/blog/2008/08/23/revving-filenames-dont-use-querystring
516 | 
517 | # <IfModule mod_rewrite.c>
518 | #    RewriteCond %{REQUEST_FILENAME} !-f
519 | #    RewriteRule ^(.+)\.(\d+)\.(js|css|png|jpg|gif)$ $1.$3 [L]
520 | # </IfModule>
521 | 
522 | # ------------------------------------------------------------------------------
523 | # | File concatenation                                                         |
524 | # ------------------------------------------------------------------------------
525 | 
526 | # Allow concatenation from within specific CSS and JS files, e.g.:
527 | # Inside of `script.combined.js` you could have
528 | #   <!--#include file="libs/jquery.js" -->
529 | #   <!--#include file="plugins/jquery.idletimer.js" -->
530 | # and they would be included into this single file.
531 | 
532 | # <IfModule mod_include.c>
533 | #    <FilesMatch "\.combined\.js$">
534 | #        Options +Includes
535 | #        AddOutputFilterByType INCLUDES application/javascript application/json
536 | #        SetOutputFilter INCLUDES
537 | #    </FilesMatch>
538 | #    <FilesMatch "\.combined\.css$">
539 | #        Options +Includes
540 | #        AddOutputFilterByType INCLUDES text/css
541 | #        SetOutputFilter INCLUDES
542 | #    </FilesMatch>
543 | # </IfModule>
544 | 
545 | # ------------------------------------------------------------------------------
546 | # | Persistent connections                                                     |
547 | # ------------------------------------------------------------------------------
548 | 
549 | # Allow multiple requests to be sent over the same TCP connection:
550 | # http://httpd.apache.org/docs/current/en/mod/core.html#keepalive.
551 | 
552 | # Enable if you serve a lot of static content but, be aware of the
553 | # possible disadvantages!
554 | 
555 | # <IfModule mod_headers.c>
556 | #    Header set Connection Keep-Alive
557 | # </IfModule>
558 | 


--------------------------------------------------------------------------------
/public/crossdomain.xml:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0"?>
 2 | <!DOCTYPE cross-domain-policy SYSTEM "http://www.adobe.com/xml/dtds/cross-domain-policy.dtd">
 3 | <cross-domain-policy>
 4 |     <!-- Read this: www.adobe.com/devnet/articles/crossdomain_policy_file_spec.html -->
 5 | 
 6 |     <!-- Most restrictive policy: -->
 7 |     <site-control permitted-cross-domain-policies="none"/>
 8 | 
 9 |     <!-- Least restrictive policy: -->
10 |     <!--
11 |     <site-control permitted-cross-domain-policies="all"/>
12 |     <allow-access-from domain="*" to-ports="*" secure="false"/>
13 |     <allow-http-request-headers-from domain="*" headers="*" secure="false"/>
14 |     -->
15 | </cross-domain-policy>
16 | 


--------------------------------------------------------------------------------
/public/favicon.ico:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/markhughes/flight-skeleton/c2d7b9e5a09afb2ac9275290169684aecde6f137/public/favicon.ico


--------------------------------------------------------------------------------
/public/index.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | // -------------------------------------------------- //
 4 | // INIT
 5 | // -------------------------------------------------- //
 6 | 
 7 | require_once(__DIR__ . "/../vendor/autoload.php");
 8 | require_once(__DIR__ . "/../app/config/config.php");
 9 | require_once(__DIR__ . "/../app/config/log_handlers.php");
10 | require_once(__DIR__ . "/../app/logger.php");
11 | require_once(__DIR__ . "/../app/config/routes.php");
12 | 
13 | // -------------------------------------------------- //
14 | // LOGIC
15 | // -------------------------------------------------- //
16 | 
17 | // Setup flight vars
18 | foreach (FLIGHT_SET_VARS as $key => $value) {
19 |     Flight::set($key, $value);
20 | }
21 | 
22 | 
23 | // -------------------------------------------------- //
24 | // TWIG
25 | // -------------------------------------------------- //
26 | // Not using Twig? Remove this section! 
27 | 
28 | if (TEMPLATE_ENGINE === "twig") {
29 |     // Configure Twig with Flight
30 |     $twig_loader = new \Twig\Loader\FilesystemLoader(Flight::get("flight.views.path"));
31 | 
32 |     Flight::register("view", "Twig\Environment", [$twig_loader, TWIG_CONFIG], function ($twig) {
33 |         if (DEBUG) {
34 |             $twig->addExtension(new \Twig\Extension\DebugExtension());
35 |         }
36 |     });
37 | 
38 |     Flight::map('render', function (string $template, array $data): void {
39 |         echo Flight::view()->render($template . ".twig", $data);
40 |     });
41 | }
42 | 
43 | // -------------------------------------------------- //
44 | // LATTE
45 | // -------------------------------------------------- //
46 | // Not using Latte? Remove this section!
47 | if (TEMPLATE_ENGINE === "latte") {
48 |     // Configure Latte with Flight
49 |     Flight::register('view', Latte\Engine::class, [], function (Latte\Engine $latte) {
50 |         $latte->setTempDirectory(LATTE_CACHE_DIR);
51 | 
52 |         // Tell Latte where the root directory for your views will be at.
53 |         $latte->setLoader(new \Latte\Loaders\FileLoader(Flight::get("flight.views.path")));
54 |     });
55 | 
56 |     Flight::map('render', function (string $template, array $data): void {
57 |         echo Flight::view()->render($template . ".latte", $data);
58 |     });
59 | }
60 | // Lets go!
61 | Flight::start();
62 | 


--------------------------------------------------------------------------------
/public/resources/img/.gitignore:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/markhughes/flight-skeleton/c2d7b9e5a09afb2ac9275290169684aecde6f137/public/resources/img/.gitignore


--------------------------------------------------------------------------------
/public/robots.txt:
--------------------------------------------------------------------------------
1 | # robotstxt.org/
2 | 
3 | User-agent: *
4 | 


--------------------------------------------------------------------------------
/runway:
--------------------------------------------------------------------------------
 1 | #!/usr/bin/env php
 2 | <?php
 3 | 
 4 | if (!file_exists("vendor/bin/runway")) {
 5 |     echo("Runway not installed. Please run 'composer install' first.\n");
 6 |     exit(1);
 7 | }
 8 | 
 9 | require_once("vendor/bin/runway");
10 | 


--------------------------------------------------------------------------------
/src/Acme/Demo/Commands/.gitkeep:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/markhughes/flight-skeleton/c2d7b9e5a09afb2ac9275290169684aecde6f137/src/Acme/Demo/Commands/.gitkeep


--------------------------------------------------------------------------------
/src/Acme/Demo/Commands/ExampleCommand.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace flight\commands;
 4 | 
 5 | class ExampleCommand extends AbstractBaseCommand
 6 | {
 7 |     /**
 8 |      * Construct
 9 |      *
10 |      * @param array<string,mixed> $config JSON config from .runway-config.json
11 |      */
12 |     public function __construct(array $config)
13 |     {
14 |         parent::__construct('example:example-command', 'This is a sample command.', $config);
15 |     }
16 | 
17 |     /**
18 |      * Executes the function
19 |      *
20 |      * @return void
21 |      */
22 |     public function execute()
23 |     {
24 |         $io = $this->app()->io();
25 | 
26 |         $io->info('This is an example... ');
27 | 
28 |         $io->info('remember to pass `true` in the $io functions to add a new line at the end of the message.', true);
29 | 
30 |         // ... do something here ...
31 | 
32 |         $io->ok('Example completed!', true);
33 |     }
34 | }


--------------------------------------------------------------------------------
/src/Acme/Demo/Controllers/API.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Acme\Demo\Controllers;
 4 | 
 5 | use Flight;
 6 | use Flight\template\View;
 7 | 
 8 | class API
 9 | {
10 |     public static function message(): void
11 |     {
12 |         Flight::json([
13 |             'message' => 'An example API route!'
14 |         ]);
15 |     }
16 | }
17 | 


--------------------------------------------------------------------------------
/src/Acme/Demo/Controllers/Demo.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Acme\Demo\Controllers;
 4 | 
 5 | use Flight;
 6 | 
 7 | class Demo
 8 | {
 9 |     public static function index(): void
10 |     {
11 |         $context = [
12 |             "introduction_title" => "Hello world!",
13 |             "introduction_text" => "This is the skeleton for a Flight app."
14 |         ];
15 | 
16 |         Flight::render("index", $context);
17 |     }
18 | }
19 | 


--------------------------------------------------------------------------------
/src/Acme/Demo/Exception/.gitkeep:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/markhughes/flight-skeleton/c2d7b9e5a09afb2ac9275290169684aecde6f137/src/Acme/Demo/Exception/.gitkeep


--------------------------------------------------------------------------------
/src/Acme/Demo/Model/.gitkeep:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/markhughes/flight-skeleton/c2d7b9e5a09afb2ac9275290169684aecde6f137/src/Acme/Demo/Model/.gitkeep


--------------------------------------------------------------------------------
/src/Acme/Demo/Test/.gitkeep:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/markhughes/flight-skeleton/c2d7b9e5a09afb2ac9275290169684aecde6f137/src/Acme/Demo/Test/.gitkeep


--------------------------------------------------------------------------------
/src/Acme/Demo/Trait/.gitkeep:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/markhughes/flight-skeleton/c2d7b9e5a09afb2ac9275290169684aecde6f137/src/Acme/Demo/Trait/.gitkeep


--------------------------------------------------------------------------------
/src/Acme/Demo/Util/.gitkeep:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/markhughes/flight-skeleton/c2d7b9e5a09afb2ac9275290169684aecde6f137/src/Acme/Demo/Util/.gitkeep


--------------------------------------------------------------------------------
/tsconfig.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "compilerOptions": {
 3 |       "outDir": "./public/dist/",
 4 |       "noImplicitAny": false,
 5 |       "sourceMap": true,
 6 |       "module": "es6",
 7 |       "target": "es5",
 8 |       "jsx": "react",
 9 |       "allowJs": true
10 |     }
11 |   }
12 |   


--------------------------------------------------------------------------------
/var/cache/.gitkeep:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/markhughes/flight-skeleton/c2d7b9e5a09afb2ac9275290169684aecde6f137/var/cache/.gitkeep


--------------------------------------------------------------------------------
/var/logs/.gitkeep:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/markhughes/flight-skeleton/c2d7b9e5a09afb2ac9275290169684aecde6f137/var/logs/.gitkeep


--------------------------------------------------------------------------------
/webpack.config.js:
--------------------------------------------------------------------------------
 1 | const path = require('path');
 2 | 
 3 | module.exports = {
 4 |   entry: './app/resources/scripts/index',
 5 |   devtool: 'source-map',
 6 |   module: {
 7 |     rules: [
 8 |       {
 9 |         test: /\.tsx?$/,
10 |         use: 'ts-loader',
11 |         exclude: /node_modules/,
12 |       },
13 |       {
14 |         test: /\.(scss)$/,
15 |         use: [{
16 |           loader: 'style-loader', // inject CSS to page
17 |         }, {
18 |           loader: 'css-loader', // translates CSS into CommonJS modules
19 |         }, {
20 |           loader: 'postcss-loader', // Run post css actions
21 |           options: {
22 |             postcssOptions: {
23 |               plugins: [
24 |                   require('autoprefixer')
25 |                 ]
26 |             }
27 |           }
28 |         }, {
29 |           loader: 'sass-loader' // compiles Sass to CSS
30 |         }]
31 |       },
32 |     
33 |     ],
34 |   },
35 |   resolve: {
36 |     extensions: ['.ts', '.js', '.tsx', '.jsx'],
37 |   },
38 |   output: {
39 |     filename: 'main.js',
40 |     path: path.resolve(__dirname, 'public', 'dist'),
41 |   },
42 |   mode: 'production',
43 | };
44 | 


--------------------------------------------------------------------------------