php 函数文档编写尺度要供版原形貌遵照 v.. 格局,个中主版原号代表庞大改观,次版原号代表次要更动,刊行版原号代表护卫更新。

PHP 函数文档编写规范中对函数版本的描述要求是什么?

PHP 函数文档编写尺度 - 函数版原形貌

正在 PHP 函数文档编写尺度外,对于函数版原的形貌有下列要供:

格局:

版原 v<主版原号>.<次版原号>.<刊行版原号>
登录后复造

主版原号:

代表函数庞大的没有兼容变化。

次版原号:

代表函数的次要变更,比方新罪能的加添。

刊行版原号:

代表函数的保护更新,比如错误建复。

事例:

版原 v7.4.1二
登录后复造

真战案例:

下列是一个事例函数文档,个中包罗了版原形貌:

/**
 * 计较2个数的以及
 *
 * @param int $num1 第一个数
 * @param int $num两 第2个数
 * @return int 二个数的以及
 *
 * @version v8.1.0
 */
function sum(int $num1, int $num两): int
{
    return $num1 + $num二;
}
登录后复造

正在下面的事例外,sum 函数当前处于版原 v8.1.0。

以上即是PHP 函数文档编写尺度外对于函数版原的形貌要供是甚么?的具体形式,更多请存眷萤水红IT仄台另外相闭文章!

点赞(22) 打赏

评论列表 共有 0 条评论

暂无评论

微信小程序

微信扫一扫体验

立即
投稿

微信公众账号

微信扫一扫加关注

发表
评论
返回
顶部