{"id":22790691,"url":"https://github.com/maximo-perez-villalba/framework-dao-db","last_synced_at":"2026-04-30T10:37:58.854Z","repository":{"id":57676342,"uuid":"487683379","full_name":"maximo-perez-villalba/framework-dao-db","owner":"maximo-perez-villalba","description":"El proyecto implementa una extensión de framework-dao para base de datos a través de PDO con fines pedagógicos.","archived":false,"fork":false,"pushed_at":"2022-05-11T02:15:26.000Z","size":710,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-09T15:17:33.885Z","etag":null,"topics":["crud","dao","dao-crud","dao-design-pattern","database","oop","pdo","pdo-php","php","uml","uml-class-diagram"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/maximo-perez-villalba.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-05-02T01:25:17.000Z","updated_at":"2023-10-10T23:50:39.000Z","dependencies_parsed_at":"2022-09-02T22:31:22.540Z","dependency_job_id":null,"html_url":"https://github.com/maximo-perez-villalba/framework-dao-db","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/maximo-perez-villalba/framework-dao-db","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maximo-perez-villalba%2Fframework-dao-db","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maximo-perez-villalba%2Fframework-dao-db/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maximo-perez-villalba%2Fframework-dao-db/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maximo-perez-villalba%2Fframework-dao-db/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/maximo-perez-villalba","download_url":"https://codeload.github.com/maximo-perez-villalba/framework-dao-db/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maximo-perez-villalba%2Fframework-dao-db/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32462304,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-29T22:27:22.272Z","status":"online","status_checked_at":"2026-04-30T02:00:05.929Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["crud","dao","dao-crud","dao-design-pattern","database","oop","pdo","pdo-php","php","uml","uml-class-diagram"],"created_at":"2024-12-12T02:28:40.283Z","updated_at":"2026-04-30T10:37:58.828Z","avatar_url":"https://github.com/maximo-perez-villalba.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# framework-dao-db\nEl proyecto implementa una extensión del framework `maximo-perez-villalba/framework-dao` para base de datos a través de PDO. Para ver el proyecto padre ir a [framework-dao](https://github.com/maximo-perez-villalba/framework-dao). Y aunque su fin principal es de apoyo pedagógico, la extensión es completamente funcional.\n\n\n## Instalación\nSe puede instalar `framework-dao-db` a través de Composer.\n\n1 Desde una consola de comandos ir al directorio del proyecto y ejecutar:\n```\ncomposer require maximo-perez-villalba/framework-dao-db\n```\n\n2 También agregando en el archivo `composer.json`, dentro de la sección  `\"require\"`.\n```\n\"require\": {\n  \"maximo-perez-villalba/framework-dao-db\": \"\u003e=1.0.0\"\n},\n```\n2.1 Luego desde una consola de comandos ejecutar:\n```\ncomposer update\n```\n\n\n## Documentación\n### Extensión DAO para bases de datos (DAODB)\nEsta extensión implementa a través de la [clase DAODB](/src/framework/dao/db/DAODB.php) el CRUD definido en la [clase DAO](https://github.com/maximo-perez-villalba/framework-dao/blob/main/src/framework/dao/DAO.php), para comunicarse con bases de datos a través de [PDO](https://www.php.net/manual/es/class.pdo) (PHP Data Object). A su vez la clase DAODB incorpora métodos específicos para la recuperación de datos desde la bases de datos.\n\n\n![image:uml-class-daodb.png](/docs/uml-class-daodb.png)\n\nEl diagrama de clases muestra el diseño de implementación de la extensión DAODB, donde **los objetos de modelo** deben extender de la [clase PersistentDB](/src/framework/dao/db/PersistentDB.php). Esto implica que en la base de datos, las tablas que representan **los objetos de modelo** deben contener la columna `PRIMARY KEY` bajo el nombre `uid` y ser de tipo entero.\n\n\n#### Implementación\nComo DAODB es una clase abstracta es requerido crear una clase que la extienda para su implementación específica.\n\nCon este fin creamos una clase que se llame Something que extienda de PersistentDB y su respectiva SomethingDAODB que extiende de DAODB.\n\n![image:uml-class-something-daodb.png](/docs/uml-class-something-daodb.png)\n\nEl diagrama de clases muestra el diseño de implementación de la clase SomethingDAODB, donde expone los tres métodos requeridos para particularizar la persistencia en una base de datos de los objetos Something. \n\nEstos 3 métodos son:\n* **update():bool** definido en la clase DAO.\n* **insert():bool** definido en la clase DAODB.\n* **dataToObject(array):Something** definido en la clase DAODB.\n\n \n#### Como se usa\n```\n\u003c?php\n// Para obtener una instancia de la clase SomethingDAODB.\n$daodb = new SomethingDAODB( $somethingPersistentDB );\n\n// También puedo obtener una instancia de la clase SomethingDAODB desde el objeto persistible. \n$daodb = $objectPersistentDB-\u003edao();\n\n// Para guardar una nueva instancia de la clase Something en la base de datos.\n$daodb-\u003ecreate();\n\n// También para guardar una nueva instancia de la clase Something en la base de datos, podemos usar el método insert (alias de create).\n$daodb-\u003einsert();\n\n// Para sincronizar los cambios de un objeto de modelo.\n$daodb-\u003eupdate();\n\n// Para borrar un objeto de modelo.\n$daodb-\u003edelete();\n\n// Para recuperar un objeto de modelo almacenado en formato objeto de la clase PersistentDB.\n$something = SomethingDAODB::getObject( 'email = :email', [ ':email' =\u003e 'cvb.zxzxzx@prueba.com' ] );\n$something = SomethingDAODB::getObjectByUid( 1234 );\n\n// Para recuperar datos almacenados en formato mapa de arreglos.\n$list = SomethingDAODB::read( 'codigo = :codigo', [':codigo'=\u003e'anValue'] );\n\n// Para recuperar objetos almacenados en formato mapa de objetos.\n$list = SomethingDAODB::list( 'email LIKE :pattern', [ ':pattern' =\u003e '%@prueba.com' ] );\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaximo-perez-villalba%2Fframework-dao-db","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaximo-perez-villalba%2Fframework-dao-db","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaximo-perez-villalba%2Fframework-dao-db/lists"}