PhpDev.App
maurobonfietti/rest-api-slim-php

maurobonfietti/rest-api-slim-php

Stars: 277

Forks: 93

Pull Requests: 135

Issues: 17

Watchers: 13

Last Updated: 2023-08-06 14:34:47

Example of REST API with Slim PHP micro Framework.

License: MIT License

Languages: PHP, Dockerfile, Makefile, HTML, Shell, Procfile

REST API IN SLIM PHP

This is an example of a RESTful API built using the Slim PHP micro framework.

The API allows you to manage resources such as users, tasks, and notes.

You can also read this README IN SPANISH.

Software License Build Status Code Quality Test Coverage Packagist Version

alt text

đŸ’ģ TECHNOLOGIES USED:

The main technologies used in this project are:

  • PHP 8
  • Slim 3
  • MySQL
  • Redis
  • dotenv
  • PHPUnit
  • JSON Web Tokens (JWT)

Additional tools:

Also, I use other aditional tools like:

  • Docker & Docker Compose
  • Travis CI
  • Swagger
  • Code Climate
  • Scrutinizer
  • Sonar Cloud
  • PHPStan
  • PHP Insights
  • Heroku
  • CORS

⚙ī¸ QUICK INSTALL:

Requirements:

  • Git.
  • Composer.
  • PHP >= 8.0
  • MySQL/MariaDB.
  • Redis (Optional).
  • or Docker.

With Composer:

You can create a new project running the following commands:

$ composer create-project maurobonfietti/rest-api-slim-php [my-api-name]
$ cd [my-api-name]
$ composer restart-db
$ composer test
$ composer start

How to install

With Git:

In your terminal execute this commands:

$ git clone https://github.com/maurobonfietti/rest-api-slim-php.git && cd rest-api-slim-php
$ cp .env.example .env
$ composer install
$ composer restart-db
$ composer test
$ composer start

With Docker:

You can use this project using docker and docker-compose.

Minimal Docker Version:

  • Engine: 18.03+
  • Compose: 1.21+

Commands:

# Start the API (this is my alias for: docker-compose up -d --build).
$ make up

# To create the database and import test data from scratch.
$ make db

# Checkout the API.
$ curl http://localhost:8081

# Stop and remove containers (it's like: docker-compose down).
$ make down

🔧 TROUBLESHOOTING:

If you get stuck, you can try this guide step by step.

đŸŽĻ TUTORIALS:

Watch this mini-series of videos about Slim PHP (Spanish Audio 🔉 đŸ‡Ē🇸 đŸ‡Ļ🇷).

📹 VIDEO #1

How to install and configure this API.

đŸŽĨ VIDEO #2

How to use JWT for Authentication.

📹 VIDEO #3

Using Redis Cache.

đŸŽĨ VIDEO #4

Deploy Slim PHP on Heroku.

đŸ“Ļ DEPENDENCIES:

LIST OF REQUIRE DEPENDENCIES:

  • slim/slim: Slim is a PHP micro framework that helps you quickly write simple yet powerful web applications and APIs.
  • respect/validation: The most awesome validation engine ever created for PHP.
  • palanik/corsslim: Cross-origin resource sharing (CORS) middleware for PHP Slim.
  • vlucas/phpdotenv: Loads environment variables from .env to getenv(), $_ENV and $_SERVER automagically.
  • predis/predis: Flexible and feature-complete Redis client for PHP and HHVM.
  • firebase/php-jwt: A simple library to encode and decode JSON Web Tokens (JWT) in PHP.

LIST OF DEVELOPMENT DEPENDENCIES:

đŸšĨ TESTING:

Run all PHPUnit tests with composer test.

$ composer test
> phpunit
PHPUnit 9.5.28 by Sebastian Bergmann and contributors.

........................................................          56 / 56 (100%)

Time: 00:00.697, Memory: 18.00 MB

OK (56 tests, 343 assertions)

SCREENSHOOTS:

Screen Shot API using Browser


Screen Shot API using Postman


📚 DOCUMENTATION:

ENDPOINTS:

INFO:

  • Help: GET /

  • Status: GET /status

USERS:

  • Login User: POST /login

  • Create User: POST /api/v1/users

  • Update User: PUT /api/v1/users/{id}

  • Delete User: DELETE /api/v1/users/{id}

TASKS:

  • Get All Tasks: GET /api/v1/tasks

  • Get One Task: GET /api/v1/tasks/{id}

  • Create Task: POST /api/v1/tasks

  • Update Task: PUT /api/v1/tasks/{id}

  • Delete Task: DELETE /api/v1/tasks/{id}

NOTES:

  • Get All Notes: GET /api/v1/notes

  • Get One Note: GET /api/v1/notes/{id}

  • Create Note: POST /api/v1/notes

  • Update Note: PUT /api/v1/notes/{id}

  • Delete Note: DELETE /api/v1/notes/{id}

Also, you can see the API documentation with the full list of endpoints.

IMPORT WITH POSTMAN:

All the information of the API, prepared to download and use as postman collection: Import Collection.

Run in Postman

🚀 DEPLOY:

You can deploy this API with Heroku Free.

Deploy

ℹī¸ MORE INFORMATION:

For more information about this project, check out my blog post: How to create a REST API using Slim PHP.

You can also take a look at the todo list web app I developed using this API in Angular.

đŸ’Ŧ CONTRIBUTING:

If you would like to contribute to the project, please open an issue or submit a pull request. Contributions are always welcome!

❤ī¸ DO YOU LIKE THE PROJECT?

You can support this project inviting me a coffee ☕ 😋 or giving a star to this repo ⭐ 😎.

Buy Me a Coffee at ko-fi.com

📄 LICENSE

The MIT License (MIT). Please see License File for more information.

RELEASES

See all