{"id":812,"date":"2021-06-20T04:12:43","date_gmt":"2021-06-20T09:12:43","guid":{"rendered":"https:\/\/drmad.org\/blog\/?p=812"},"modified":"2021-09-21T01:16:20","modified_gmt":"2021-09-21T06:16:20","slug":"vendimia-0-9999999999999","status":"publish","type":"post","link":"https:\/\/drmad.org\/blog\/vendimia-0-9999999999999.html","title":{"rendered":"Vendimia 0.9999999999999"},"content":{"rendered":"\n

5 a\u00f1os despu\u00e9s<\/a> de agrupar mis librer\u00edas de desarrollo web, y publicarlas con el nombre de Vendimia<\/a>, decid\u00ed volver a hacer todo desde cero. \ud83e\udd2a<\/p>\n\n\n\n

Muchas razones. La segunda m\u00e1s importante es la llegada de PHP 8<\/a>. De entre tantas cosas buenas que trajo esta versi\u00f3n, la que m\u00e1s influy\u00f3 fue los atributos<\/a>, que corrige varios hacks<\/a> que tuve que hacer para la definici\u00f3n de los campos en el ORM usando DocBlock. <\/p>\n\n\n\n

E.g. Esta es la definici\u00f3n de una entidad del ORM, usando el Vendimia \u00ablegacy\u00bb:<\/p>\n\n\n\n

Use Vendimia\\Orm\\Field;\nUse Vendimia\\Orm\\Entity;\n\nclass Venta extends Entity\n{\n    \/**\n     * @V:Field\\DateTime\n     *\/\n    private $fecha;\n    \n    \/**\n     * @V:Field\\Char 60\n     *\/\n    private $cliente;\n\n    \/**\n     * @V:Field\\OneToMany Item\n     *\/\n    private $items;\n    \n    \/**\n     * @V:Field\\Boolean default:false\n     *\/\n    private $anulada;\n}<\/pre>\n\n\n\n
Obtener el FQCN de una clase desde un string, como Field\\DateTime<\/code>, implica analizar el fichero PHP donde est\u00e1 definida la clase, buscar los keywords use<\/code>, y procesar su valor… Los par\u00e1metros a cada objeto eran pasadas como un array al __construct<\/code> de la clase, previamente procesados como un ‘loose’ JSON.<\/p>\n\n\n\n
Ahora, en el nuevo Vendimia:<\/p>\n\n\n\n
use Vendimia\\Database\\Entity;\nuse Vendimia\\Database\\Field;\n\nclass Venta extends Entity\n{\n    #[Field\\DateTime]\n    public $fecha;\n    \n    #[Field\\Char(60)]\n    public $cliente;\n\n    #[Field\\OneToMany(Item::class)]\n    public $items;\n    \n    #[Field\\Boolean(default: false)]\n    public $anulada;\n}<\/pre>\n\n\n\n
Lindo. Las clases son resueltas por el mismo PHP, los argumentos son pasados al constructor usando par\u00e1metros con nombre<\/a>.<\/p>\n\n\n\n
Antes de usar el DocBlock, usaba un array simple para la definici\u00f3n de la metadata de un campo. Esa forma a\u00fan persist\u00eda en la definici\u00f3n de formularios. Ahora todas las definiciones usan atributos.<\/p>\n\n\n\n
A\u00fan as\u00ed, estoy apuntando usar PHP 8.1, por que quiero usar los Enums<\/a> entre otros detallitos. \ud83d\ude0b<\/p>\n\n\n\n
Otra raz\u00f3n para rehacer todo, fue las nuevas ideas que he adquirido con el paso del tiempo. Ahora Vendimia ya no ser\u00e1 un proyecto monol\u00edtico, estar\u00e1 formado por varios m\u00f3dulos independientes y reusables, y se instalar\u00e1n v\u00eda Composer<\/a>.<\/p>\n\n\n\n
\u00bfVendimia 2?<\/h2>\n\n\n\n
Si, y no. Ya que no tuvo visibilidad, desaparecer\u00e9 la versi\u00f3n anterior. Como si nunca existi\u00f3. \ud83d\ude2c<\/p>\n\n\n\n
Aun no hay documentaci\u00f3n. Cuando escriba aunque sea un README.md<\/code> en cada m\u00f3dulo, ir\u00e9 publicando los enlaces en la p\u00e1gina de vendimia<\/a>, y en su cuenta de Twitter<\/a>. Mientras tanto, esta es una lista de las cosas que he estado subiendo:<\/p>\n\n\n\n