Translated the project to zh-TW

see webman-php#8

Author: asmarkhuang

src/plugin/admin/api/Auth.php

@@ -7,13 +7,13 @@
 use function admin;
 
 /**
- * 对外提供的鉴权接口
+ * 對外提供的鑑權介面
  */
 class Auth
 {
     /**
-     * 判断权限
-     * 如果没有权限则抛出异常
+     * 判斷權限
+     * 如果沒有權限則拋出異常
      * @param string $controller
      * @param string $action
      * @return void
@@ -29,7 +29,7 @@ public static function access(string $controller, string $action)
     }
 
     /**
-     * 判断是否有权限
+     * 判斷是否有權限
      * @param string $controller
      * @param string $action
      * @param int $code
@@ -39,44 +39,44 @@ public static function access(string $controller, string $action)
      */
     public static function canAccess(string $controller, string $action, int &$code = 0, string &$msg = ''): bool
     {
-        // 无控制器信息说明是函数调用，函数不属于任何控制器，鉴权操作应该在函数内部完成。
+        // 無控制器資訊說明是函數調用，函​​數不屬於任何控制器，鑑權操作應該在函數內部完成。
         if (!$controller) {
             return true;
         }
-        // 获取控制器鉴权信息
+        // 取得控制器鑑權資訊
         $class = new \ReflectionClass($controller);
         $properties = $class->getDefaultProperties();
         $noNeedLogin = $properties['noNeedLogin'] ?? [];
         $noNeedAuth = $properties['noNeedAuth'] ?? [];
 
-        // 不需要登录
+        // 不需要登入
         if (in_array($action, $noNeedLogin)) {
             return true;
         }
 
-        // 获取登录信息
+        // 取得登入資訊
         $admin = admin();
         if (!$admin) {
-            $msg = '请登录';
-            // 401是未登录固定的返回码
+            $msg = '請登入';
+            // 401是未登入固定的回傳碼
             $code = 401;
             return false;
         }
 
-        // 不需要鉴权
+        // 不需要鑑權
         if (in_array($action, $noNeedAuth)) {
             return true;
         }
 
-        // 当前管理员无角色
+        // 目前管理者無角色
         $roles = $admin['roles'];
         if (!$roles) {
-            $msg = '无权限';
+            $msg = '無權限';
             $code = 2;
             return false;
         }
 
-        // 角色没有规则
+        // 角色沒有規則
         $rules = Role::whereIn('id', $roles)->pluck('rules');
         $rule_ids = [];
         foreach ($rules as $rule_string) {
@@ -86,17 +86,17 @@ public static function canAccess(string $controller, string $action, int &$code
             $rule_ids = array_merge($rule_ids, explode(',', $rule_string));
         }
         if (!$rule_ids) {
-            $msg = '无权限';
+            $msg = '無權限';
             $code = 2;
             return false;
         }
 
-        // 超级管理员
+        // 超級管理員
         if (in_array('*', $rule_ids)){
             return true;
         }
 
-        // 如果action为index，规则里有任意一个以$controller开头的权限即可
+        // 如果action為index，規則裡有任一個以$controller開頭的權限即可
         if (strtolower($action) === 'index') {
             $rule = Rule::where(function ($query) use ($controller, $action) {
                 $controller_like = str_replace('\\', '\\\\', $controller);
@@ -105,18 +105,18 @@ public static function canAccess(string $controller, string $action, int &$code
             if ($rule) {
                 return true;
             }
-            $msg = '无权限';
+            $msg = '無權限';
             $code = 2;
             return false;
         }
 
-        // 查询是否有当前控制器的规则
+        // 查詢是否有目前控制器的規則
         $rule = Rule::where(function ($query) use ($controller, $action) {
             $query->where('key', "$controller@$action")->orWhere('key', $controller);
         })->whereIn('id', $rule_ids)->first();
 
         if (!$rule) {
-            $msg = '无权限';
+            $msg = '無權限';
             $code = 2;
             return false;
         }

src/plugin/admin/api/Install.php

@@ -5,26 +5,26 @@
 class Install
 {
     /**
-     * 安装
+     * 安裝
      *
      * @param $version
      * @return void
      */
     public static function install($version)
     {
-        // 导入菜单
+        // 導入選單
         Menu::import(static::getMenus());
     }
 
     /**
-     * 卸载
+     * 解除安裝
      *
      * @param $version
      * @return void
      */
     public static function uninstall($version)
     {
-        // 删除菜单
+        // 刪除選單
         foreach (static::getMenus() as $menu) {
             Menu::delete($menu['name']);
         }
@@ -40,29 +40,29 @@ public static function uninstall($version)
      */
     public static function update($from_version, $to_version, $context = null)
     {
-        // 删除不用的菜单
+        // 刪除不用的選單
         if (isset($context['previous_menus'])) {
             static::removeUnnecessaryMenus($context['previous_menus']);
         }
-        // 导入新菜单
+        // 匯入新選單
         Menu::import(static::getMenus());
     }
 
     /**
-     * 更新前数据收集等
+     * 更新前資料收集等
      *
      * @param $from_version
      * @param $to_version
      * @return array|array[]
      */
     public static function beforeUpdate($from_version, $to_version)
     {
-        // 在更新之前获得老菜单，通过context传递给 update
+        // 在更新前取得舊選單，透過context傳遞給 update
         return ['previous_menus' => static::getMenus()];
     }
 
     /**
-     * 获取菜单
+     * 取得選單
      *
      * @return array|mixed
      */
@@ -77,7 +77,7 @@ public static function getMenus()
     }
 
     /**
-     * 删除不需要的菜单
+     * 刪除不需要的選單
      *
      * @param $previous_menus
      * @return void

src/plugin/admin/api/Menu.php

@@ -7,13 +7,13 @@
 use function admin;
 
 /**
- * 对外提供的菜单接口
+ * 對外提供的選單介面
  */
 class Menu
 {
 
     /**
-     * 根据key获取菜单
+     * 根據key取得選單
      * @param $key
      * @return array
      */
@@ -24,7 +24,7 @@ public static function get($key)
     }
 
     /**
-     * 根据id获得菜单
+     * 根據id取得菜單
      * @param $id
      * @return array
      */
@@ -34,7 +34,7 @@ public static function find($id): array
     }
 
     /**
-     * 添加菜单
+     * 新增選單
      * @param array $menu
      * @return int
      */
@@ -49,7 +49,7 @@ public static function add(array $menu)
     }
 
     /**
-     * 导入菜单
+     * 導入選單
      * @param array $menu_tree
      * @return void
      */
@@ -76,7 +76,7 @@ public static function import(array $menu_tree)
     }
 
     /**
-     * 删除菜单
+     * 刪除選單
      * @param $key
      * @return void
      */
@@ -86,7 +86,7 @@ public static function delete($key)
         if (!$item) {
             return;
         }
-        // 子规则一起删除
+        // 子規則一起刪除
         $delete_ids = $children_ids = [$item['id']];
         while($children_ids) {
             $children_ids = Rule::whereIn('pid', $children_ids)->pluck('id')->toArray();
@@ -97,7 +97,7 @@ public static function delete($key)
 
 
     /**
-     * 获取菜单中某个(些)字段的值
+     * 取得選單中某個(些)欄位的值
      * @param $menu
      * @param null $column
      * @param null $index

src/plugin/admin/api/Middleware.php

@@ -8,12 +8,12 @@
 use support\exception\BusinessException;
 
 /**
- * 对外提供的鉴权中间件
+ * 對外提供的鑑權中間件
  */
 class Middleware implements MiddlewareInterface
 {
     /**
-     * 鉴权
+     * 鑑權
      * @param Request $request
      * @param callable $handler
      * @return Response

src/plugin/admin/app/common/Auth.php

@@ -10,7 +10,7 @@
 class Auth
 {
     /**
-     * 获取权限范围内的所有角色id
+     * 取得權限範圍內的所有角色id
      * @param bool $with_self
      * @return array
      */
@@ -32,7 +32,7 @@ public static function getScopeRoleIds(bool $with_self = false): array
     }
 
     /**
-     * 获取权限范围内的所有管理员id
+     * 取得權限範圍內的所有管理者id
      * @param bool $with_self
      * @return array
      */
@@ -47,7 +47,7 @@ public static function getScopeAdminIds(bool $with_self = false): array
     }
 
     /**
-     * 兼容旧版本
+     * 相容舊版
      * @param int $admin_id
      * @deprecated
      * @return bool
@@ -59,7 +59,7 @@ public static function isSupperAdmin(int $admin_id = 0): bool
     }
 
     /**
-     * 是否是超级管理员
+     * 是否為超級管理員
      * @param int $admin_id
      * @return bool
      */