Respetamos el estándar Versionado Semántico 2.0.0.
En resumen, SemVer es un sistema de versiones de tres componentes X.Y.Z
que nombraremos Breaking . Feature . Fix, donde:
Breaking: Rompe la compatibilidad de código con versiones anteriores.Feature: Agrega una nueva característica que es compatible con lo anterior.Fix: Incluye algún cambio (generalmente correcciones) que no agregan nueva funcionalidad.
El gestor de dependencias en proyectos para PHP Composer usa las reglas de versionado semántico para instalar y actualizar paquetes.
Te recomendamos instalar dependencias de librerías (no frameworks) con Caret Version Range.
Por ejemplo: "vendor/package": "^2.5".
Esto significa que:
- no debe actualizar a versiones
3.x.x - no debe utilizar ninguna versión menor a
2.5.0
Las versiones que inician con cero, por ejemplo 0.y.z, no se ajustan a las reglas de versionado.
Se considera que estas versiones son previas a la madurez del proyecto y por lo tanto
introducen cambios sin previo aviso.
Sin embargo, nos apegaremos a [ 0 ] . [ Breaking ] . [ Feature || Fix ]. Lo que significa que 0.3.0
no es compatible con 0.2.15 pero 0.3.4 sí es compatible con 0.3.0.
Si la librería contiene elementos marcados como @internal significa que no deben ser utilizados por tu código.
Son partes de código internos de la librería. Por lo tanto, no se consideran breaking changes.
Cuando un elemento es @internal, dicho elemento:
- no debe ser una entrada (parámetro)
- no debe ser una salida (retorno)
- no debe exponer funcionalidades en los objetos públicos (rasgos)