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 v1b4a42b1c6d8f16f24adcd8267228001.640f3faac0c511893e54f1c802d4e3ef.b01887c271e49b1abf48ceb32f16a19f, 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!