From f5e62a5eb57ad9ea8012e46455ae351e1d7727f3 Mon Sep 17 00:00:00 2001
From: Miljan Ilic <hello@miljanilic.com>
Date: Fri, 8 Mar 2024 22:12:25 +0100
Subject: [PATCH] Add SensitiveParameter Attribute Polyfill

---
 composer.json                        |  1 +
 src/Attribute/SensitiveParameter.php | 21 +++++++++++++++++++++
 2 files changed, 22 insertions(+)
 create mode 100644 src/Attribute/SensitiveParameter.php

diff --git a/composer.json b/composer.json
index 68b117a..d8725c6 100644
--- a/composer.json
+++ b/composer.json
@@ -7,6 +7,7 @@
         "psr-4": {
             "IlicMiljan\\SecureProps\\": "src/"
         },
+        "files": ["src/Attribute/SensitiveParameter.php"],
         "exclude-from-classmap": ["tests/"]
     },
     "autoload-dev": {
diff --git a/src/Attribute/SensitiveParameter.php b/src/Attribute/SensitiveParameter.php
new file mode 100644
index 0000000..5a22133
--- /dev/null
+++ b/src/Attribute/SensitiveParameter.php
@@ -0,0 +1,21 @@
+<?php
+
+// phpcs:disable PSR1.Classes.ClassDeclaration.MissingNamespace
+
+/**
+ * Polyfill for the SensitiveParameter attribute introduced in PHP 8.2.
+ *
+ * This polyfill allows code targeting PHP versions earlier than 8.2 to use the
+ * SensitiveParameter attribute without causing syntax errors. It's a no-op in
+ * older PHP versions but enables forward compatibility with PHP 8.2 and newer.
+ */
+
+if (PHP_VERSION_ID < 80200) {
+    #[Attribute(Attribute::TARGET_PARAMETER)]
+    final class SensitiveParameter
+    {
+        public function __construct()
+        {
+        }
+    }
+}