Website 🚀 contributte.org | Contact 👨🏻‍💻 f3l1x.io | Twitter 🐦 @contributte

---

Goal

Main goal is to provide best prepared API starter-kit project for Nette-Apitte developers.

Focused on:

• latest PHP 8.0
• postgres & mariadb
• nette/* packages
• build PSR-7 API via apitte/*
• Doctrine ORM via nettrine/*
• Symfony components via contributte/*
• codestyle checking via CodeSniffer and ninjify/*
• static analysing via phpstan
• unit / integration tests via Nette Tester and ninjify/*

You can try it out yourself either by running it with docker, or more easily with docker-compose.

Demo

https://examples.contributte.org/apitte-skeleton/

Install with docker

1. At first, use composer to install this project.

   composer create-project -s dev contributte/apitte-skeleton

2. After that, you have to setup database.

   1. Setup PostgreSQL 10. You can start it manually or use docker image postgres:10.

      docker run -it -p 5432:5432 -e POSTGRES_PASSWORD=apitte -e POSTGRES_USER=apitte postgres:10

      Or use make task, make loc-postgres.

   2. Setup MariaDB 10.4. You can start it manually or use docker image mariadb:10.4.

      docker run -it -d -p 3306:3306 -e MARIADB_ROOT_PASSWORD=apitte -e MARIADB_PASSWORD=apitte -e MARIADB_USER=apitte -e MARIADB_DATABASE=apitte mariadb:10.4

      Or use make task, make loc-mariadb.

3. Custom configuration file is located at app/config/config.local.neon. Edit it if you want.

   Default configuration should look like this. Pick PostgreSQL or MariaDB.

   # Host Config
   parameters:
   
   	# Database
   	database:
   
   		# Postgres
   		driver: pdo_pgsql
   		host: database
   		dbname: apitte
   		user: apitte
   		password: apitte
   		port: 5432
   
   		# MariaDB
   		driver: pdo_mysql
   		host: database
   		dbname: apitte
   		user: apitte
   		password: apitte
   		port: 3306

4. Ok database is now running and application is configured to connect to it. Let's create initial data.

   Run NETTE_DEBUG=1 bin/console migrations:migrate to create tables. Run NETTE_DEBUG=1 bin/console doctrine:fixtures:load --append to create first user(s).

   Or via task make build.

5. Start your devstack or use PHP local development server.

   You can start PHP server by running php -S localhost:8000 -t www or use prepared make task make loc-api.

6. Open http://localhost and enjoy!

   Take a look at:

   • [GET] http://localhost:8000/api/public/v1/openapi/meta (Swagger format)
   • [GET] http://localhost:8000/api/v1/users
   • [GET] http://localhost:8000/api/v1/users?_access_token=admin
   • [GET] http://localhost:8000/api/v1/users/1?_access_token=admin
   • [GET] http://localhost:8000/api/v1/users/999?_access_token=admin
   • [GET] http://localhost:8000/api/v1/users/[email protected]&_access_token=admin
   • [POST] http://localhost:8000/api/v1/users/create

Install with docker compose

1. At first, use composer to install this project.

   composer create-project -s dev contributte/apitte-skeleton
   

2. Modify app/config/config.local.neon and set host to database

   Default configuration should look like this. There is preconfigured database. Pick PostgreSQL or MariaDB.

   # Host Config
   parameters:
   
   	# Database
   	database:
   
   		# Postgres
   		driver: pdo_pgsql
   		host: database
   		dbname: apitte
   		user: apitte
   		password: apitte
   		port: 5432
   
   		# MariaDB
   		driver: pdo_mysql
   		host: database
   		dbname: apitte
   		user: apitte
   		password: apitte
   		port: 3306

3. Run docker-compose up

4. Open http://localhost and enjoy!

   Take a look at:

   • [GET] http://localhost/api/public/v1/openapi/meta (Swagger format)
   • [GET] http://localhost/api/v1/users
   • [GET] http://localhost/api/v1/users?_access_token=admin
   • [GET] http://localhost/api/v1/users/1?_access_token=admin
   • [GET] http://localhost/api/v1/users/999?_access_token=admin
   • [GET] http://localhost/api/v1/users/[email protected]&_access_token=admin
   • [POST] http://localhost/api/v1/users/create

(Optional) REST API documentation

Since we have OpenAPI specification available at /api/public/v1/openapi/meta you just need to add UI for it (e.g. to www/doc directory or as a standalone application).

Available options are:

• Swagger UI + themes
• ReDoc
• other

Features

Here is a list of all features you can find in this project.

• PHP 8.0+
• 📦 Packages
  • Nette 3.0
  • Apitte
  • Contributte
  • Nettrine
• 🌳 Structure
  • app
    • config - configuration files
      • env - prod/dev/test environments
      • app - application configs
      • ext - extensions configs
      • config.local.neon - local runtime config
      • config.local.neon.dist - template for local config
    • domain - business logic and domain specific classes
    • model - application backbone
    • module - API module
    • resources - static content for mails and others
    • bootstrap.php - Nette entrypoint
  • bin - console entrypoint (bin/console)
  • db - database files
    • fixtures - PHP fixtures
    • migrations - migrations files
  • docs - documentation
  • log - runtime and error logs
  • temp - temp files and cache
  • tests - test engine and many cases
    • tests/cases/E2E - PhpStorm's requests files (api.http)
    • tests/cases/Integration
    • tests/cases/Unit
  • vendor - composer's folder
  • www - public content
• ❗ Tracy
  • Cool error 500 page

Composer packages

Take a detailed look 👀 at each single package.

• contributte/bootstrap
• contributte/di
• contributte/http
• contributte/security
• contributte/utils
• contributte/tracy
• contributte/console
• contributte/neonizer
• contributte/monolog

Apitte

• apitte/core
• apitte/debug
• apitte/middlewares
• apitte/openapi

Nettrine

• nettrine/orm
• nettrine/dbal
• nettrine/migrations
• nettrine/fixtures
• nettrine/extensions

Nette

• nette/finder
• nette/robot-loader

Symfony

• symfony/serializer
• symfony/validator

Demo

Development

See how to contribute to this package.

This package is currently maintaining by these authors.

---

Consider to support contributte development team. Also thank you for using this project.