README

Deprecated: I suggest you to use https://github.com/andrebian/laminas-base instead.

A Zend Framework Bootstrap Application for multipurpose applications.

1 - Installing

1.1 - Creating a project with Composer

composer create-project -sdev andrebian-solucoes-web/zf-base path/to/installation

1.2 - Cloning repository

Clone this repository and remove the .git folder before start to code.

1.3 - Downloading Zip

Download the zip file and remove the .git folder before start to code.

Note

When installing dependencies with composer, some questions will appear.

 - Installing doctrine/doctrine-module (dev-master 57c0ee9): Cloning 57c0ee9586 from cache

 Please select which config file you wish to inject 'DoctrineModule' into:
 [0] Do not inject
 [1] config/development.config.php.dist
 Make your selection (default is 0):0

 Remember this option for other packages of the same type? (y/N)y

Just select the option "0". All project dependencies are already set in config/modules.config.php. Then select the option "y" to remember this decision for packages of the same type.

2 - Initializing the application

2.1 - Create a database

CREATE SCHEMA `your_db_name` DEFAULT CHARACTER SET utf8 COLLATE utf8_unicode_ci ;

2.2 - Set database config

Copy the file config/autoload/doctrine_orm.local.php.dist to config/autoload/doctrine_orm.local.php. After this edit the result file and set your database configurations.

# File config/autoload/doctrine_orm.local.php

return [
 'doctrine' => [
 'connection' => [
 'orm_default' => [
 'driverClass' => 'Doctrine\DBAL\Driver\PDOMySql\Driver',
 'params' => [
 'host' => 'host',
 'port' => '3306',
 'user' => 'user',
 'password' => 'password',
 'dbname' => 'dbname',
 'driverOptions' => [
 PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES 'UTF8'"
 ]
 ]
 ]
 ]
 ],
 'dbal' => [
 'types' => [
 'datetime' => \BaseApplication\Database\Mysql\CustomDateTimeType::class
 ]
 ]
];

2.3 - Update the schema

In composer.json has one configured command to update schema. This command was named as update-db.

composer update-db

The result is something like this:

composer update-db
> doctrine-module migrations:diff
Loading configuration from the integration code of your framework (setter).
Generated new migration class to "data/DoctrineORMModule/Migrations/Version20180722171236.php" from schema differences.
> doctrine-module migrations:migrate --no-interaction
Loading configuration from the integration code of your framework (setter).
 
 Doctrine Database Migrations 
 

Migrating up to 20180722171236 from 0

 ++ migrating 20180722171236

 -> CREATE TABLE user_users (id INT AUTO_INCREMENT NOT NULL, role_id INT DEFAULT NULL, name VARCHAR(255) NOT NULL, username VARCHAR(255) NOT NULL, password VARCHAR(60) NOT NULL, avatar LONGTEXT DEFAULT NULL, last_login DATETIME DEFAULT NULL, created DATETIME DEFAULT NULL, modified DATETIME DEFAULT NULL, active TINYINT(1) DEFAULT '1' NOT NULL, INDEX IDX_F6415EB1D60322AC (role_id), PRIMARY KEY(id)) DEFAULT CHARACTER SET utf8 COLLATE utf8_unicode_ci ENGINE = InnoDB
 -> CREATE TABLE user_roles (id INT AUTO_INCREMENT NOT NULL, name VARCHAR(255) NOT NULL, created DATETIME DEFAULT NULL, modified DATETIME DEFAULT NULL, active TINYINT(1) DEFAULT '1' NOT NULL, PRIMARY KEY(id)) DEFAULT CHARACTER SET utf8 COLLATE utf8_unicode_ci ENGINE = InnoDB
 -> CREATE TABLE user_password_recoveries (id INT AUTO_INCREMENT NOT NULL, user_id INT DEFAULT NULL, token VARCHAR(255) NOT NULL, created DATETIME DEFAULT NULL, modified DATETIME DEFAULT NULL, active TINYINT(1) DEFAULT '1' NOT NULL, INDEX IDX_7F8992A76ED395 (user_id), PRIMARY KEY(id)) DEFAULT CHARACTER SET utf8 COLLATE utf8_unicode_ci ENGINE = InnoDB
 -> ALTER TABLE user_users ADD CONSTRAINT FK_F6415EB1D60322AC FOREIGN KEY (role_id) REFERENCES user_roles (id)
 -> ALTER TABLE user_password_recoveries ADD CONSTRAINT FK_7F8992A76ED395 FOREIGN KEY (user_id) REFERENCES user_users (id)

 ++ migrated (0.61s)

 ------------------------

 ++ finished in 0.61s
 ++ 1 migrations executed
 ++ 5 sql queries
> git add data/DoctrineORMModule/Migrations/*.php

2.4 - Initialize fixtures

Now just initialize fixtures and your application is ready to run. Use the configured command fixtures-init.

composer fixtures-init
> ./vendor/bin/doctrine-module orm:fixtures:load
 > purging database
 > loading [0] User\Fixture\LoadRole
 > loading [1] User\Fixture\LoadUser

Have fun!

What this project does?

A set of common features to turn the development faster.

Which features were included?

BaseApplication Module

Assets: Form Elements

• NameField
• SaveButton
• FilterName

Avoid to write these elements every time.

Mysql Custom Types

• CustomDateTime

Filters

• CurrencyToFloat
• DateTime
• FloatVal

Helpers

• LicensePlateFormatter - at the moment only for brazilian cars
• PhoneFormatter - at the moment only for brazilian phone numbers
• PriceFormatter - at the moment only for BRL

Mail

An e-mail wrapper. Easily send transactional e-mails.

Validators

• NameAndLastName

View Helpers

• BrazilianStateHelper - Easily populate forms with Brazilian States
• JsonDecode - Decode json data in views. Useful for twig templates
• Slugify - Generates slugs by a given string
• Zap Loading - A Customizable WhatsApp Web loading clone

User Module

Assets

• Session Default namespace

Auth

• Customizable Auth Adapter

Fixtures

• First Role (admin)
• First Registered User as admin

Helper

• UserIdentity - fetch the authenticated user data in session

View Helper

• UserIdentity - one more view helper to fetch the authenticated user data in session

Running tests

composer test

License

MIT

Contributing