Creación de Entidades y Base de Datos con PHP y MariaDB

Clase 5 de 18 • Curso de Symfony 6: Creación de API REST

Resumen

¿Cómo instalar y configurar herramientas necesarias en un entorno de desarrollo PHP?

Trabajar con un sistema de gestión de bases de datos es esencial para practicar y desarrollar aplicaciones. Seguir los pasos adecuados para instalar y configurar el entorno de desarrollo puede ahorrarte tiempo y evitar errores. Aquí desglosamos cómo preparar tu entorno usando PHP y comandos de consola.

¿Cómo ejecutar el comando `phpbing console`?

Para iniciar el proceso de configuración, primero necesitas ejecutar el comando phpbing console. Este te proporcionará un listado de comandos disponibles, aunque, inicialmente, podrías encontrar que algunos comandos específicos no funcionan. Por ejemplo, al intentar ejecutar phpbing console make:entidad, puede que se sugiera una instalación adicional. Esto es una indicación de que necesitas instalar comandos adicionales, procedimiento que se realiza copiando y pegando la sugerencia directamente en la consola y presionando enter. Una vez ejecutado, demuestra el potencial para crear diferentes entidades.

¿Cómo crear entidades y definir sus características?

En el desarrollo de aplicaciones, las entidades definen los datos y estructuras con las que trabajarás. En nuestro ejemplo práctico, necesitamos dos entidades principales: categorías y publicaciones.

Entidad Categoría:
- Propiedad: name
- Tipo: string
- Longitud máxima: 255 caracteres
- Nulos: No permitido
- API Platform Resource: Sí
Entidad Publicación:
- Propiedad: título
- Tipo: string
- Longitud máxima: 255 caracteres
- Nulos: No permitido
- Otra Propiedad: body
- Tipo: text
- Nulos: No permitido

Para las publicaciones, también deberás configurar una relación con las categorías, definiéndola como many-to-one. Esto significa que muchas publicaciones pueden pertenecer a una sola categoría. Además, se debe permitir que las categorías accedan a las publicaciones relacionadas y gestionar los elementos huérfanos. Esta relación se configura para eliminar publicaciones si su categoría padre es eliminada.

¿Cómo configurar la conexión a la base de datos en el archivo `.env`?

El archivo .env es donde se define la configuración de tu entorno. Aquí, establecerás conexiones cruciales, como la de la base de datos:

Tipo de Base de Datos: MaríaDB
Versión: 10.11.3
Usuario: Italo Morales F
Contraseña: root
Servidor: localhost
Nombre de la Base de Datos: API

Estas configuraciones permiten que la aplicación se comunique y maneje datos correctamente.

¿Cómo crear y migrar la base de datos?

Con la creación y configuración de las entidades, el siguiente paso es reflejar estas en la base de datos:

Creación de la base de datos:
- Comando: phpBing console doctrine:database:create
- Este comando genera la base de datos necesaria con el nombre configurado previamente, asegurando que está lista para recibir datos.
Migración de datos:
- Comando: phpBing console make:migración
- Este procedimiento crea un archivo de migración que estructura las tablas en la base de datos.
- Luego, utiliza phpBing console doctrine:migrations:migrar para aplicar la migración y generar las tablas definidas.

Finalmente, verás que tu base de datos contiene las tablas categoría y publicaciones, completando así el ciclo de instalación, configuración y migración.

Consejos finales

Implementar correctamente los comandos y configuraciones te prepara para un entorno de desarrollo PHP eficiente. Recuerda siempre revisar las relaciones y propiedades de tus entidades y asegurarte de que la configuración de tu base de datos esté perfectamente alineada con los requisitos de tu proyecto. Con práctica y atención a los detalles, podrás dominar el desarrollo de aplicaciones con bases de datos robustas y funcionales. ¡No dejes de aprender y de experimentar con nuevas configuraciones para mejorar tus habilidades!

Francisco Javier Cervantes Candelario

student•

Si quieren usar docker, en el archivo compose.yaml pueden dejarlo asi para configurar mysql y phpmyadmin:

version: '3'

services:
###> doctrine/doctrine-bundle ###
  database:
    image: postgres:${POSTGRES_VERSION:-16}-alpine
    environment:
      POSTGRES_DB: ${POSTGRES_DB:-app}
      # You should definitely change the password in production
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-!ChangeMe!}
      POSTGRES_USER: ${POSTGRES_USER:-app}
    healthcheck:
      test: ["CMD", "pg_isready -U ${POSTGRES_USER:-app}"]
      timeout: 5s
      retries: 5
      start_period: 60s
    volumes:
      - database_data:/var/lib/postgresql/data:rw
      # You may use a bind-mounted host directory instead, so that it is harder to accidentally remove the volume and lose all your data!
      # - ./docker/db/data:/var/lib/postgresql/data:rw
###< doctrine/doctrine-bundle ###
  #MYSQL DATABASE
  mysql: 
    image: mysql:5
    environment: 
      MYSQL_DATABASE: webapp
      MYSQL_USER: root
      MYSQL_ROOT_PASSWORD: admin123
      MYSQL_PORT: 3306
    ports:  
      - 3306:3306
    volumes: 
      - ./mysql_data:/var/lib/mysql
    
  #PHPMYADMIN
  phpmyadmin:
    image: phpmyadmin/phpmyadmin
    environment:
      MYSQL_ROOT_PASSWORD: admin123
      PMA_HOST: mysql
    ports: 
      - 8080:80

volumes:
###> doctrine/doctrine-bundle ###
  database_data:
###< doctrine/doctrine-bundle ###
```Debemos crear una carpeta en raiz llamada \*\*mysql\\\_data\*\* y agregar en el archivo .gitignore para que no se traqueda por git.\&#x20;

Para levantar los servicios sería con\&#x20;

`` `docker-compose up -d mysql ` ``

`` `docker-compose up - ``d phpmyadmin`



`No olviden instalar docker en su equipo.`version: '3'
services:###> doctrine/doctrine-bundle ###  database:    image: postgres:${POSTGRES\_VERSION:-16}-alpine    environment:      POSTGRES\_DB: ${POSTGRES\_DB:-app}      # You should definitely change the password in production      POSTGRES\_PASSWORD: ${POSTGRES\_PASSWORD:-!ChangeMe!}      POSTGRES\_USER: ${POSTGRES\_USER:-app}    healthcheck:      test: \["CMD", "pg\_isready -U ${POSTGRES\_USER:-app}"]      timeout: 5s      retries: 5      start\_period: 60s    volumes:      - database\_data:/var/lib/postgresql/data:rw      # You may use a bind-mounted host directory instead, so that it is harder to accidentally remove the volume and lose all your data!      # - ./docker/db/data:/var/lib/postgresql/data:rw###< doctrine/doctrine-bundle ###  #MYSQL DATABASE  mysql:     image: mysql:5    environment:       MYSQL\_DATABASE: webapp      MYSQL\_USER: root      MYSQL\_ROOT\_PASSWORD: admin123      MYSQL\_PORT: 3306    ports:        - 3306:3306    volumes:       - ./mysql\_data:/var/lib/mysql      #PHPMYADMIN  phpmyadmin:    image: phpmyadmin/phpmyadmin    environment:      MYSQL\_ROOT\_PASSWORD: admin123      PMA\_HOST: mysql    ports:       - 8080:80
volumes:###> doctrine/doctrine-bundle ###  database\_data:###< doctrine/doctrine-bundle ###

Raúl Hernández

student•

php bin/console make:entity

[ERROR] Missing package: to use the make:entity command, run:

composer require orm

Raúl Hernández

student•

Se debe ejecutar primero:

composer require symfony/orm-pack y luego ya funciona el comando "php bin/console make:entity"

Francisco Javier Cervantes Candelario

student•

Si quieren usar docker, en el archivo compose.yaml pueden dejarlo asi para configurar mysql y phpmyadmin:

version: '3'

services:
###> doctrine/doctrine-bundle ###
  database:
    image: postgres:${POSTGRES_VERSION:-16}-alpine
    environment:
      POSTGRES_DB: ${POSTGRES_DB:-app}
      # You should definitely change the password in production
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-!ChangeMe!}
      POSTGRES_USER: ${POSTGRES_USER:-app}
    healthcheck:
      test: ["CMD", "pg_isready -U ${POSTGRES_USER:-app}"]
      timeout: 5s
      retries: 5
      start_period: 60s
    volumes:
      - database_data:/var/lib/postgresql/data:rw
      # You may use a bind-mounted host directory instead, so that it is harder to accidentally remove the volume and lose all your data!
      # - ./docker/db/data:/var/lib/postgresql/data:rw
###< doctrine/doctrine-bundle ###
  #MYSQL DATABASE
  mysql: 
    image: mysql:5
    environment: 
      MYSQL_DATABASE: webapp
      MYSQL_USER: root
      MYSQL_ROOT_PASSWORD: admin123
      MYSQL_PORT: 3306
    ports:  
      - 3306:3306
    volumes: 
      - ./mysql_data:/var/lib/mysql
    
  #PHPMYADMIN
  phpmyadmin:
    image: phpmyadmin/phpmyadmin
    environment:
      MYSQL_ROOT_PASSWORD: admin123
      PMA_HOST: mysql
    ports: 
      - 8080:80

volumes:
###> doctrine/doctrine-bundle ###
  database_data:
###< doctrine/doctrine-bundle ###
```Debemos crear una carpeta en raiz llamada **mysql\_data** y agregar en el archivo .gitignore para que no se traqueda por git.&#x20;

Para levantar los servicios sería con&#x20;

`docker-compose up -d mysql `

`docker-compose up -d phpmyadmin`



No olviden instalar docker en su equipo.

Omar Villafuerte

student•

Lista de comandos empleados en la clase :)

composer require symfony/maker-bundle

php bin/console make:entity

php bin/console doctrine:database:create

php bin/console doctrine:migrations:migrate

php bin/console doctrine:migrations:migrate

Rafael Steven Vera Moreno

student•

te falto esta `php bin/console make:migration````js php bin/console make:migration

Creación de Entidades y Base de Datos con PHP y MariaDB

Introducción

Este curso tiene una versión actualizada.

Diseño y Desarrollo de APIs con Symfony 6 y API Platform

Documentación de APIs con OpenAPI y Swagger UI en Symfony

Configuración inicial

Configuración de Symfony-API con Visual Studio Code y Composer