PHP 为什么会在对象的注释里面声明属性和方法，方法没有内容，他的作用是什么

问答 / 340 / 6 / 创建于 2年前

/**
 * Modules\Sword\Models\Group
 *
 * @property int $id
 * @property string $group_name 分组名称
 * @property \Illuminate\Support\Carbon|null $created_at
 * @property \Illuminate\Support\Carbon|null $updated_at
 * @method static \Illuminate\Database\Eloquent\Builder|\Modules\Sword\Models\Group groupName($groupName)
 * @method static \Illuminate\Database\Eloquent\Builder|\Modules\Sword\Models\Group newModelQuery()
 * @method static \Illuminate\Database\Eloquent\Builder|\Modules\Sword\Models\Group newQuery()
 * @method static \Illuminate\Database\Eloquent\Builder|\Modules\Sword\Models\Group query()
 * @method static \Illuminate\Database\Eloquent\Builder|\Modules\Sword\Models\Group whereCreatedAt($value)
 * @method static \Illuminate\Database\Eloquent\Builder|\Modules\Sword\Models\Group whereGroupName($value)
 * @method static \Illuminate\Database\Eloquent\Builder|\Modules\Sword\Models\Group whereId($value)
 * @method static \Illuminate\Database\Eloquent\Builder|\Modules\Sword\Models\Group whereUpdatedAt($value)
 * @mixin \Eloquent
 */
class Group extends Model
{
    .
    .
    .
}

今天看公司里面的项目，在一个模型文件里，调用这注释里面的方法有啥用，没有方法体，里面的逻辑是啥返回啥，我懵了，这又是啥技术。。。。

laravel

课程读者 17 声望

认真编程，好好学习，勤奋敬业

《L03 构架 API 服务器》

你将学到如 RESTFul 设计风格、PostMan 的使用、OAuth 流程，JWT 概念及使用和 API 开发相关的进阶知识。

《L02 从零构建论坛系统》

以构建论坛项目 LaraBBS 为线索，展开对 Laravel 框架的全面学习。应用程序架构思路贴近 Laravel 框架的设计哲学。

推荐文章：

更多推荐...

Laravel 11 中文文档仓库，已翻译完成！！！ 14 / 26 |

Laravel验证器最完整用法实例 31 / 14 |

PHP Annotated——2023 年 12 月 25 / 2 |

使用 Laravel 10 & Vue 3 开发了一个社区站，一起来玩下～ 17 / 39 |

历时一个月，《穿透Laravel》全书完成！ 87 / 25 |

[开源项目] 基于 laravel 开发的一个社区/社交小程序 23 / 47 |

chenxiang

课程读者 42 声望

最佳答案

这个就是注解,举个例子,这是一个支付包

Pay::alipay($config)

类中的注释，但里面是没有这两个方法的

/**
 * @method static Alipay alipay(array $config) 支付宝
 * @method static Wechat wechat(array $config) 微信
 */

里面有个魔术方法，不存在alipay这个方法会自动调用，这个魔术方法里实例化了一个对象，路径是Gateways\Alipay.php

    /**
     * Magic static call.
     *
     * @author yansongda <me@yansongda.cn>
     *
     * @param string $method
     * @param array  $params
     *
     * @throws InvalidGatewayException
     * @throws Exception
     */
    public static function __callStatic($method, $params): GatewayApplicationInterface
    {
        $app = new self(...$params);

        return $app->create($method);
    }

    /**
     * Create a instance.
     *
     * @author yansongda <me@yansongda.cn>
     *
     * @param string $method
     *
     * @throws InvalidGatewayException
     */
    protected function create($method): GatewayApplicationInterface
    {
        $gateway = __NAMESPACE__.'\\Gateways\\'.Str::studly($method);

        if (class_exists($gateway)) {
            return self::make($gateway);
        }

        throw new InvalidGatewayException("Gateway [{$method}] Not Exists");
    }

2年前评论

讨论数量: 6

whcoding

125 声望

可能是注解

2年前评论

aab

58 声望 / PHP @ 自由职业

可能是为了辅助 IDE 的工具，同时也告诉其他开发，这里边可能会有这么多的属性和方法！特别是像 Laravel 这样喜欢使用魔术方法的框架。

2年前评论

qi77

见习助教 0 声望

注解

2年前评论

myhui0926

课程读者 160 声望

方便Ide代码提示

2年前评论

chenxiang

课程读者 42 声望

这个就是注解,举个例子,这是一个支付包

Pay::alipay($config)

类中的注释，但里面是没有这两个方法的

/**
 * @method static Alipay alipay(array $config) 支付宝
 * @method static Wechat wechat(array $config) 微信
 */

里面有个魔术方法，不存在alipay这个方法会自动调用，这个魔术方法里实例化了一个对象，路径是Gateways\Alipay.php

    /**
     * Magic static call.
     *
     * @author yansongda <me@yansongda.cn>
     *
     * @param string $method
     * @param array  $params
     *
     * @throws InvalidGatewayException
     * @throws Exception
     */
    public static function __callStatic($method, $params): GatewayApplicationInterface
    {
        $app = new self(...$params);

        return $app->create($method);
    }

    /**
     * Create a instance.
     *
     * @author yansongda <me@yansongda.cn>
     *
     * @param string $method
     *
     * @throws InvalidGatewayException
     */
    protected function create($method): GatewayApplicationInterface
    {
        $gateway = __NAMESPACE__.'\\Gateways\\'.Str::studly($method);

        if (class_exists($gateway)) {
            return self::make($gateway);
        }

        throw new InvalidGatewayException("Gateway [{$method}] Not Exists");
    }

2年前评论

Alone88

98 声望

方便 IDE 和阅读有哪些方法可以调用

2年前评论

讨论应以学习和精进为目的。请勿发布不友善或者负能量的内容，与人为善，比聪明更重要！

帮助