topnuomi
/
TOP-framework
mirror of https://gitee.com/topnuomi/TOP-framework
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

修改注释

This commit is contained in:
TOP糯米 2024-07-18 15:25:30 +08:00
parent df45409102
commit a9cb0a9161
12 changed files with 105 additions and 102 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
framework/library/Annotation.php
View File

@ -22,39 +22,41 @@ class Annotation
/** /**
* 获取方法注解 * 获取方法注解
* @param $className * @param object|string $className
* @param $methodName * @param string $methodName
* @param null $annotation * @param string $annotation
* @return array * @return array|string
*/ */
public static function getMethodAnnotation($className, $methodName, $annotation = null) public static function getMethodAnnotation($className, $methodName, $annotation = '')
{ {
return self::getAnnotation($className, $methodName, $annotation); return self::getAnnotation($className, $methodName, $annotation);
} }
/** /**
* 获取类注解 * 获取类注解
* @param $className * @param object|string $className
* @param null $annotation * @param string $annotation
* @return array * @return array|string
*/ */
public static function getClassAnnotation($className, $annotation = null) public static function getClassAnnotation($className, $annotation = '')
{ {
return self::getAnnotation($className, null, $annotation); return self::getAnnotation($className, null, $annotation);
} }
/** /**
* 获取注解 * 获取注解
* @param $className * @param object|string $className
* @param null $methodName * @param string $methodName
* @param null $annotation * @param string $annotation
* @return mixed * @return array|string
*/ */
private static function getAnnotation($className, $methodName = null, $annotation = null) private static function getAnnotation($className, $methodName = '', $annotation = '')
{ {
if (is_object($className)) {
$className = get_class($className);
}
$ident = md5($className . $methodName); $ident = md5($className . $methodName);
if (!isset(self::$annotations[$ident])) { if (!isset(self::$annotations[$ident])) {
// echo '获取' . $className . '::' . $methodName . PHP_EOL;
$self = self::instance(); $self = self::instance();
$reflectionClass = Application::getReflectionClass($className); $reflectionClass = Application::getReflectionClass($className);
if ($methodName) { if ($methodName) {

2
framework/library/Application.php
View File

@ -94,7 +94,7 @@ class Application
/** /**
* 获取一个类反射 * 获取一个类反射
* @param $className * @param object|string $className
* @return mixed * @return mixed
*/ */
public static function getReflectionClass($className) public static function getReflectionClass($className)

2
framework/library/Config.php
View File

@ -50,7 +50,7 @@ class Config
* @param string $name * @param string $name
* @return array|mixed * @return array|mixed
*/ */
public function get($name = '') public function get($name)
{ {
// 加载用户配置文件 // 加载用户配置文件
$file = CONFIG_DIR . 'config.php'; $file = CONFIG_DIR . 'config.php';

20
framework/library/Controller.php
View File

@ -27,25 +27,25 @@ abstract class Controller
* URI * URI
* @var string * @var string
*/ */
protected $uri = null; protected $uri = '';
/** /**
* 控制器 * 控制器
* @var string * @var string
*/ */
protected $controller = null; protected $controller = '';
/** /**
* 控制器全限定名 * 控制器全限定名
* @var string * @var string
*/ */
protected $controllerFullName = null; protected $controllerFullName = '';
/** /**
* 方法 * 方法
* @var string * @var string
*/ */
protected $method = null; protected $method = '';
/** /**
* 控制器基类构造方法 * 控制器基类构造方法
@ -62,10 +62,10 @@ abstract class Controller
/** /**
* 输出JSON数据 * 输出JSON数据
* @param $msg * @param string $msg
* @param int $code * @param int $code
* @param array $data * @param array $data
* @return mixed * @return false|string
*/ */
protected function json($msg, $code = 1, $data = []) protected function json($msg, $code = 1, $data = [])
{ {
@ -85,8 +85,8 @@ abstract class Controller
/** /**
* 赋值到视图 * 赋值到视图
* @param $name * @param string $name
* @param $value * @param mixed $value
*/ */
protected function param($name, $value) protected function param($name, $value)
{ {
@ -107,7 +107,7 @@ abstract class Controller
/** /**
* 跳转 * 跳转
* @param $url * @param string $url
*/ */
protected function redirect($url) protected function redirect($url)
{ {
@ -116,7 +116,7 @@ abstract class Controller
/** /**
* 显示提示页面 * 显示提示页面
* @param $message * @param string $message
* @param string $url * @param string $url
* @param int $sec * @param int $sec
* @return false|mixed|string * @return false|mixed|string

60
framework/library/Database.php
View File

@ -44,21 +44,21 @@ class Database
/** /**
* 别名 * 别名
* @var null * @var string
*/ */
private $alias = null; private $alias = '';
/** /**
* 数据去重 * 数据去重
* @var null * @var bool
*/ */
private $distinct = false; private $distinct = false;
/** /**
* 操作的字段 * 操作的字段
* @var null * @var array|string
*/ */
private $field = null; private $field = '';
/** /**
* 条件 * 条件
@ -68,15 +68,15 @@ class Database
/** /**
* 排序 * 排序
* @var null * @var string
*/ */
private $order = null; private $order = '';
/** /**
* 范围 * 范围
* @var null * @var string
*/ */
private $limit = null; private $limit = '';
/** /**
* 多表 * 多表
@ -86,9 +86,9 @@ class Database
/** /**
* Database constructor. * Database constructor.
* @param $table * @param string $table
* @param $pk * @param string $pk
* @param $prefix * @param string $prefix
* @throws DatabaseException * @throws DatabaseException
*/ */
private function __construct($table, $pk, $prefix) private function __construct($table, $pk, $prefix)
@ -112,8 +112,8 @@ class Database
/** /**
* 获取表名 * 获取表名
* @param $prefix * @param string $prefix
* @param $table * @param string $table
* @return string * @return string
*/ */
private function getTableName($prefix, $table) private function getTableName($prefix, $table)
@ -131,7 +131,7 @@ class Database
/** /**
* 指定表 * 指定表
* @param $table * @param string $table
* @param string $pk * @param string $pk
* @param string $prefix * @param string $prefix
* @return $this * @return $this
@ -147,7 +147,7 @@ class Database
/** /**
* 设置表别名 * 设置表别名
* @param $name * @param string $name
* @return \top\library\Database * @return \top\library\Database
*/ */
public function alias($name) public function alias($name)
@ -157,7 +157,7 @@ class Database
} }
/** /**
* @param $flag * @param bool $flag
* @return \top\library\Database * @return \top\library\Database
*/ */
public function distinct($flag = true) public function distinct($flag = true)
@ -168,7 +168,7 @@ class Database
/** /**
* 设置操作字段 * 设置操作字段
* @param $field * @param array|string $field
* @return \top\library\Database * @return \top\library\Database
*/ */
public function field($field) public function field($field)
@ -244,8 +244,8 @@ class Database
/** /**
* 多表 * 多表
* *
* @param $table * @param string $table
* @param $on * @param string $on
* @param string $type * @param string $type
* @return \top\library\Database * @return \top\library\Database
*/ */
@ -279,7 +279,7 @@ class Database
/** /**
* 查询一条记录 * 查询一条记录
* @param bool $param * @param mixed $param
* @return mixed * @return mixed
*/ */
public function find($param = false) public function find($param = false)
@ -306,7 +306,7 @@ class Database
/** /**
* 查询所有记录 * 查询所有记录
* *
* @param callable|string|bool $param * @param mixed $param
* @return array|boolean * @return array|boolean
*/ */
public function select($param = false) public function select($param = false)
@ -337,7 +337,7 @@ class Database
* 更新记录 * 更新记录
* *
* @param array $data * @param array $data
* @param callable|string|bool $param * @param mixed $param
* @return int|boolean * @return int|boolean
*/ */
public function update($data, $param = false) public function update($data, $param = false)
@ -364,7 +364,7 @@ class Database
/** /**
* 删除记录 * 删除记录
* *
* @param callable|string|bool $param * @param mixed $param
* @return int|boolean * @return int|boolean
*/ */
public function delete($param = false) public function delete($param = false)
@ -391,8 +391,8 @@ class Database
/** /**
* 公共方法 （sum、avg等等使用函数包裹字段的方法） * 公共方法 （sum、avg等等使用函数包裹字段的方法）
* *
* @param $param * @param mixed $param
* @param $type * @param string $type
* @return mixed * @return mixed
*/ */
public function common($param, $type) public function common($param, $type)
@ -416,7 +416,7 @@ class Database
/** /**
* 执行一条SQL * 执行一条SQL
* @param $query * @param string $query
* @param array $params * @param array $params
* @return bool|\PDOStatement * @return bool|\PDOStatement
*/ */
@ -474,11 +474,11 @@ class Database
private function _reset() private function _reset()
{ {
$this->distinct = false; $this->distinct = false;
$this->field = null; $this->field = '';
$this->join = []; $this->join = [];
$this->where = []; $this->where = [];
$this->order = null; $this->order = '';
$this->limit = null; $this->limit = '';
} }
/** /**

10
framework/library/Loader.php
View File

@ -19,8 +19,8 @@ class Loader
/** /**
* 添加命名空间映射 * 添加命名空间映射
* @param $name * @param string $name
* @param $path * @param string $path
*/ */
public function set($name, $path) public function set($name, $path)
{ {
@ -33,7 +33,7 @@ class Loader
/** /**
* 尝试根据前缀和类名加载文件 * 尝试根据前缀和类名加载文件
* @param $class * @param string $class
* @return bool * @return bool
*/ */
private function loadClass($class) private function loadClass($class)
@ -59,8 +59,8 @@ class Loader
/** /**
* 加载文件 * 加载文件
* @param $prefix * @param string $prefix
* @param $class * @param string $class
* @return bool * @return bool
*/ */
private function loadFile($prefix, $class) private function loadFile($prefix, $class)

42
framework/library/Model.php
View File

@ -124,7 +124,7 @@ class Model
/** /**
* 过滤重复值 * 过滤重复值
* @param $flag * @param bool $flag
* @return $this * @return $this
*/ */
private function _distinct($flag = true) private function _distinct($flag = true)
@ -135,7 +135,7 @@ class Model
/** /**
* 指定字段 * 指定字段
* @param $field * @param array|string $field
* @return $this * @return $this
*/ */
private function _field($field) private function _field($field)
@ -185,8 +185,8 @@ class Model
/** /**
* 多表 * 多表
* @param $table * @param string $table
* @param $on * @param string $on
* @param string $type * @param string $type
* @return $this * @return $this
*/ */
@ -228,8 +228,8 @@ class Model
/** /**
* 删除记录 * 删除记录
* @param string|bool $param * @param mixed $param
* @return number|boolean * @return int|bool
*/ */
public function delete($param = false) public function delete($param = false)
{ {
@ -238,8 +238,8 @@ class Model
/** /**
* 更新记录 * 更新记录
* @param $data * @param array $data
* @param string|bool $param * @param mixed $param
* @return bool * @return bool
*/ */
public function update($data, $param = false) public function update($data, $param = false)
@ -291,7 +291,7 @@ class Model
/** /**
* 计数 * 计数
* @param null $param * @param mixed $param
* @return mixed * @return mixed
*/ */
public function count($param = null) public function count($param = null)
@ -301,7 +301,7 @@ class Model
/** /**
* 平均值 * 平均值
* @param null $param * @param mixed $param
* @return mixed * @return mixed
*/ */
public function avg($param = null) public function avg($param = null)
@ -311,7 +311,7 @@ class Model
/** /**
* 最大值 * 最大值
* @param null $param * @param mixed $param
* @return mixed * @return mixed
*/ */
public function max($param = null) public function max($param = null)
@ -321,7 +321,7 @@ class Model
/** /**
* 最小值 * 最小值
* @param null $param * @param mixed $param
* @return mixed * @return mixed
*/ */
public function min($param = null) public function min($param = null)
@ -331,7 +331,7 @@ class Model
/** /**
* 求和 * 求和
* @param null $param * @param mixed $param
* @return mixed * @return mixed
*/ */
public function sum($param = null) public function sum($param = null)
@ -341,7 +341,7 @@ class Model
/** /**
* 执行一条SQL * 执行一条SQL
* @param $query * @param string $query
* @param array $params * @param array $params
* @return mixed * @return mixed
*/ */
@ -352,7 +352,7 @@ class Model
/** /**
* MySQL事务 * MySQL事务
* @param $action * @param callable $action
* @return bool * @return bool
*/ */
public function transaction($action) public function transaction($action)
@ -416,7 +416,7 @@ class Model
/** /**
* 入库前进行数据处理 * 入库前进行数据处理
* @param $data * @param mixed $data
* @return array|bool * @return array|bool
*/ */
private function processData($data) private function processData($data)
@ -507,8 +507,8 @@ class Model
/** /**
* 调用函数、方法替换值 * 调用函数、方法替换值
* @param $value * @param string $value
* @param $function * @param mixed $function
* @return mixed * @return mixed
*/ */
private function callOutReplaceFunction($value, $function) private function callOutReplaceFunction($value, $function)
@ -528,7 +528,7 @@ class Model
/** /**
* 验证表单 * 验证表单
* @param $data * @param array $data
* @return bool * @return bool
*/ */
private function validate($data) private function validate($data)
@ -556,8 +556,8 @@ class Model
/** /**
* 调用对应验证函数（如果update时不想验证数据，请在之前unset掉对应键值） * 调用对应验证函数（如果update时不想验证数据，请在之前unset掉对应键值）
* @param string $key * @param string $key
* @param $validate * @param array $validate
* @param $data * @param array $data
* @return bool * @return bool
*/ */
private function validateCallUserFunction($key, $validate, $data) private function validateCallUserFunction($key, $validate, $data)

2
framework/library/Register.php
View File

@ -38,7 +38,7 @@ class Register
/** /**
* 获取类实例 * 获取类实例
* @param $name * @param string $name
* @param array $param * @param array $param
* @return mixed * @return mixed
* @throws \Exception * @throws \Exception

12
framework/library/Template.php
View File

@ -36,7 +36,7 @@ class Template
/** /**
* 是否开启页面静态缓存 * 是否开启页面静态缓存
* @param $status * @param bool $status
*/ */
public function cache($status) public function cache($status)
{ {
@ -45,8 +45,8 @@ class Template
/** /**
* 传递参数 * 传递参数
* @param $name * @param string $name
* @param $value * @param mixed $value
*/ */
public function param($name, $value) public function param($name, $value)
{ {
@ -55,9 +55,9 @@ class Template
/** /**
* 获取视图 * 获取视图
* @param $file * @param string $file
* @param $param * @param array $param
* @param $cache * @param int|bool $cache
* @return mixed * @return mixed
*/ */
public function fetch($file, $param, $cache) public function fetch($file, $param, $cache)

8
framework/library/View.php
View File

@ -28,15 +28,15 @@ class View
$this->config = config('view'); $this->config = config('view');
$className = '\\top\\library\\template\\driver\\' . $this->config['engine']; $className = '\\top\\library\\template\\driver\\' . $this->config['engine'];
if (!class_exists($className)) { if (!class_exists($className)) {
throw new Exception('不存在的模板引擎：' . $className); throw new \Exception('不存在的模板引擎：' . $className);
} }
$this->template = Template::instance($className::instance()); $this->template = Template::instance($className::instance());
} }
/** /**
* 传递参数 * 传递参数
* @param $name * @param string $name
* @param $value * @param mixed $value
*/ */
public function param($name, $value) public function param($name, $value)
{ {
@ -56,7 +56,7 @@ class View
* 获取视图 * 获取视图
* @param string $file * @param string $file
* @param array $param * @param array $param
* @param bool $cache * @param int|bool $cache
* @return mixed * @return mixed
* @throws \Exception * @throws \Exception
*/ */

15
framework/library/template/driver/Top.php
View File

@ -36,7 +36,7 @@ class Top implements TemplateIfs
/** /**
* 编译文件 * 编译文件
* @param $filename * @param string $filename
* @return string * @return string
*/ */
private function compile($filename) private function compile($filename)
@ -59,7 +59,7 @@ class Top implements TemplateIfs
/** /**
* 是否开启缓存或设置缓存时间 * 是否开启缓存或设置缓存时间
* @param $status * @param bool $status
*/ */
public function cache($status) public function cache($status)
{ {
@ -68,8 +68,9 @@ class Top implements TemplateIfs
/** /**
* 缓存文件 * 缓存文件
* @param $filename * @param string $filename
* @param $params * @param array $params
* @param int $cacheTime
* @return string * @return string
* @throws \Exception * @throws \Exception
*/ */
@ -93,9 +94,9 @@ class Top implements TemplateIfs
/** /**
* 渲染文件并返回内容 * 渲染文件并返回内容
* @param $file * @param string $file
* @param $params * @param array $params
* @param $cache * @param int|bool $cache
* @return bool|false|mixed|string * @return bool|false|mixed|string
* @throws \Exception * @throws \Exception
*/ */

2
framework/traits/Magic.php
View File

@ -8,7 +8,7 @@ trait Magic
/** /**
* 使用成员变量调用某些类 * 使用成员变量调用某些类
* @param $name * @param string $name
* @return mixed * @return mixed
*/ */
public function __get($name) public function __get($name)