Added

• Translations for Ubiquity guide into Spanish => thanks to @alnux for his work in progress
• Translations for Ubiquity guide into french

Updated

In ORM:

• support for primary keys updating (with DAO::update($object))

Tests:

• Improvement of the test coverage => 71%

If devtools are already installed globally, update them:

composer global update

Added

• setIsolationLevel for transactions with DAO and Database in Mysql/MariaDb.

Breaking changes

• env var support for config files:
  • Cache initialization is required for config
  • loaded config file is located in app/cache/config/config.cache.php after cache initialization

Fixed

• Injected attribute parsing in DiControllerParser (pb with name) - no open issue -

Added

• count method to AbstractRepository
• app methods to Logger: appLog, appInfo, appError...
• regenerateId for USession
• DataFormHelper class for model form generation
• forward method to UResponse

Fixed

• php 8.1 deprecation in Validator, UModel, UArrayModel classes
• checkConnection in AuthController
• data-target bug in MultiResourceCrudController
• UCookie pb with transformers

removed

• diSemantic and diBootstrap in Framework => use Ajax\php\ubiquity\JsUtils::diSemantic(...) instead.

Updated (breaking change)

• AuthControllers refactoring
• CRUDControllers (return types added on methods to override)

With an update on an existing project, the following error may occur in derived classes of AuthController, AuthFiles, CRUDController, CRUDFiles:

Fatal error: Declaration of controllers\auth\files\MyAuthFiles::getViewIndex() must be compatible with Ubiquity\controllers\auth\AuthFiles::getViewIndex(): string

The signature of the methods of AuthController, AuthFiles, CRUDController, CRUDFiles has changed, by adding the return types:

It is therefore necessary to add this return types on the overridden methods

	public function getViewIndex():string {
		return 'MyAuth/index.html';
	}

Added

In Auth controllers:

• Account recovery (password reset)
• AuthControllerConfig, UASystem, UConfigFile classes

Added

In Auth controllers:

• Two factor authentification
• Default account creation + email validation

In Router:

• Action parameters typing with Router (int, float, bool)

Fixed

• RestServer Fix php 8.1 depreciation
• php 8.1 depreciations in ModelsCacheUpdated, ValidatorMultiple...

Updated

• Default index css style

Added

• image insertion in AssetsManager, img twig function see https://github.com/phpMv/ubiquity/issues/188
• reverse to Transformers
• nonce in default template files

Fixed

• typo in MultiResourceCrudController (no open issue)
• php 8.1 depreciation warnings (UbiquityException, UCookie, UResponse...)

Added

• Pseudo-migrations in webtools and devtools

Ubiquity info-migrations
Ubiquity migrations

• Models creation command in devtools

Ubiquity new-model User
Ubiquity new-model user,group

Updated

• Db wrappers for migrations
• Added DbOperations

Fixed

• Fix absolute path pb in router with #/ (no open issue)
• Fix mainParams pb in router cache generation (no open issue)

Added

• Domain Driven design approach with DDDManager class

DDDManager::setDomain('users');

Sample file structure:

app/
    domains/
        users/
            models/
            controllers/
            views/
            services/
            ...
        posts/
            models/
            controllers/
            views/
            services/
            ...

• Route main parameters

#[Route('/foo/{mainParam}')]
public class FooController {
	public $mainParam;
}

#[Route('/foo/{_setMainParam()}')]
public class FooController {
        private $mainParam;

	pubic function _setMainParam(string $p){
	    $this->mainParam=$p;
     }
}

Fixed

• Tests pb (codeception vulnerability)
• AssetsManager js and css attributes pb (no open issue)
• default index.html W3C validation errors

Updated

• light opt : parseURI and getNS methods

Added

• [ORM] Update cascade behavior
• boolean transformer
• main params for routes
• MultiResourceCRUDController Crud controller with index for several models
• [ORM] aggregate uQueries (count, sum, min, max, avg)

Fixed

• [DAO] Fix Where pb with count method
• [DAO] Fix Where pb with exists method

Updated

• default index page

Before creating a new project, be sure to update the devtools if they are installed globally:

composer global update

Added

• mass update in DAO class (updateAll)
• type checker for routes params (int, bool=>regex)
• status code for router (200, 404, 405)

Fixed

• autowiring pb with ReflectionType
• Mysql pb: replace parser cast for Mysql/mariaDB diff
• ManyToMany update pb (no open issue)

Updated

Models generation

• The regeneration of models preserves the code implemented on the existing models.

CRUD controllers

• Add custom default buttons to dataTable (returned by ModelViewer::getDataTableRowButtons())
• Add onNewInstance($instance) event
• Add name paramteter in onGenerateFormField($field, $nb, $name) event
• Add methods for modal title and message (getFormModalTitle($instance) and formHasMessage())
• Add hook for form modal buttons (onFormModalButtons($btOkay, $btCancel))

Application root (breaking change)

• For apache and nginX, root folder is set to public folder

For an old project (created with a version prior to 2.4.5), you have to modify index.php and move the index.php and .htaccess files to the public folder.

   <?php
   define('DS', DIRECTORY_SEPARATOR);
   //Updated with index.php in public folder
   define('ROOT', __DIR__ . DS . '../app' . DS);
   $config = include_once ROOT . 'config/config.php';
   require_once ROOT . './../vendor/autoload.php';
   require_once ROOT . 'config/services.php';
   \Ubiquity\controllers\Startup::run($config);

Added

• UArrayModels class for array of models manipulation (GroupBy, asKeyValues, sorting...)
• UModel class for models manipulation (property updating...)
• ubiquity-debug integration

Before creating a new project, be sure to update the devtools:

composer global update

Fixed

• Boolean types pb #174
• ResponseFormatter import #173
• DAO PostgreSQL
  • ConditionParser pb with cast #172
  • Null values on fk #171

Added

• Dark mode for CRUD controllers (setStyle('inverted'))
• CRUD hooks
  • onBeforeUpdate(object $instance, bool $isNew)
  • onBeforeUpdateRequest(array &$requestValues, bool $isNew)
• Twig
  • isAllowedRoute(role, routeName) added if ubiquity-acl is present.

Updated

Validators

• Model validators can be used on the client side (used by default for CRUD controllers).

Routing

• Start router cache indexing (for routes with parameters) => This cache indexing is not yet used in production.

Fixed

• fix Startup::getTemplateEngineInstance method name.
• AuthController finalize and initialize pb with bad creditentials(no open issue)
• Make manyToOne dropdowns clearable in CRUD controllers for fk null values.
• DI parser pb (no open issue)

Breaking change possible

Rest controllers refactoring

• Removed: SimpleRestController, RestController => Use the RestBaseController or RestResourceController class instead
• Added:
  • JsonRestController => for simple Json REST API
  • RequestFormatter, JsonRequestFormatter, JsonApiRequestFormatter => for JSON api, JSON or url-encoded requests
• Updated (for request with authorization - accesstoken):
  • The checkPermissions method in REST controllers must be overridden to check the data associated with an authentication token.
  • checkPermissions must be used in conjunction with the connect method to override as well.

Added

• ViewRepository CRUD operations + Automatic passing of the handled objects to the view
• AbstractRepository only CRUD operations for overriding
• Repository a default repository for any model
• getAllByIds method in DAO part

Fixed

• Fix cache generation pb for field names & dbTypes

Updated

• Update route default name (ControllerName-{controller}.action)

devtools

• livereload for php embedded web server

Fixed

• consecutive Bulk updates pb
• Models cache generation pb (php8 attributes have no inheritance support.) => no open issue

Added

• Dark theme for CRUD controllers

Documentation

• Security part
• ACL part
• Attributes/annotations update

Added

• PHP8 attributes support => with PHP8, Ubiquity uses the PHP8 attributes system for annotations (Router, ORM, Validators...).
• password_verify method to URequest

Updated

• CRUD and Auth controllers no longer use twig inheritance on views by default: It is easier to customize the display.

Added

• ACL Manager in ubiquity-acl repository

Fixed

• Update php version in composer.json for php 8
• DAOUqueries pb with parentheses in condition
• Password hash algo type (no open issue)
• DB Logging omitted (no open issue)

Added

• Named db statements for async platforms
• Rest events on insert and update BEFORE_INSERT = 'rest.before.insert' and BEFORE_UPDATE = 'rest.before.update'
• insertGroups method (inserts in an implicit transaction)
• quote options for PDO wrappers
• ApplicationStorage for global variables with async platforms (Swoole, Workerman, ngx_php...)

Fixed

• [orm] oneToMany and manyToMany loading pb with 2.3.11 version see #145

Tests

• Adding tests
• increase of coverage to 73%.

Added

• DAOCache (caches objects loaded by id)
• MemcachedDriver system
• RedisDriversystem

Updated

• fomantic-ui 2.8.6
• default index view relooking
• Cache system and ArrayCache refactoring
• light opt for async view and dbWrapper getStatement

Fixed

• [rest] no violations on insert with ValidatorManager see #122
• [rest] Validation on insertion should be complete see #123
• [postgresql] pb wth PgsqlDriverMetas (names protection) see #128
• [postgresql] Insert fail with non autoinc pk see #129
• [webtools][models] click on Nothing to display generates an error see #130
• [webtools][models] instances count not updated see #131
• Session names with non allowed characters see #134
• SimpleViewAsyncController pb with cache (no open issue)

Added

• transformer for UCookie (for Crypto)
• getter on session Csrf protection
• security level to csrf protection (0 => no secure)

Updated

• fomantic-ui 2.8.5

Added

• put, patch, delete, options annotations added for router (see #108)

Fixed

• Router cache Content-Type omited see #120
• ORM: pbs on column annotation see #116 and #117

Added

• Add csrf functions to twig templates

Updated

• Update client libraries for new projects (Fomantic 2.8.4, jQuery 3.5.1)
• Update to Twig 3.0

Added

• add password_hash to URequest
• add exists method in DAO
• Add Csrf protection to session

Updated

• AuthController simplification
• remove unnecessary "No route found log"

Fixed

• Fix require php7.4 in composer.json file #111
• Fix @transient annotation pb #113
• Fix non autoinc pk not affected on insert #114

Fixed

• Fix persistent /_default/ for default url (twig path) (no open issue)
• Fix redirectToRoute pb (with _default route) (no open issue)

Added

• updateGroups method for batch updates (mysql bulks)
• Aditional fields in queries Fixes #83
• Composer part in webTools

Updated

• PostgreSQL PDO Driver created for PostgreSQL Database Support Fixes #98
• Sqlite PDO Driver created for SQLite Database Support Fixes #90

Fixed

• @idcolumn name pb #107
• [REST] with POST method returns 500 error, and 'controllers/rest' class not found #89

Added

• mailer module see https://github.com/phpMv/ubiquity-mailer
• SimpleViewController, SimpleViewAsyncController for php views (without template engine)
• PHP 7.4 preloading see https://github.com/phpMv/ubiquity/issues/88
• ObjectCache cache system
• SDAO class for simple objects loading (popo with public members)
• Prepared DAO queries for getOne, getById & getAll (async)

Improved

• Add warmup methods for controllers & models metas
• StartupAsync for asynchronous platforms (Swoole, Workerman)
• unpack replace cufa in Startup::runAction

Added

• bulk queries in DAO class
  • DAO::toAdd($instance)
  • DAO::toUpdate($instance)
  • DAO::toDelete($instance)
  • DAO::flush()
• Composer create-project

composer create-project phpmv/ubiquity-project {projectName}

Changed

• MicroTemplateEngine optimization (cache)

Added

• workerman server

Usage:

Ubiquity serve -t=workerman -p=8091

• Memcached support
• multi db types support (Db Wrapper)
  • Tarantool database support on a proposal from @zilveer
  • Swoole coroutine Mysql database support
  • Mysqli database support
  • PDO default wrapper (updated)

Updated

• PhpFastCache to ^7.0

Fixed

• UQuery multi models fatal error (see #63)

Added

• multi databases feature on a proposal from @Gildonei

Changed

• Startup class optimization

Breaking change possible

Induced by multi database functionality:

• Database startup with DAO::startDatabase($config) in services.php file is useless, no need to start the database, the connection is made automatically at the first request.
• Use DAO::start() in services.php file when using several databases (with multi db feature)

For optimization reasons:

• the classes used only in development (common to devtools and webtools) have been relocated in the phpmv/ubiquity-dev package.

Migration

For new projects:

• Update devtools: composer global update

For existing projects:

• composer update in project folder
• Remove DAO::startDatabase($config) line in services.php

Fixed

• route caching pb for routes with variables (no open issue)

Documentation

• Add Jquery and Semantic-UI part
• Add Webtools presentation

Added

• Web-tools
  • Maintenance mode (see https://github.com/phpMv/ubiquity/issues/49)
  • Updates checking for cache (modifications)
  • Customization (tools)

Deleted/updated

• Webtools removed from Ubiquity main repository and are in there own repo

Use composer require phpmv/ubiquity-webtools to install them.

Breaking change possible:

Classes relocation

• Ubiquity\controllers\admin\utils\CodeUtils->Ubiquity\utils\base\CodeUtils
• Ubiquity\controllers\admin\interfaces\HasModelViewerInterface->Ubiquity\controllers\crud\interfaces\HasModelViewerInterface
• Ubiquity\controllers\admin\viewers\ModelViewer->Ubiquity\controllers\crud\viewers\ModelViewer
• Ubiquity\controllers\admin\popo\CacheFile -> Ubiquity\cache\CacheFile
• Ubiquity\controllers\admin\popo\ControllerSeo -> Ubiquity\seo\ControllerSeo
• Ubiquity\controllers\admin\traits\UrlsTrait -> Ubiquity\controllers\crud\traits\UrlsTrait

Migration

• Update devtools: composer global update
• In existing projects: composer require phpmv/ubiquity-webtools for webtools installation.

Fixed

• Router: pb with route priority attribute see #54