Decisions and what's next

What we have already achieved

About documentation

Installing

php composer.phar create-project inphinit/inphinit my-application

composer create-project inphinit/inphinit my-application

git clone --recurse-submodules https://github.com/inphinit/inphinit.git my-applicationcd my-application

Testing

php -S localhost:5000 -t public index.php

NGINX

location / {    root /home/foo/bar/my-application;    # Redirect page errors to route system    error_page 403 /index.php/RESERVED.INPHINIT-403.html;    error_page 500 /index.php/RESERVED.INPHINIT-500.html;    try_files /public$uri /index.php?$query_string;    location = / {        try_files $uri /index.php?$query_string;    }    location ~ /\. {        try_files /index.php$uri /index.php?$query_string;    }    location ~ \.php$ {        # Replace by your FPM or FastCGI        fastcgi_pass 127.0.0.1:9000;        fastcgi_index index.php;        include fastcgi_params;        set $teeny_suffix "";        if ($uri != "/index.php") {            set $teeny_suffix "/public";        }        fastcgi_param SCRIPT_FILENAME $realpath_root$teeny_suffix$fastcgi_script_name;    }}

Folder structure

├───.htaccess# Apache web server configuration├───index.php# Only change the values of the constants, and only if necessary├───server# Shortcut to start the built-in web server on Linux and macOS├───server.bat# Shortcut to start the built-in web server on Windows├───web.config# IIS web server configuration├───public/# In this folder you can place static files or PHP scripts that will be independent└───system/# Folder containing your application    ├───boot/# Contain settings for inphinit_autoload, similar to composer_autoload    ├───configs/# Contain varied configuration files, it is recommended that you do not version this folder    │   └───app.php# Don't add new keys, just change the values of existing ones if necessary    ├───controllers/# Must contain the classes that will be controllers used in the routes    ├───vendor/# Contain third-party packages and the framework    ├───views/# Should contain your views    ├───dev.php# It has the same purpose as the "main.php" script, but it will only work in development mode    ├───errors.php# It should contain error page settings, such as when a 404 or 405 error occurs, you can call static files or use views    └───main.php# This is the main file for routes and events, it will be available in development mode and production mode

Creating routes

<?php// anonymous functions$app->action('GET','/closure',function () {return'Hello "closure"!';});functionfoobar() {return'Hello "function"!';}// callable function$app->action('GET','/function','foobar');// callable class static method (Note: autoload will include the file)$app->action('GET','/class-static-method', ['MyNameSpace\Foo\Bar','hello']);// callable class method$foo =newSample;$app->action('GET','/class-method', [$foo,'hello']);// do not add the Controller prefix, the framework itself will add$app->action('GET','/controller','Boo\Bar::xyz');/** * Controller from `./system/controllers/Boo/Bar.php`: * * <?php * namespace Controller\Boo; * * class Bar { *    public function xyz() { *        ... *    } * } */

Grouping routes

<?php/* * Routes will only be added if the path starts with /blog/ * * Samples: * * http://localhost:5000/blog/ * http://localhost:5000/blog/post * http://localhost:5000/blog/search */$app->scope('*://*/blog/',function ($app,$params) {$app->action('GET','/',function () {... });$app->action('POST','/post',function () {... });$app->action('GET','/search',function () {... });});// Routes will only be added if you are accessing via HTTPS$app->scope('https://*',function ($app,$params) {...});// Routes will only be added if you are accessing via HTTP$app->scope('http://*',function ($app,$params) {...});// Routes will only be added if you are accessing mysite2.org host$app->scope('*://mysite2.org/',function ($app,$params) {...});// Routes will only be added if you are accessing a subdomain from main.org, like: site1.main.org$app->scope('*://*.main.org/',function ($app,$params) {...});// Using pattern to get the subdomain:$app->scope('*://<subdomain>.main.org/',function ($app,$params) {$subdomain =$params['subdomain'];...});// Using pattern to get path:$app->scope('*://*/users/<id:num>/<user>',function ($app,$params) {$id =$params['id'];$username =$params['user'];...});

Route and URL patterns

<?phpuseInphinit\Viewing\View;$app->action('GET','/about/<lang:locale>',function ($params) {$lang =$params['lang'];...});$app->action('GET','/product/<id:id>',function ($params) {$lang =$params['id'];...});$app->setPattern('locale','[a-z]{1,8}(\-[A-Z\d]{1,8})?');// examples: en, en-US, en-GB, pt-BR, pt$app->setPattern('id','[A-Z]\d+');// examples: A0001, B002, J007

<?php// Replace semversion by <major>.<minor>.<revision>.<build>$app->setPattern('version','\d+\.\d+.\d+.\d+');// Replace semversion by <major>.<minor> (maybe it's interesting for web APIs)$app->setPattern('version','\d+\.\d+');