Deprecate internal extension functions in favor of methods on the extension classes

CHANGELOG

@@ -1,7 +1,9 @@
-# 3.8.1 (2023-XX-XX)
+# 3.9.0 (2023-XX-XX)
 
  * Add return type for Symfony 7 compatibility
  * Fix premature loop exit in Security Policy lookup of allowed methods/properties
+ * Deprecate all internal extension functions in favor of methods on the extension classes
+ * Mark all extension functions as @internal
 
 # 3.8.0 (2023-11-21)
 

composer.json

@@ -26,6 +26,7 @@
     "require": {
         "php": ">=7.2.5",
         "symfony/polyfill-php80": "^1.22",
+        "symfony/deprecation-contracts": "^2.5|^3",
         "symfony/polyfill-mbstring": "^1.3",
         "symfony/polyfill-ctype": "^1.8"
     },

doc/deprecated.rst

@@ -10,3 +10,10 @@ Functions
 
  * The `twig_test_iterable` function is deprecated; use the native
    `is_iterable` instead.
+
+Extensions
+----------
+
+* All functions defined in Twig extensions are marked as internal as of Twig
+  3.9.0, and will be removed in Twig 4.0. They have been replaced by internal
+  methods on their respective extension classes.