OBJETIVO
El objetivo de este articulo es aprender a construir un API REST para un mini blog, el cual nos permita crear, consultar, actualizar y eliminar Usuarios y sus Artículos asociados, con lo cual un usuario pueda publicar muchos artículos y un articulo pertenezca a un solo usuario.
PREREQUISITOS
Antes de seguir con este articulo debes instalar:
- APACHE
- MySQL/MariaDB
- Git
- Un IDE o editor de texto
- El gestor de dependencias en proyectos PHP Composer
CREACION del proyecto CON laravel
Para esta practica vamos a usar el framework Laravel en su versión 8 y empezando creando nuestro proyecto con el siguiente comando:
composer create-project laravel/laravel blog
Luego nos conectamos al servidor de base de datos local MySQL/MariaDB.
mysql -h localhost -u root
Crear la base de datos desde consola de MySQL/MariaDB.
CREATE DATABASE blog CHARACTER SET utf8mb4 COLLATE utf8mb4_spanish_ci;
Modificar las siguientes líneas en el archivo .env de nuestro proyecto, ingresando las credenciales para acceder a la base de datos.
DB_CONNECTION=mysql DB_HOST=127.0.0.1 DB_PORT=3306 DB_DATABASE=blog DB_USERNAME=root DB_PASSWORD=contraseña
control de versiones
Ingresamos a la carpeta de nuestro proyecto
cd blog
Para llevar un control de los cambios ejecuta el siguiente comando el cual dará seguimiento a nuestro proyecto blog, creando así un nuevo repositorio de Git.
git init
el comando git init retorna el siguiente mensaje «Initialized empty Git repository in C:/laragon/www/blog/.git/» si todo a salido bien.
Con lo cual se creara:
- Un STAGING AREA en la memoria RAM donde puedes guardar los cambios que hagas sobre los archivos.
- Un repositorio .git, donde se guardaran todos los cambios históricos de el proyecto.
Ahora con «git add .» agrega todos archivos nuevos o modificados de nuestro directorio de trabajo al STAGING AREA, todos menos los que se encuentren definidos en el archivo .gitignore el cual se genera automáticamente al crear un proyecto laravel.
git add .
Confirmamos que los cambios realizados y guardados en el STAGING AREA serán almacenados en nuestro repositorio local con el comando «git commit" con lo cual se captura el estado del proyecto en ese determinado momento.
git commit -m "Se inicia ejemplo API REST"
Con el siguiente comando crearemos una conexión con nuestro repositorio remoto de Github y la llamaremos «origin» ya que es mas fácil empujar los cambios a través de un nombre corto y descriptivo que utilizar la URL https://github.com/JonavCode/api_rest.git
git remote add origin https://github.com/JonavCode/api_rest.git
El comando git remote te permite crear, ver y eliminar conexiones con otros repositorios y en esencia es una interfaz para gestionar una lista de entradas remotas almacenadas en el archivo ./.git/config del repositorio local
Si necesitas ver las conexiones remotas que tienes con otros repositorios puedes utilizar.
git remote -v
Empujar los commits de la rama local llamada master al remoto llamado origin
git push origin master
El procedimiento para el control de versiones en GIT se puede resumir en la siguiente imagen.
Si miramos bien la imagen podemos observar que no hemos utilizado el comando «git pull» ya que por le momento no es necesario, aunque de modo introductorio se puede decir que se trata de uno de los muchos comandos que se encargan de «sincronizar» el contenido remoto.