v4.1.0

Supported PHP Versions: 7.2, 7.3, 7.4

Added

• Added JWT (JSON Web Tokens) support under Phalcon\Security\JWT. Offers support for:
  • Token
  • Parser
  • Builder
  • Validator
  • Signers (None, HMAC)
  • Base64 encode/decodeUrl helper class
    #13856
• Added additional HTML helpers under Phalcon\Html\Helper: Anchor, Base, Body, Button, Close, Element, Form, Img, Input\Color, Input\Date, Input\DateTime, Input\DateTimeLocal, Input\Email, Input\File, Input\Hidden, Input\Image, Input\Input, Input\Month, Input\Numeric, Input\Password, Input\Range, Input\Select, Input\Search, Input\Submit, Input\Tel, Input\Text, Input\Textarea, Input\Time, Input\Url, Input\Week, Label, Link, Meta, Ol, Script, Style, Title, Ul
  #14696
• Added Phalcon\Http\Request::getPreferredIsoLocaleVariant() to return the base language if this is a specific one (en vs en-US) #3135
• Added preload for Volt, which will send a HTTP/2 preload header #13128
• Added Phalcon\Helper\Arr::blackList() to exclude elements of an array by the keys obtained from the elements of a blacklist #14801 @TimurFlush
• Added Phalcon\Debug::renderHtml() to get a HTML representation of the exception #14794 @TimurFlush
• Added Phalcon\Mvc\Router\Annotations->setActionPreformatCallback($callback) to set a callback which pre-formats actions to custom pattern #14819
• Added new PDO wrapper for the Data Mapper implementation, with decorated instance, locator and profiler
  • Phalcon\DataMapper\Pdo\Connection
  • Phalcon\DataMapper\Pdo\Connection\Decorated
  • Phalcon\DataMapper\Pdo\Profiler\Profiler
  • Phalcon\DataMapper\Pdo\Profiler\MemoryLogger
  • Phalcon\DataMapper\Pdo\ConnectionLocator
    This component will be used in the Data Mapper implementation but can be used as a stand alone component for PDO connections. #14733
• Added new Query Builder, as well as a factory, for the Data Mapper implementation supporting CRUD with bound parameters
  • Phalcon\DataMapper\Query\Bind
  • Phalcon\DataMapper\Query\Delete
  • Phalcon\DataMapper\Query\Insert
  • Phalcon\DataMapper\Query\Select
  • Phalcon\DataMapper\Query\Update
  • Phalcon\DataMapper\Query\QueryFactory
    This component can be used to create SQL statements using a fluent interface. Optionally the statements can be executed from the builder itself using the DataMapper\Pdo connection. #14734
• Added Phalcon\Mvc\Micro\LazyLoader::getHandler() to return real handler when using lazy loaded controllers for Phalcon\Mvc\Micro #14871 @Jurigag
• Added Phalcon\Collection\CollectionInterface and Phalcon\Config\ConfigInterface to use as typehints when extending or implementing custom classes #15106 @BeMySlaveDarlin
• Added Phalcon\Db\Adapter\AdapterInterface::getDefaultValue() and supportsDefaultValue() methods to properly support the DEFAULT keyword #15180
• Added Phalcon\Db\Adapter\AbstractAdapter::supportsDefaultValue() method to properly support the DEFAULT keyword #15180

Changed

• Added service checks for the session. Now cookies will be saved in the session only when the session service is defined #11770, #14649
• Changed Phalcon\Db\Adapter\*::getRawSQLStatement() to return the full SQL query with parameters #12196
• Changed Phalcon\Filter::sanitize to throw a E_USER_NOTICE when a filter does not exist. #14679
• PHQL now supports the use of any printable characters from the extended ASCII table for escaped identifiers. The exception characters are [ and ]. To use [ and ] escape they (\[, \]) #14535
• Removed UTF-8 charset when using Phalcon\Http\Response::setJsonContent to apply with rfc7159
• Changed the visibility of properties in Phalcon\Http\Message\Uri to work with clone. #15040
• Change Phalcon\Validation\AbstractValidator::__construct. Save custom validator message in options. #15053 @ivan-zolotavin
• Add proxy methods without _ prefix in methods names: getRelatedRecords(), groupResult(), exists(), preSaveRelatedRecords(), preSave(), doLowUpdate(), postSaveRelatedRecords(), postSave(), cancelOperation(), doLowInsert(), getConnection(), getConnectionService(), getVersion(), getSpecial() #14971
• Modified Phalcon\Mvc\Model\Relation to accept callable params for model relations. #15158

Fixed

• Fixed Phalcon\Db\Dialect\Mysql::getColumnDefinition to recognize size for DATETIME, TIME and TIMESTAMP columns #13297
• Fixed Phalcon\Events\Manager to provide callable support #13322, #15045
• Fixed Phalcon\Validation\Validator\Uniqueness fixed except query #15084
• Fixed Phalcon\Mvc\Model to also check the params option in cascade relations when deleting #15098
• Fixed Phalcon\Mvc\Model to also check the params option in restricted relations when deleting #15172
• Fixed Phalcon\Mvc\Model::findFirst() to return correct value #15077
• Fixed Phalcon\Mvc\Model\CriteriaInterface::where() parameters #15144
• Fixed Phalcon\Http\Response\Cookies::set() to utilize the options parameter correctly #15129
• Fixed Phalcon\Http\Cookie::send() to define options parameter #15142
• Fixed Phalcon\Crypt performance issues. #15118
• Fixed Phalcon\Mvc\Router\Route unicode support in patterns #15102
• Fixed fatal error in Phalcon\Mvc\Model::cloneResultMap() when column map is used with orm.cast_on_hydrate turned on. #14617
• Fixed Phalcon\Mvc\Model::sum(), average(), minimum(), maxmium(), count() to utilize the transaction parameter. #15113
• Fixed Phalcon\Mvc\Model::__set() to clear dirtyRelated when empty array is set. #14822
• Fixed Phalcon\Mvc\Model to skip columns with default values when the DEFAULT keyword is not supported by the database adapter (SQLite) #15180
• Fixed Phalcon\Mvc\Router to handle numeric routes properly #14926
• Fixed Phalcon\Session\Adapter\Redis and Phalcon\Session\Adapter\Libmemcached to utilize the prefix option #15184
• Fixed Phalcon\Mvc\Model to save the modified properties of previously queried single related records. #15148

Removed

• Removed Phalcon\Http\Cookie binding to session #11770
  • Phalcon\Http\Cookie no longer depends on the session service and data will not be duplicated in the session. This made it difficult to use cookies in stateless applications (SPA).
• Removed unused property Phalcon\Mvc\Router::uriSource. #15123