Redaxscript

Redaxscript is feature complete! Our goal is to refactor the deprecated codebase to an object oriented and modern approach.

Continuous integration

A bunch of frontend and backend tools run on Travis CI and Appveyor once a commit has been pushed.

Continuous inspection

Scrutenizer and Coveralls are our weapons of choice to keep track on the quality of our codebase.

Continuous deployment

We deploy our Demo on a daily basis from the master branch.

Edit on GitHub

General

We prefer the Allman style and tabs to indent code:

if ($hello === 'world')
{
	$output = 'hello';
}
else
{
	$output = 'world';
}

Styles

We prefer NCSS to give our PostCSS a semantic meaning:

.rs-text-hello
{
	&.rs-is-active
	{
		display: block;
	}
}

Edit on GitHub

Consider to use the docker container before spending hours to get your local environment running.

Install Git

Install Git on your local environment:

apt-get install git

Config Git

Config your name and email:

git config --global user.name {Your Name}

git config --global user.email {your.name@domain.com}

Install Node

Install Node on your local environment:

apt-get install nodejs

Install Grunt

Install Grunt on your local environment:

npm install --global grunt-cli

Install FontForge

Install FontForge on your local environment:

add-apt-repository ppa:fontforge/fontforge
apt-get update
apt-get install fontforge

Install PHP

Install PHP on your local environment:

apt-get install php php-cli php-dev

Install Composer

Install Composer on your local environment:

apt-get install composer

Install SQLite

Install the SQLite bundle on your local environment:

apt-get install sqlite3 php-sqlite3

Install MSSQL

Install the MSSQL bundle on your local environment:

apt-get install msodbcsql mssql-server unixodbc-dev

pecl install pdo_sqlsrv

Config MSSQL

Add the extension to your php.ini file:

extension=pdo_sqlsrv.so

Create a test database:

sqlcmd -U sa -P {your-password}

CREATE DATABASE test
GO

Install MySQL

Install the MySQL bundle on your local environment:

apt-get install mysql-server mysql-client php-mysql

Config MySQL

Create a test database:

mysql -u root -e 'create database test'

Set the root password:

mysqladmin -u root password test

Install PostgreSQL

Install the PostgreSQL bundle on your local environment:

apt-get install postgresql php-pgsql

Config PostgreSQL

Create a test database:

psql -U postgres -c 'create database test' 

Set the root password:

psql -U postgres -c 'alter user postgres with password '\'test\'

Install Xdebug

Install Xdebug on your local environment:

apt-get install php-xdebug

Install Sendmail

Install Sendmail on your local environment:

apt-get install sendmail

Tweak /etc/hosts if messages stuck in the Sendmail queue:

127.0.0.1 {your-hostname}.localdomain {your-hostname} localhost

Edit on GitHub

Install

Install the tools described in this section:

npm install

Serve

Serve local development server:

grunt serve [options]

--D, --debug-mode
--W, --webfont-compat
--O, --open-browser

Browse your working copy:

http://localhost:8000

Lint

Validate your CSS code for consistence:

grunt stylelint

grunt colorguard

Validate your JavaScript code for consistence:

grunt eslint

Validate your HTML code for consistence:

grunt ncsslint

grunt htmlhint

Build

Build styles, scripts and fonts at once:

grunt build

Build the styles:

grunt build-styles

Build the scripts:

grunt build-scripts

Build the fonts:

grunt build-fonts

Optimize

Create table of contents for your assets and optimize images:

grunt optimize

Edit on GitHub

Install

Install the tools described in this section:

npm install

composer install

Lint

Validate your PHP code for consistence:

grunt phpcpd

grunt phpcs

grunt phpstan

grunt phpmd

Test

Run the PHP testing suite:

grunt phpunit

Create a coverage report:

grunt phpunit --coverage-html {directory}

Run the PHP testing suite in parallel:

grunt phpunit-parallel

Run the PHP testing suite against your MSSQL database:

DB_URL=mssql://sa:test@127.0.0.1/test grunt phpunit

Run the PHP testing suite against your MySQL database:

DB_URL=mysql://root:test@127.0.0.1/test grunt phpunit

Run the PHP testing suite against your PostgreSQL database:

DB_URL=postgres://postgres:test@127.0.0.1/test grunt phpunit

Edit on GitHub

Terminal

Clone from GitHub:

git clone https://github.com/redaxscript/redaxscript-docker.git

Build the services:

docker-compose build

Create and start the containers:

docker-compose up

Run interactive shell inside the container:

docker exec -it redaxscript /bin/bash

Browser

Browse your working copy:

http://localhost:8080

Edit on GitHub