Generate multiple examples for the same operations.

Author: sibprogrammer

plain/generate_docs.php

@@ -100,21 +100,41 @@ function getRequestTitle($request)
 $log = json_decode(file_get_contents('execution.log'), true);
 $examples = [];
 $menu = [];
+$contentHashes = [];
 
 foreach ($log as $record) {
     $trace = join(';', array_column($record['trace'], 'file'));
     if (preg_match('/ApiClientTest\.php/', $trace)) {
         continue;
     }
 
-    $title = getRequestTitle($record['request']);
-    $name = str_replace(' > ', '-', $title);
+    $origTitle = $title = getRequestTitle($record['request']);
+    $origName = $name = str_replace(' > ', '-', $title);
 
-    if (array_key_exists($name, $examples)) {
+    $index = 2;
+    while (array_key_exists($name, $examples)) {
+        $title = $origTitle . " ($index)";
+        $name = $origName . '-' . $index++;
+    }
+
+    $contentHash = md5(preg_replace('/>([^<]+?)</', '><', $record['request']));
+    if (array_key_exists($contentHash, $contentHashes)) {
         continue;
+    } else {
+        $contentHashes[$contentHash] = true;
     }
 
-    $titleParts = explode(' > ', $title);
+    $examples[$name] = [
+        'title' => $title,
+        'request' => $record['request'],
+        'response' => $record['response'],
+    ];
+}
+
+ksort($examples);
+
+foreach ($examples as $name => $example) {
+    $titleParts = explode(' > ', $example['title']);
     $operator = $titleParts[0];
     $menuItem = [
         'subTitle' => join(' > ', array_slice($titleParts, 1)),
@@ -126,12 +146,6 @@ function getRequestTitle($request)
     } else {
         $menu[$operator][] = $menuItem;
     }
-
-    $examples[$name] = [
-        'title' => $title,
-        'request' => $record['request'],
-        'response' => $record['response'],
-    ];
 }
 
 $title = 'Plesk XML-RPC Examples';