the-matrix/slim-dic-example

A Slim Framework skeleton application utilising Symfony DIC to create a super thin MVC

the-matrix/slim-dic-example

, _(*1)

Use this skeleton application to quickly setup and start working on a new Slim Framework 3 application incorporating the power of the Symfony 2 Dependency Injection component or Symfony 4 Dependency Injection component., _(*2)

Symfony 2 is supported by PHP 5.6.. Symfony 4 is supported by PHP 7.1., _(*3)

This demo also uses Sensio Labs' Twig template library, but you don't have to - use Smarty instead, or native PHP for your view scripts - it's up to you, - just configure the DIC definition files per your requirements. (Don't forget to add/remove dependencies in composer.json if you do.), _(*4)

Also included is a minimal Controller (MVC) implementation, that allows you to seperate out the routing from the site application logic. Again, you don't need to use it if you don't want to., _(*5)

This skeleton application was built for Composer. This makes setting up a new Slim Framework application quick and easy. You are not intended to include this as a composer requirement, but to create a new Composer app with it and move on., _(*6)

This is a PHP5.6+ application, _(*7)

Install Composer

Install [Composer] (https://getcomposer.org/). It is useful to symlink the composer.phar file into /usr/local/bin or your ~/bin directory, dependent on your circumstances e.g., _(*8)

    cd ~/bin
    ln -s /path/to/composer.phar composer
    chmod u+x composer

Install the Application

After you install Composer, run this command from the directory below the one in which you want to install your new Slimdic application., _(*9)

composer create-project the-matrix/slim-dic-example my-app-name 3.* , _(*10)

Replace my-app-name with the desired directory name for your new application. When the installer asks Do you want to remove the existing VCS (.git, .svn..) history? [Y,n]? , _(*11)

then enter 'Y'., _(*12)

(NB. If you want the Slim 2 + Symfony 2 version of this library, use 1.* as the version number above.), _(*13)

The rest of this section comes under the general heading of 'Teaching Grandma to Suck Eggs', but hey - someone out there is a newby!, _(*14)

You'll want to:, _(*15)

• Point your virtual host document root to your new application's public/ directory., _(*16)

• Ensure your web server has rights to your root directory. It needs to be able to read and write to the appropriate directories e.g., _(*17)

    sudo chgrp -R apache my-app-name
    sudo chmod -R g+r my-app-name
    sudo chmod -R g+w my-app-name/spool

ensures that both you and the server can read and write. NB, check the user name that your server is running under, something like:, _(*18)

    ps aux | grep httpd
    # or
    ps aux | grep apache

normally does the trick., _(*19)

Have a care for security. Dependent on your server, set the vhost to allow public access to the ./public directory only. The app needs to be able to see everything from one directory below, and no more., _(*20)

Dependent on how you have set up your vhost, you may need to add an entry to the /etc/hosts file. I like to set each app I'm developing on it's own dns name so typically, I'll add something like, _(*21)

127.0.0.1 my-app.localhost , _(*22)

to /etc/hosts. Obviously, the name needs to match your web server vhost name, _(*23)

Now assuming you've got all that, point your browser at the the vhost name and off you go - you should be seeing a nice page. Now browse to /logon and check out the cool demo logon. It doesn't matter if you get it wrong - the answer will be revealed., _(*24)

So you did the demo. Now look at the code - it's all in there under the Site directory and in the public/index.php file., _(*25)

And remember, once you've installed this demo template, you can change it without worrying that a composer update is going to override any code that you write. That will just update any packages you have defined in your composer.json file., _(*26)

More reading

The Site Directory, _(*27)

Using the Controller, _(*28)

Find more

Check out ZF4 Packages for more packages, _(*29)

History

V1.0.0 Slim 2 + Symfony 2, _(*30)

V2.0.0 Slim 3 + Symfony 2, _(*31)

V2.0.1 Add link to packages, _(*32)

V2.0.2 bug fix from Nigel Greenway, _(*33)

V2.0.3 code clean. readme typos. bug fix from Nigel Greenway, _(*34)

V2.1.0 Update for PHP 7.1, _(*35)

V2.1.1 update composer - forced by packagist composer.json format change, _(*36)

V3.0.0 BC Break. Remove support for PHP <5.6, _(*37)