Check and showcase new enumOnly() validation. (#76)

* Check and showcase new enumOnly() validation.

* Check and showcase new enumOnly() validation.

* Update annotations.

* Update enum_validation.php

* update lock file.

* update lock file.

* Adjust constraint

composer.json

@@ -20,7 +20,7 @@
 		"php": ">=8.2",
 		"spryker/cakephp-statemachine": "dev-master",
 		"cakephp/plugin-installer": "^2.0.1",
-		"cakephp/cakephp": "^5.0.3",
+		"cakephp/cakephp": "^5.1.0",
 		"cakephp/bake": "^3.0.2",
 		"mobiledetect/mobiledetectlib": "4.*",
 		"dereuromark/cakephp-comments": "dev-master",

plugins/Sandbox/src/Controller/CakeExamplesController.php

@@ -48,6 +48,32 @@ public function enums() {
 		$this->set(compact('user'));
 	}
 
+	/**
+	 * @return \Cake\Http\Response|null|void
+	 */
+	public function enumValidation() {
+		$table = $this->fetchTable('Sandbox.SandboxUsers');
+		$table->getValidator()->add('status', 'validEnum', [
+			'rule' => ['enumOnly', [UserStatus::Active, UserStatus::Inactive]],
+			'message' => 'Invalid enum value.',
+		]);
+
+		$user = $table->newEmptyEntity();
+
+		if ($this->request->is(['post', 'put'])) {
+			$user = $table->patchEntity($user, $this->request->getData());
+			$value = $this->request->getData('status');
+			$label = UserStatus::tryFrom((int)$value)?->label();
+			if (!$user->getErrors()) {
+				$this->Flash->success('Value posted: `' . $value . '` (`' . $label . '`)');
+			} else {
+				$this->Flash->error('Value posted: `' . $value . '` (`' . $label . '`)');
+			}
+		}
+
+		$this->set(compact('user'));
+	}
+
 	/**
 	 * @return void
 	 */