Moved Model methods save(), create(), update(), delete(), and refresh() to Models Manager

CHANGELOG-4.0.md

@@ -9,3 +9,25 @@
 - Change catch Exception to Throwable [#12288](https://github.com/phalcon/cphalcon/issues/12288)
 - Removed deprecated methods (`Cli\Console::addModules()`, `Debug::getMajorVersion()`, `Http\Request::isSoapRequested()`, `Http\Request::isSecureRequest()`, `Mvc\Model\Criteria::addWhere()`, `Mvc\Model\Criteria::order()`, `Validation\Validator::isSetOption()`, `Security::hasLibreSsl()`, `Security::getSslVersionNumber()`).
 - Renamed `Http\RequestInterface::isSoapRequested()` to `isSoap()` and `Http\RequestInterface::isSecureRequest()` to `isSecure()`.
+- Moved `Model::save()`, `Model::create()`, `Model::update()` and `Model::delete()` to Models Manager.
+- Moved `Model::refresh()` to Models Manager.
+- Added `ModelInterface::isSkipped()`.
+- Added `ModelInterface::clearMessages()`.
+- Added `ModelInterface::cancelOperation()` (was previously protected in Model).
+- Added `ModelInterface::setOperationMade()`.
+- Added `ModelInterface::exists()` (was previously protected in Model).
+- Added `ModelInterface::updateSnapshot()`, `ModelInterface::{get,set}UniqueKey()`, `ModelInterface::{get,set}UniqueParams()`, `ModelInterface::{get,set}UniqueTypes()`, `ModelInterface::resetUniqueParams()`.
+- Moved `Model::exists()` to Models Manager.
+- Moved `Model::find()` and `Model::findFirst()` to Model Repository.
+- Moved `Model::count()`, `Model::minimum()`, `Model::maximum()`, `Model::average()`, `Model::sum()` to Models Repository.
+- Moved `Model::query()` to Model Repository.
+- Removed Model namespace aliases.
+- You can no longer assign data to models in the constructor.
+- Removed `Model::cloneResult()`.
+- Added custom Model Repositories.
+- You can no longer overwrite `Model::getSource()`.
+- Moved `Model::useDynamicUpdate()` to Models Repository.
+- Moved `Model::{get,set}Source()` and `Model::{get,set}Schema()` to Models Repository.
+- Moved column maps to Model Repository.
+- Moved `Model::{get,set}{Read,Write,}ConnectionService()` to Models Repository.
+- Removed `ModelManager::getLastInitialized()`.

phalcon/cache/frontend/data.zep

@@ -30,6 +30,8 @@ use Phalcon\Cache\FrontendInterface;
  * use Phalcon\Cache\Backend\File;
  * use Phalcon\Cache\Frontend\Data;
  *
+ * $robotsRepository = $modelsManager->getRepository(Robots::class);
+ *
  * // Cache the files for 2 days using a Data frontend
  * $frontCache = new Data(
  *     [
@@ -55,7 +57,7 @@ use Phalcon\Cache\FrontendInterface;
  * if ($robots === null) {
  *     // $robots is null due to cache expiration or data does not exist
  *     // Make the database call and populate the variable
- *     $robots = Robots::find(
+ *     $robots = $robotsRepository->find(
  *         [
  *             "order" => "id",
  *         ]

phalcon/cache/frontend/igbinary.zep

@@ -29,6 +29,8 @@ use Phalcon\Cache\FrontendInterface;
  * Allows to cache native PHP data in a serialized form using igbinary extension
  *
  *<code>
+ * $robotsRepository = $modelsManager->getRepository(Robots::class);
+ *
  * // Cache the files for 2 days using Igbinary frontend
  * $frontCache = new \Phalcon\Cache\Frontend\Igbinary(
  *     [
@@ -54,7 +56,7 @@ use Phalcon\Cache\FrontendInterface;
  * if ($robots === null) {
  *     // $robots is null due to cache expiration or data do not exist
  *     // Make the database call and populate the variable
- *     $robots = Robots::find(
+ *     $robots = $robotsRepository->find(
  *         [
  *             "order" => "id",
  *         ]

phalcon/cache/frontend/msgpack.zep

@@ -34,6 +34,8 @@ use Phalcon\Cache\Exception;
  * use Phalcon\Cache\Backend\File;
  * use Phalcon\Cache\Frontend\Msgpack;
  *
+ * $robotsRepository = $modelsManager->getRepository(Robots::class);
+ *
  * // Cache the files for 2 days using Msgpack frontend
  * $frontCache = new Msgpack(
  *     [
@@ -59,7 +61,7 @@ use Phalcon\Cache\Exception;
  * if ($robots === null) {
  *     // $robots is null due to cache expiration or data do not exist
  *     // Make the database call and populate the variable
- *     $robots = Robots::find(
+ *     $robots = $robotsRepository->find(
  *         [
  *             "order" => "id",
  *         ]

phalcon/cache/frontend/none.zep

@@ -28,6 +28,7 @@ use Phalcon\Cache\FrontendInterface;
  *
  *<code>
  *<?php
+ * $robotsRepository = $modelsManager->getRepository(Robots::class);
  *
  * //Create a None Cache
  * $frontCache = new \Phalcon\Cache\Frontend\None();
@@ -50,7 +51,7 @@ use Phalcon\Cache\FrontendInterface;
  * if ($robots === null) {
  *     // This cache doesn't perform any expiration checking, so the data is always expired
  *     // Make the database call and populate the variable
- *     $robots = Robots::find(
+ *     $robots = $robotsRepository->find(
  *         [
  *             "order" => "id",
  *         ]

phalcon/db/rawvalue.zep

@@ -32,7 +32,7 @@ namespace Phalcon\Db;
  * $subscriber->email     = "[email protected]";
  * $subscriber->createdAt = new \Phalcon\Db\RawValue("now()");
  *
- * $subscriber->save();
+ * $modelsManager->save($subscriber);
  *</code>
  */
 class RawValue