2017 © Pedro PelĂĄez
 

project slim3-skeleton

A Slim Framework 3 application skeleton

image

aurmil/slim3-skeleton

A Slim Framework 3 application skeleton

  • Monday, May 14, 2018
  • by aurmil
  • Repository
  • 2 Watchers
  • 4 Stars
  • 90 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 0 Forks
  • 0 Open issues
  • 13 Versions
  • 6 % Grown

The README.md

Slim 3 Skeleton

What's included?

Installation

Required: PHP 7 and Composer, (*1)

Run the following command, replacing [your-project-name] with the name of the folder you want to create., (*2)

composer create-project aurmil/slim3-skeleton [your-project-name]

This skeleton includes a .htaccess file for Apache but Slim supports other Web servers., (*3)

  • Optional: create a virtual host that points to public folder
  • When using Apache, make sure it has AllowOverride All for your project path (or a parent folder) for Slim URL rewriting to work
  • Make sure var folder is writable by Web server

Configuration

Configuration files are stored in config folder. There is one YAML file per subject/package, for better readability/management. Other package-specific configuration files can be stored there (and then need to be handled in application code). You can also add whatever you need into app.yaml file as it is up to you to use new configuration values in application code., (*4)

Some configuration values can change from an environment to another. Current environment name is read from ENVIRONMENT env variable (default = development). Environment-specific configuration files override values from global configuration. Simply copy-paste one existing YAML file into a folder whose name is a valid environment name. Then edit this file and remove everything except the values you want to change for this environment. There are examples in development-example and production-example folders., (*5)

Configuration is available in application through:, (*6)

  • $config variable in src/bootstrap.php
  • Container's settings entry: $container->settings usually and $this->settings in controllers extending App\Controllers\Controller
  • config variable in Twig templates: {{ config.my_custom_setting_key }}, but it contains only app and security configuration files

Controllers

Controllers can inherit from App\Controllers\Controller class., (*7)

It provides a render() method and automatic access to Slim Container entries through $this->my_service_entry_name, (*8)

Session

In session.yaml configuration file, you can enable or disable session usage., (*9)

Session is required if you want to use Flash messages or CSRF protection., (*10)

CSRF

If session is enabled, CSRF token is generated for each request., (*11)

In security.yaml configuration file, you can enable token persistence: a token is generated for each user but not for each request. Simplifies usage of Ajax but makes application vulnerable to replay attacks if you are not using HTTPS., (*12)

If CSRF check fails, the request has a csrf_status attribute set to false. You can check this attribute/value in routes/controllers:, (*13)

if (false === $request->getAttribute('csrf_status')) {
    // CSRF check failed
}

In Twig templates, you can add CSRF hidden fields with:, (*14)

{{ csrf() }}

If you want to make something custom, you can also access to CSRF token values:, (*15)

{{ csrf_token.keys.name }}
{{ csrf_token.keys.value }}
{{ csrf_token.name }}
{{ csrf_token.value }}

Flash Messages

If session is enabled, Flash Messages are available., (*16)

To add a message within a route/controller:, (*17)

$this->flash->addMessage('my_key', 'my_value');

To get a message in a Twig template:, (*18)

{% set my_var = flash('my_key') %}

To get all messages:, (*19)

{% set my_var = flash() %}

Emails

In swiftmailer.yaml configuration file, you can enable usage of SwiftMailer and then use mailer entry from container as Swift_Mailer object in your code., (*20)

By configuring SwiftMailerHandler (+ swiftmailer.yaml file) or NativeMailerHandler in monolog.yaml configuration file, you can enable or disable sending email with Monolog when an error occurs., (*21)

HTML meta tags

Every key: value pair you add under metas in app.yaml configuration file will be output in HTML head section as a meta tag., (*22)

Title

Page title is a special case. Obviously, title and title_separator entries won't be output as meta tags like the other ones., (*23)

A page title is compound as follows: * content of the metaTitle block a template child could define, (*24)

{% block metaTitle %}my custom page title{% endblock %}
  • if app.metas.title configuration entry is not empty:
    • if app.metas.title_separator configuration entry is not empty, add the separator
    • add app.metas.title

Code quality tools

Run the following commands to check your code:, (*25)

License

The MIT License (MIT). Please see License File for more information., (*26)

The Versions

14/05 2018

dev-master

9999999-dev https://github.com/aurmil/slim3-skeleton

A Slim Framework 3 application skeleton

  Sources   Download

MIT

The Requires

 

The Development Requires

by Aurélien Millet

framework slim slimphp

23/02 2018

v3.0.2

3.0.2.0 https://github.com/aurmil/slim3-skeleton

A Slim Framework 3 application skeleton

  Sources   Download

MIT

The Requires

 

The Development Requires

by Aurélien Millet

framework slim slimphp

07/02 2018

v3.0.1

3.0.1.0 https://github.com/aurmil/slim3-skeleton

A Slim Framework 3 application skeleton

  Sources   Download

MIT

The Requires

 

The Development Requires

by Aurélien Millet

framework slim slimphp

30/10 2017

v3.0.0

3.0.0.0 https://github.com/aurmil/slim3-skeleton

A Slim Framework 3 application skeleton

  Sources   Download

MIT

The Requires

 

The Development Requires

by Aurélien Millet

framework slim slimphp

26/10 2017

v2.0.0

2.0.0.0 https://github.com/aurmil/slim3-skeleton

A Slim Framework 3 application skeleton

  Sources   Download

MIT

The Requires

 

by Aurélien Millet

framework slim slimphp

11/07 2017

2.0.0

2.0.0.0 https://github.com/aurmil/slim3-skeleton

A Slim Framework 3 application skeleton

  Sources   Download

MIT

The Requires

 

by Aurélien Millet

framework slim slimphp

03/01 2017

v1.1.0

1.1.0.0 https://github.com/aurmil/slim3-skeleton

A Slim Framework 3 application skeleton

  Sources   Download

MIT

The Requires

 

by Aurélien Millet

framework slim slimphp

24/03 2016

v1.0.5

1.0.5.0 https://github.com/aurmil/slim3-skeleton

A Slim Framework 3 application skeleton

  Sources   Download

MIT

The Requires

 

by Aurélien Millet

framework slim slimphp

14/03 2016

v1.0.4

1.0.4.0 https://github.com/aurmil/slim3-skeleton

A Slim Framework v3 application skeleton

  Sources   Download

MIT

The Requires

 

by Aurélien Millet

slim microframework slimphp

26/02 2016

v1.0.3

1.0.3.0 https://github.com/aurmil/slim3-skeleton

A Slim Framework v3 application skeleton

  Sources   Download

MIT

The Requires

 

by Aurélien Millet

slim microframework slimphp

19/02 2016

v1.0.2

1.0.2.0 https://github.com/aurmil/slim3-skeleton

A Slim Framework v3 application skeleton

  Sources   Download

MIT

The Requires

 

by Aurélien Millet

slim microframework slimphp

16/02 2016

v1.0.1

1.0.1.0 https://github.com/aurmil/slim3-skeleton

A Slim Framework v3 application skeleton

  Sources   Download

MIT

The Requires

 

by Aurélien Millet

slim microframework slimphp

15/02 2016

v1.0.0

1.0.0.0 https://github.com/aurmil/slim3-skeleton

A Slim Framework v3 application skeleton

  Sources   Download

MIT

The Requires

 

by Aurélien Millet

slim microframework slimphp