chore: add deprecated to php

Author: ChiragAgg5k

src/SDK/SDK.php

@@ -164,8 +164,18 @@ public function __construct(Language $language, Spec $spec)
         }, ['is_safe' => ['html']]));
         $this->twig->addFilter(new TwigFilter('comment1', function ($value) {
             $value = explode("\n", $value);
+            $prefix = "     * ";
+            $prefixLength = strlen($prefix);
+            $maxLineLength = 75 - $prefixLength;
+            
             foreach ($value as $key => $line) {
-                $value[$key] = "     * " . wordwrap($line, 75, "\n     * ");
+                if (empty(trim($line))) {
+                    $value[$key] = $prefix;
+                    continue;
+                }
+                
+                $wrapped = wordwrap($line, $maxLineLength, "\n" . $prefix, true);
+                $value[$key] = $prefix . $wrapped;
             }
             return implode("\n", $value);
         }, ['is_safe' => ['html']]));

templates/php/src/Services/Service.php.twig

@@ -31,6 +31,7 @@ class {{ service.name | caseUcfirst }} extends Service
      }
 
 {% for method in service.methods %}
+{% set deprecated_message = '' %}
     /**
 {% if method.description %}
 {{ method.description|comment1 }}
@@ -41,6 +42,15 @@ class {{ service.name | caseUcfirst }} extends Service
 {% endfor %}
      * @throws {{spec.title | caseUcfirst}}Exception
      * @return {{ method | getReturn }}
+{% if method.deprecated %}
+     *
+{% set method_name = method.replaceWith | split('.') | last | caseCamel %}
+{% set deprecated_message = deprecated_message ~ 'Please use ' ~ method_name ~ '() instead.' %}
+     * @deprecated {{ deprecated_message }}
+{% if method.replaceWith %}
+     * @see {{ method.replaceWith | replace({'.': '::'}) | capitalizeFirst }}
+{% endif %}
+{% endif %}
      */
     public function {{ method.name | caseCamel }}({% for parameter in method.parameters.all %}{% if not parameter.required or parameter.nullable %}?{% endif %}{{ parameter | typeName }} ${{ parameter.name | caseCamel | escapeKeyword }}{% if not parameter.required %} = null{% endif %}{% if not loop.last %}, {% endif %}{% endfor %}{% if 'multipart/form-data' in method.consumes %}, callable $onProgress = null{% endif %}): {{ method | getReturn }}
     {