README

Summary

PHP Framework project built with MVC architecture, OOP paradigm and full ORM (native, not vendor).

Setup

• Get the latest version, clone it or download the zip.
• Unzip if is needed.
• Go to the folder and run the install script:

cd /path/to/DumboPHP/
sudo ./install.php

via composer

composer require rantes/dumbophp

Server configuration

• PHP: Enable short open tags.

• Apache: enable mod_rewrite.

• Consider to set a local domain up with a virtual host).

  • Remember to enable virtual host mod.
  • You can use this config as a sample:

#!apache

<VirtualHost *:80>
    ServerAdmin webmaster@localhos.com
    ServerName myproject.local
    ServerAlias myproject.local
    DocumentRoot /path/to/myproject
    <Directory /path/to/myproject/>
            Options Indexes FollowSymLinks
            AllowOverride All
            Order allow,deny
            allow from all
    </Directory>

</VirtualHost>

#!nginx

server {

    root /path/to/myproject/app/webroot;
    index index.php;

    server_name myproject.local;

    set $token "";

    if ($is_args) { # if the request has args update token to "&"
        set $token "&";
    }

    location / {
            set $args "${args}${token}url=${uri}";
            rewrite ^/(.*\.(png|gif|jpg|jpeg|js|pdf|css|ico|svg|json|webp|woff|ttf))$ /$1 break;
            try_files $uri $uri/ /index.php$is_args$args;
    }

    location ~ \.php$ {
            include snippets/fastcgi-php.conf;
            fastcgi_pass unix:/run/php/php7.4-fpm.sock;
    }

    location ~ /\.ht {
            deny all;
    }
}

Testing the framework

The framework ships with a self-contained test suite under tests/ that uses DumboPHP to test DumboPHP (SQLite :memory:, no external dependencies).

php tests/verify_timothy.php   # Level 0: verify the Timothy test runner itself
php tests/run.php              # Level 1: run every suite
php tests/run.php --verbose    # show per-assertion progress

It exercises the ActiveRecord ORM, validations, model hooks, relations, migrations, routing/controllers, the inflection helpers, and the Timothy spy/stub/mock helpers. See tests/README.md for the full guide and .kiro/bugs/ for issues it surfaced.

Go Further

For more info, please visite homepage DumboPHP.