My blog page

This repository source code is deployed on gediminasm.org my blog page. I have used Symfony2 before. But since it was too heavy for such a simple task, it was changed to use a most lightweight version possible. Why I'm not using Wordpress? Well I'm a software engineer and I see fit to make things as light as they can be, I also share UNIX philosophy and for an engineer it is important to always innovate.

This application is so simple that it cannot fail you, it gives complete control over everything without introducing huge abstraction layer. I do not encourage folks to reuse any source code if you do not understand it.

Requirements

• PHP >= 5.4.0
• Postgresql and php extension, PDO is not used
• PhpUnit >= 3.7.0

Internals

Here is the whole "framework" structure:

• framework.php defines a dispacher and service container. (~70 lines of code)
• routing is using standard regular expressions - maybe its time to get more friendly with it ha?
• error_handler.php all ways errors may be handled.
• controllers/ a directory where all controllers are registered.
• services/ a directory where all services are registered, note: config.php is visible only in service initialization scope.
• commands/ a directory where all console commands are registered.
• assets/ a directory where all assets are located, before they are being compiled to production version.
• models there are none, but if needed, they can be registered as services.

There is no cache, because there is nothing to cache, except third party stuff like twig or whatever, which is used additionally. There can't be any faster routing, except file structured one.

Install

Nginx configuration example:

server {
    listen 80;
    server_name blog.lc;

    root /home/gedi/php/blog/public; # point to public directory

    error_log /var/log/nginx/blog.error.log;
    access_log /var/log/nginx/blog.access.log;

    # first check if its a static file, otherwise run through @handler
    location / {
        index index.php;
        try_files $uri @handler;
        #expires 24h;
    }

    # if it was not a static file, execute through index.php
    location @handler {
        rewrite ^(.*)$ /index.php last; # force index.php if it was not a file
    }

    # pass the PHP scripts to fpm socket, NOTE: php-fpm required, otherwise use fastcgi
    location ~ \.php$ {
        fastcgi_pass                    unix:/var/run/php-fpm/php-fpm.sock;
        fastcgi_index                   index.php;
        include                         fastcgi_params;
        fastcgi_param SCRIPT_FILENAME   $document_root$fastcgi_script_name;
        fastcgi_param HTTPS             off;

        # application environment: production, development, testing
        fastcgi_param  APP_ENV          development;
    }
}

NOTE: any other web server can be used like apache2 as an example.

Install third party:

curl -s https://getcomposer.org/installer | php && php composer.phar install

Configure:

cp config.php.dist config.php

Install database schema:

php bin/console blog:database:install -e production

Install assets:

First, make sure tmp/ directory is writtable.

php bin/console assets:dump -e production

Load blog posts to database:

php bin/console blog:update -e production

Running BDD Behat tests

All tests are bahavior driven and uses Behat and Mink environment. To run tests, you will need:

• PhpUnit >= 3.7.0
• Selenium2 server, at least 2.31.0 version (firefox or chrome, phantomjs recommended)

First of all, download and run recent selenium2 server:

wget http://selenium.googlecode.com/files/selenium-server-standalone-2.31.0.jar
java -jar selenium-server-standalone-2.31.0.jar

Second, make sure test database is created:

php bin/console blog:database:install -e testing

Third, clone behat config for customization:

cp behat.yml.dist behat.yml

Note: you should create a separate virtual host for tests, so that it could use selenium_testing environment

Edit behat.yml and update base_url. Finally, you can run all tests:

php behat.phar

Running TDD PhpUnit tests

Make sure you have PhpUnit at least 3.7.0 version. Simply run:

phpunit

Support

This source code is under BSD license. I may answer if you email me at gediminas.morkevicius{at}gmail.com

License

The three clause BSD license