README

Clone repository

$ git clone https://paneric@bitbucket.org/paneric/base-micro-service.git
$ mv base-micro-service e-commerce-session

Set a custom module

Adapt project name and psr-4:

composer.json

{
    "name": "paneric/e-commerce-session",
    ...
    "autoload": {
        "psr-4": {
            "ECommerce\\Session\\": "src"
        }
    },
    ...
}

Run composer:

$ composer update

Make sure the scope variable is set as lib:

bin/app

#!/usr/bin/env php
<?php

$scope = 'lib';
...

Run console command:

$ bin/app bms

Psr-4 (no trailing backslash !!!): ECommerce
Vendor service folder path (relative to project folder, no trailing slash !!!): vendor/paneric/e-commerce-session
Service name (CamelCase !!!): Session
DB table column name prefix (lower case !!!): ses
DAO attributes names (camelCase, coma separated !!!): sessionId,ipAddress,userAgent,data
DAO attributes types (CamelCase, coma separated !!!): String,String,String,String
DAO unique attribute name (camelCase !!!): sessionId

                                                                          
  BASE MICRO SERVICE UPDATE SUCCESS:                                      
                                                                          

  Resources update with vendor "ECommerce", service "Session" and prefix "ses" success.

Environment variables

.env

ENV = 'dev'
APP_DOMAIN = '127.0.0.1:8080'
BASE_API_URL = 'http://127.0.0.1:8081'

# GUARD:
KEY_ASCII = 'def000008d147968b763eac2453624272c423c77347bd423e736328d648365fb243ea2130953f36ff38b5c9d8b15e5063df9e014010a3e06a1ec60612e54737a9f54f45d'
# DB:
DB_HOST = 'localhost'
DB_NAME = 'e_commerce'
DB_USR = 'toor'
DB_PSWD = 'toor'
JWT_SECRET = 'NRA4kcEMGUr+w5zOWpsVJ7v4NmQVVAuMZfZFll5g4pjnTGHJFj8Fw24bvUlRsttJrY0/ZBtav66nCzuD0S/rrBuNRGsV8QkulREVa9krRxTO/mnx1fgVIPBMacHMm6hN'

Migrations and fixtures

Install migrations

$ composer require --dev robmorgan/phinx

Create migrations and seed folders

$ mkdir db
$ cd db
$ mkdir migrations
$ mkdir seeds

Init migrations settings

$ bin/phinx init

That will create phinx.php file in your root directory. Update your db credentials.

phinx.php

return
[
    ...
    'environments' => [
        'default_migration_table' => 'phinxlog',
        'default_environment' => 'development',
        'production' => [
            'adapter' => 'mysql',
            'host' => 'localhost',
            'name' => 'e_commerce',
            'user' => 'toor',
            'pass' => 'toor',
            'port' => '3306',
            'charset' => 'utf8',
        ],
        'development' => [
            ...
        ],
        'testing' => [
            ...
        ]
    ],
    'version_order' => 'creation'
];

Create your migration

$ bin/phinx create SessionsMigration

db/migrations/20210208151830_session_migration.php

use Phinx\Migration\AbstractMigration;

final class SessionMigration extends AbstractMigration
{
    public function change(): void
    {
        ...
    }
}

Create your fixtures

$ composer require --dev fzaninotto/faker

$ bin/phinx seed:create SessionsSeeder

db/seeds/SessionsSeeder.php

use Faker\Factory;
use Phinx\Seed\AbstractSeed;

class SessionsSeeder extends AbstractSeed
{
    public function run()
    {
        ...
    }
}

Run migrations (standard)

$ bin/phinx migrate -e development

Run migrations (Docker)

$ sudo docker exec 57f bin/phinx migrate -e development

Run fixtures (standard)

$ bin/phinx seed:run -e development

Run fixtures (Docker)

$ sudo docker exec 57f bin/phinx seed:run -e development

Migrations and fixtures commands

Apache

Create log folder:

$ mkdir var
$ mkdir var/cache
$ mkdir var/logs
$ sudo chmod -R 777 var

/etc/apache2/sites-available

$ cp 000-default.conf e-commerce.conf

/etc/apache2/sites-available/e-commerce.conf

Listen 8080
Listen 8081

<VirtualHost 127.0.0.1:8080>
    ServerAdmin webmaster@e-commerce.dev
    ServerName e-commerce-session.dev
    ServerAlias www.e-commerce-session.dev

    DocumentRoot /home/paneric/Documents/php-dev/E-COMMERCE/e-commerce-session
    
    <Directory /home/paneric/Documents/php-dev/E-COMMERCE/>
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog /home/paneric/Documents/php-dev/E-COMMERCE/e-commerce-session/var/apache_error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

<VirtualHost 127.0.0.1:8081>
    ServerAdmin webmaster@e-commerce.dev
    ServerName e-commerce-session.dev
    ServerAlias www.e-commerce-session.dev

    DocumentRoot /home/paneric/Documents/php-dev/E-COMMERCE/e-commerce-session
    
    <Directory /home/paneric/Documents/php-dev/E-COMMERCE/>
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog /home/paneric/Documents/php-dev/E-COMMERCE/e-commerce-session/var/apache_error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>