opensourcemind/natural-php

The Natural PHP Framework

Natural PHP

The open source framework for natural app development in PHP

Natural PHP is a framework that incorporates other open source projects to provide a feature rich platform for app development.
Develop fast, develop Naturally !, _(*1)

Framework Requirements

• PHP 5+
• MYSQL 5+
• [PHP Composer] (https://getcomposer.org/)

Apache configuration

Requirements

• Apache mod_rewrite enabled (Restler APIs and Docs)
• Apache must be able to write to the API cache folder under YOUR_PROJECT/api
• Apache must be able to write to the API docs folder under YOUR_PROJECT/api/docs

Instructions

<Directory /var/www/html/>
      Options Indexes FollowSymLinks
       AllowOverride All
</Directory>

Enable mod_rewrite in Apache

a2enmod rewrite, _(*2)

Restart Apache service

service apache2 restart, _(*3)

Nginx Configuration

server {
    listen 80 default;

    root /var/www/;
    index index.php index.html index.htm;

    server_name localhost:8888;

        access_log /var/www/logs/access_log.txt;
    error_log /var/www/logs/error_log.txt;

    location / {
        try_files $uri $uri/ =404;
    }

    error_page 404 /404.html;

    error_page 500 502 503 504 /50x.html;
    location = /50x.html {
        root /var/www;
    }

    location /api {
        try_files $uri /api/index.php;
        gzip    off;
        fastcgi_pass    unix:/var/run/php5-fpm.sock;
        fastcgi_index   index.php;
        fastcgi_param   SCRIPT_FILENAME  $document_root$fastcgi_script_name;
        include         fastcgi_params;
    }

    location /api/doc {
    alias /var/www/api/doc;
    }


    location ~ \.php$ {
        fastcgi_split_path_info ^(.+\.php)(/.+)$;
        fastcgi_pass unix:/var/run/php5-fpm.sock;
        fastcgi_index index.php;
        include fastcgi_params;
    }
}

Install with composer

To install the latest stable release:
composer create-project opensourcemind/natural-php PROJECT_FOLDER 2.0.5, _(*4)

To install the latest development release from the master branch:
composer create-project -s dev opensourcemind/natural-php PROJECT_FOLDER, _(*5)

To install the another specific version (i.e. 2.0.3 ):
composer create-project opensourcemind/natural-php PROJECT_FOLDER 2.0.3, _(*6)

Configure your database

After installing you should edit your database information in the files bootstrap.php, if you would like
to keep both a production and development database config you can just duplicate the bootstrap file
into a new file named bootstrap.dev.php which Natural automatically prefers over production config
when present., _(*7)

Natural also requires some specific tables available in your database and the easiest way to add them
to your database is to import the file natural_framework.sql available in your project folder., _(*8)

For your conveninece you can just run the initdb.php script located in the tools directory to wipe any instances of natural_framework database and deploy from the .sql file., _(*9)

php -p tools/initdb.php

or, _(*10)

./tools/initdb.php

Vagrant database credentials user: root pass: 123456, _(*11)

Deploy / Develop with Vagrant

Natural code base includes a Vagrantfile and required provisioning script for an Nginx environment. Once you install natural-php all you have to do is type vagrant up and you are up and running., _(*12)

*This requires you to have Vagrant installed and ready to go., _(*13)