Quelles sont les exigences pour décrire les versions de fonctions dans la spécification de la documentation des fonctions PHP ?

Les spécifications d'écriture de la documentation des fonctions PHP exigent que la description de la version suive le format v.., où le numéro de version majeur représente les changements majeurs et le numéro de version mineur représente modifications mineures, le numéro de version représente une mise à jour de maintenance.

Spécification d'écriture de la documentation des fonctions PHP - description de la version de la fonction

Dans la spécification d'écriture de la documentation des fonctions PHP, la description de la version de la fonction a les exigences suivantes :

Format :

版本 v<主版本号>.<次版本号>.<发行版本号>

Numéro de version principale :

Représente une modification incompatible avec rupture d'une fonction.

Numéro de version mineur :

représente des modifications mineures apportées à une fonction, telles que l'ajout de nouvelles fonctionnalités.

Numéro de version :

représente les mises à jour de maintenance des fonctions, telles que les corrections de bugs.

Exemple :

版本 v7.4.12

Cas réel :

Ce qui suit est un exemple de document de fonction qui contient une description de version :

/**
 * 计算两个数的和
 *
 * @param int $num1 第一个数
 * @param int $num2 第二个数
 * @return int 两个数的和
 *
 * @version v8.1.0
 */
function sum(int $num1, int $num2): int
{
    return $num1 + $num2;
}

Dans l'exemple ci-dessus, sum 函数当前处于版本 v8.1.0.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!