Code Monkey home page Code Monkey logo

orangehrm-dev-environment's Introduction

OrangeHRM Development Environment

Docker Automated Docker Status Docker Pulls Build Status BCH compliance

Introduction

orangehrm-dev-environment is a dockerized development environment for OrangeHRM. This dev environment mainly contains three layers as follows,

  • Proxy Layer
  • Web Layer
  • Database Layer

Configurations in each layer have been added according to the OrangeHRM application requirements.

Prerequisites

Architecture

OrangeHRM Dev Environment Architecture

How to use ?

The Dev environment has been configured to use 443 port as the default web port. So make sure that the 443 port of your host machine is been used by none of the other services (eg:- apache, tomcat, nginx, etc).

Installation
  1. Download the zip
  2. Extract the zip anywhere you want
  3. run the command docker-compose up -d. This will up the basic OrangeHRM dev environment (PHP 5.6, PHP 7.1, PHP 7.2, nginx, phpmyadmin, RabbitMQ, MySQL 5.5 and MariaDB 10.2 containers).
  4. For a customized docker development environment, See the section "How to use custom containers?".
Host an instance

After the installation add below URLs to your /etc/hosts file.

  • phpmyadmin.orangehrmdev.com
  • rabbitmq.orangehrmdev.com
Enterprise Hosting
  • You can NAME your instance directory as you like (Please do not use SPACES)
  • Document Root: /var/www/html/OHRMStandalone/TEST
  • Use different environments
    • web56: NAME.test-web56.orangehrmdev.com
    • web71: NAME.test-web71.orangehrmdev.com
    • web72: NAME.test-web72.orangehrmdev.com
    • web73: NAME.test-web73.orangehrmdev.com
Opensource Hosting
  • You can NAME your instance directory as you like (Please do not use SPACES)
  • Document Root: /var/www/html/OHRMStandalone/OPENSOURCE
  • Use different environments
    • web56: NAME.os-web56.orangehrmdev.com
    • web71: NAME.os-web71.orangehrmdev.com
    • web72: NAME.os-web72.orangehrmdev.com
    • web73: NAME.os-web73.orangehrmdev.com

Replace the NAME with any name you want for your instance.

Containers

Container Name Service Name in docker-compose.yml Description IP Address Ports (Inside the Container) Ports (Host Machine)
nginx nginx PHP 5.6 10.5.2.1 443 443
dev_web_56 web56 PHP 5.6 10.5.0.56 443 -
dev_web_71 web71 PHP 7.1 10.5.0.71 443 -
dev_web_72 web72 PHP 7.2 10.5.0.72 443 -
dev_web_73 web73 PHP 7.3 10.5.0.73 443 -
dev_mysql_57 db57 MySQL 5.7 10.5.1.57 3306 -
dev_mariadb_102 db102 MariaDB 10.2 10.5.1.102 3306 -
dev_phpmyadmin phpmyadmin phpMyAdmin 10.5.2.2 80 -
dev_rabbitmq rabbitmq RabbitMQ 3.6 10.5.2.3 15671,5671 15671

How to add custom PHP configurations

  • Add custom PHP configurations to the file ./config/<WEB_CONTAINER>/php/custom_php.ini. And then reload the apache service (inside the relevant container). WEB_CONTAINER can be web71, web72, web56 ,etc.

How to run composer update - inside a web container

Use following command if you want to run composer install/update

php -d allow_url_fopen=on /usr/local/bin/composer install

How to use custom containers?

  • Compose files for custom containers have been located under ./custom-compose directory. Run php env-start.php and select the "Custom Environment" option. Then select the containers you need as you wish (Use ARROW_KEYS to move up and down and press SPACE to do the selection. And press ENTER to continue.).

  • Available custom containers

    • db55 - MySQL 5.5
    • db56 - MySQL 5.6
    • ldap - openldap and phpldapadmin
    • mariadb103 - MariaDB 10.3
    • mongodb - mongo DB Database
    • oracle11 - Oracle 11 Database
    • ubuntuweb71 - Ubuntu 18.04 PHP 7.1 container
    • web 54 - CentOS 7 PHP 5.4 container
    • web 70 - CentOS 7 PHP 7.0 container
    • web 74 - CentOS 7 PHP 7.4 container
    • xhgui - XhGUI profiling tool

  • Moving from custom version to basic version - docker-compose up -d --remove-orphans

orangehrm-dev-environment's People

Contributors

chanakar avatar charithra7 avatar deefernando6 avatar lgtkaushalya avatar nipuna-sankalpa avatar pasindu07 avatar rshariffdeen avatar rtamarasinghe avatar shanrahul avatar thulana avatar

Stargazers

avatar avatar avatar avatar avatar avatar avatar

Watchers

avatar avatar avatar avatar avatar avatar

Forkers

thulana charithra7 manojpsw apamwach hsvikum chanakar jdkelley messi655 thnzrmzwr rtamarasinghe uththara1 pasindu07 cromarti lahirunirmalx tjohn23 deefernando6 iamrdb2f kale1d0code

orangehrm-dev-environment's Issues

phing is missing in centos based images

phing is not installed in the centos based images (5.6).

earlier development images had the following in their docker file to install phing

RUN pear channel-discover pear.phing.info &&
pear install VersionControl_SVN-alpha &&
pear install phing/phing-2.6.1

Pre-requisite update

Docker Compose is a pre-requisite but not mentioned. Its better to mention with the minimum version required for both Docker and Docker Compose

warning comes with libmcrypt

PHP Warning: PHP Startup: Unable to load dynamic library '/usr/local/lib/php/extensions/no-debug-non-zts-20121212/mcrypt.so' - libmcrypt.so.4: cannot open shared object file: No such file or directory in Unknown on line 0

When I run PHP file in command line, inside dev_web_55 above warning appear

Unable To Find Pages

I have made custom style changes in the code and have also attached pictures that are running.
I want to add custom field and remove some but unable to find the codes to the pages HTML. Would appreciate if someone can help me find the location to the files of the webpages.

Change Port Mappings and IPs to values easier to remember

Suggestion:
web55:

  • ports: "9055:443"
  • ipv4_address: 10.5.0.55

web56

  • ports: "9056:443"
  • ipv4_address: 10.5.0.56

web70

  • ports: "9070:443"
  • ipv4_address: 10.5.0.70

web71

  • ports: "9071:443"
  • ipv4_address: 10.5.0.71

I don't have any suggestions for DB related containers.

Readme update

replace docker-compose up -d command with docker compose up -d in the README.md file.

ioncube loader is not added to PHP 7.1 php.ini

File: orangehrm-dev-environment/config/web71/php/php.ini

Following line needs to be added:
zend_extension=/usr/local/lib/php/extensions/no-debug-non-zts-20121212/ioncube_loader_lin_7.1.so

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.