更新 README。

pardnchiu · pardnchiu · commit c7bf8304d241 · 2025-02-03T03:38:31.000+08:00
diff --git a/README.md b/README.md
@@ -1,4 +1,4 @@
-# PDPHP\Async (PHP Library)
+# PD\Async
 
 > PDPHP\Async is a PHP library using ReactPHP to perform asynchronous tasks, supporting task dependency handling and topological sorting.
 
@@ -7,87 +7,73 @@
 - Handling of Task Dependencies
 - Ensuring correct execution order via Topological Sorting
 
-## 創建者 / Creator
+## How to Use
 
-<img src="https://pardn.io/image/head-s.jpg" align="left" style="float: left; margin-right: 0.5rem; width: 96px; height: 96px;" />
+### Install
 
-<h4 style="padding-top: 0">邱敬幃 Pardn Chiu</h4>
+```SHELL
+composer require pardnchiu/async
+```
+
+### Use
+
+```PHP
+<?php
 
-[![](https://pardn.io/image/mail.svg)](mailto:mail@pardn.ltd) [![](https://skillicons.dev/icons?i=linkedin)](https://linkedin.com/in/pardnchiu) 
+use PDPHP\Async;
+
+$tasks = [
+    'task1' => [
+        'method' => function () {
+            return 'result1';
+        },
+        'tasks' => [],
+    ],
+    'task2' => [
+        'method' => function () {
+            return 'result2';
+        },
+        'tasks' => ['task1'], // Run after task1
+    ],
+    'task3' => [
+        'method' => function () {
+            return 'result3';
+        },
+        'tasks' => ['task1'], // Run after task1
+    ],
+    'task4' => [
+        'method' => function () {
+            return 'result3';
+        },
+        'tasks' => ['task2'], // Run after task2
+    ],
+];
+
+Async::run($tasks)
+    ->then(function ($results) {
+        print_r($results);
+    })
+    ->catch(function ($error) {
+        echo 'Error: ' . $error->getMessage();
+    });
+```
 
 ## License
 
-This source code project is licensed under the [GPL-3.0](https://github.com/pardnchiu/PDMarkdownKit/blob/main/LICENSE) license.
+This source code project is licensed under the [MIT](https://github.com/pardnchiu/PHPAsync/blob/main/LICENSE) license.
 
-## How to Use
+## Creator
 
-- PHP version 7.4 or later
-- Download `Async.php` and place it in the directory `src/PDPHP`
-- Add dependencies in `composer.json`
-    ```JSON
-    {
-        "require": {
-            "react/promise": "^2.8 || ^3.0",
-            "react/event-loop": "^1.1 || ^2.0"
-        },
-        "autoload": {
-            "psr-4": {
-                "PD\\": "src/PDPHP/"
-            }
-        }
-    }
-    ```
-- Install dependencies
-    ```SHELL
-    composer install
-    ```
-- Example
-    ```PHP
-    <?php
-
-    require 'vendor/autoload.php';
-
-    use PDPHP\Async;
-
-    $tasks = [
-        'task1' => [
-            'method' => function () {
-                return 'result1';
-            },
-            'tasks' => [],
-        ],
-        'task2' => [
-            'method' => function () {
-                return 'result2';
-            },
-            'tasks' => ['task1'], // Run after task1
-        ],
-        'task3' => [
-            'method' => function () {
-                return 'result3';
-            },
-            'tasks' => ['task1'], // Run after task1
-        ],
-        'task4' => [
-            'method' => function () {
-                return 'result3';
-            },
-            'tasks' => ['task2'], // Run after task2
-        ],
-    ];
-
-    Async::run($tasks)
-        ->then(function ($results) {
-            print_r($results);
-        })->catch(function ($error) {
-            echo 'Error: ' . $error->getMessage();
-        });
-    ```
+<img src="https://avatars.githubusercontent.com/u/25631760" align="left" width="96" height="96" style="margin-right: 0.5rem;">
 
-***
+<h4 style="padding-top: 0">邱敬幃 Pardn Chiu</h4>
 
-*All translations powered by ChatGPT*
+<a href="mailto:dev@pardn.io" target="_blank">
+    <img src="https://pardn.io/image/email.svg" width="48" height="48">
+</a> <a href="https://linkedin.com/in/pardnchiu" target="_blank">
+    <img src="https://pardn.io/image/linkedin.svg" width="48" height="48">
+</a>
 
 ***
 
-©️ 2024 [邱敬幃 Pardn Chiu](https://www.linkedin.com/in/pardnchiu)
+©️ 2024 [邱敬幃 Pardn Chiu](https://pardn.io)
diff --git a/composer.json b/composer.json
@@ -11,7 +11,7 @@
     ],
     "minimum-stability": "stable",
     "require": {
-        "php": ">=8.0",
+        "php": ">=7.4",
         "react/promise": "^2.8 || ^3.0",
         "react/event-loop": "^1.1 || ^2.0"
     },
diff --git a/src/Async.php b/src/Async.php
@@ -13,24 +13,20 @@ public static function run($tasks)
         // 獲取事件循環實例
         $loop = Loop::get();
 
-        // 初始化任務流程和方法數組
         $flow = [];
         $methods = [];
 
-        // 遍歷所有的任務
         foreach ($tasks as $taskKey => $task) {
-            // 提取每個任務的方法
             $methods[$taskKey] = $task['method'];
 
-            // 如果該任務沒有依賴的任務，設置為空數組；否則，保存依賴的任務
             if (empty($task['tasks'])) {
                 $flow[$taskKey] = [];
             } else {
                 $flow[$taskKey] = $task['tasks'];
             };
         };
 
-        // 對任務流程進行拓撲排序，確保任務按正確的順序執行
+        // 對任務流程進行拓撲排序，確保正確的執行順序
         $sortedFlow = self::topologicalSort($flow);
 
         // 創建所有的任務，並根據排序好的流程和查詢參數
@@ -50,68 +46,64 @@ public static function run($tasks)
             });
     }
 
-    // 排序任務流程，使用拓撲排序算法
+    // 排序任務流程
     private static function topologicalSort($flow)
     {
-        $sorted = [];  // 已排序的任務
-        $visited = []; // 已訪問的任務
-        $temporary = []; // 臨時訪問的任務，用於檢測循環依賴
+        $sorted = [];
+        $visited = [];
+        $temporary = [];
 
-        // 遍歷所有任務
         foreach ($flow as $taskKey => $tasks) {
-            // 對每個任務進行訪問
             if (is_int($taskKey)) {
                 $taskKey = $tasks;
                 $tasks = [];
-            };
+            }
 
             if (!isset($visited[$taskKey])) {
                 self::visit($taskKey, $flow, $visited, $sorted, $temporary);
-            };
-        };
+            }
+        }
 
-        // 返回反轉後的排序結果，確保正確的順序
         return array_reverse($sorted);
     }
 
     private static function visit($taskKey, $flow, &$visited, &$sorted, &$temporary)
     {
-        // 如果在臨時數組中找到該任務，說明存在循環依賴
         if (isset($temporary[$taskKey])) {
             throw new \Exception("Circular dependency detected: " . $taskKey);
-        };
+        }
 
-        // 如果該任務還沒有被訪問過
         if (!isset($visited[$taskKey])) {
-            $temporary[$taskKey] = true; // 標記為臨時訪問
+            $temporary[$taskKey] = true;
 
-            // 遍歷該任務的所有依賴任務
             if (isset($flow[$taskKey])) {
                 foreach ($flow[$taskKey] as $task) {
                     self::visit($task, $flow, $visited, $sorted, $temporary);
-                };
-            };
+                }
+            }
 
-            unset($temporary[$taskKey]); // 移除臨時標記
-            $visited[$taskKey] = true; // 標記為已訪問
-            $sorted[] = $taskKey; // 添加到已排序的數組中
-        };
+            unset($temporary[$taskKey]);
+            $visited[$taskKey] = true;
+            $sorted[] = $taskKey;
+        }
     }
 
 
-    // 創建所有任務
+    // 創建任務
     private static function createTasks($methods, $flow, $sortedKeys, $loop)
     {
-        $tasks = []; // 初始化任務數組
-        $resolvedTasks = []; // 初始化已解決的任務數組
+        // 初始化任務數組
+        $tasks = [];
+        // 初始化已解決的任務數組
+        $resolvedTasks = [];
 
         // 遍歷排序後的任務鍵
         foreach ($sortedKeys as $taskKey) {
             // 獲取該任務的前置任務
             $dependentTasks = isset($flow[$taskKey]) ? $flow[$taskKey] : [];
             // 創建並儲存該任務
             $tasks[$taskKey] = self::createTask($methods, $taskKey, $dependentTasks, $resolvedTasks, $loop);
-        };
+        }
 
         // 返回創建的所有任務
         return $tasks;
@@ -123,7 +115,7 @@ private static function createTask($methods, $taskKey, $tasks, &$resolvedTasks,
         // 如果該任務已經被解決，直接返回已解決的任務
         if (isset($resolvedTasks[$taskKey])) {
             return $resolvedTasks[$taskKey];
-        };
+        }
 
         // 創建一個新的 Promise 延遲對象
         $deferred = new Promise\Deferred();
@@ -134,10 +126,10 @@ private static function createTask($methods, $taskKey, $tasks, &$resolvedTasks,
             // 如果前置任務尚未解決，創建前置任務
             if (!isset($resolvedTasks[$task])) {
                 $resolvedTasks[$task] = self::createTask($methods, $task, [], $resolvedTasks, $loop);
-            };
+            }
             // 將前置任務的 Promise 添加到數組中
             $taskPromises[] = $resolvedTasks[$task];
-        };
+        }
 
         // 當所有前置任務解決後，執行當前任務
         Promise\all($taskPromises)->then(function () use ($methods, $taskKey, $deferred) {
