PHPackages hrisproject/hris - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. hrisproject/hris ActiveProject[Utility & Helpers](/categories/utility) hrisproject/hris ================ Human Resource Information system 1713314[13 issues](https://github.com/hrisproject/hris/issues)[1 PRs](https://github.com/hrisproject/hris/pulls)PHP Since Nov 14Pushed 6y ago8 watchersCompare [ Source](https://github.com/hrisproject/hris)[ Packagist](https://packagist.org/packages/hrisproject/hris)[ RSS](/packages/hrisproject-hris/feed)WikiDiscussions master Synced today READMEChangelogDependenciesVersions (4)Used By (0) Human Resource Information System ================================= [](#human-resource-information-system) Human Resource Information System(HRIS) is a software that enables organisations to collect, validate, analyse and present raw and statistical human resource information for reporting, analysis and decision making. It is a generic software tool that allows customization to fit organization specific requirements, its built with open meta-data models and flexible and customizable user interface that allows user to adjust the system to peform, behave, look and feel based on organisation's specific requirements without the need for software development. For more information visit documentation site: HRIS is a free software; you can redistribute it and/or modify it under the terms of the GNU General Public License; either version 2 of the License, or (at your option) any later version. 1. Installing Hris Software --------------------------- [](#1-installing-hris-software) --- #### 1.1 Install through composer [](#11-install-through-composer) Composer is a dependency management library for PHP, it is an executable PHAR file which you can use to download hris3. Start by downloading composer anywhere onto your computer. If you have curl installed, it's as easy as: ``` curl -s https://getcomposer.org/installer | php ``` Or if you don't have curl: ``` php -r "eval('?>'.file_get_contents('https://getcomposer.org/installer'));" ``` For more information visit . Once you have composer downloaded you can install hris through: ``` php composer.phar create-project hrisproject/hris hris dev-master ``` After installation, composer will ask if you want to remove version control history(i.e. git) Default is yes, But If you're developing hris say no. Note: If downloading fails half-way(time-out or disconnected). Get into the already downloaded hris folder and continue downloading with composer update: ``` cd hris php composer.phar update ``` #### 1.2 Install source code from our [github repository](https://github.com/hrisproject/hris) [](#12-install-source-code-from-our-github-repository) ``` git clone https://github.com/hrisproject/hris.git ``` Update dependencies through composer. Change directory into hris project and make sure composer is up to date before updating hris project: ``` php composer.phar self-update php composer.phar update ``` Note: If downloading fails half-way(time-out or disconnected). Get into the already downloaded hris folder and continue downloading with composer update: ``` cd hris php composer.phar update ``` 2. Configuring Hris Software ---------------------------- [](#2-configuring-hris-software) To make hris project accessible from the web, make a symbolic link from your server's webroot to hris's web directory. To simplify you can change directory to where hris project is and make link. e.g. ``` cd /path/to/hris ln -s ${PWD}/web/ /var/www/hris #Note: ${PWD} is current directoyr(/path/to/hris) and /var/www/ is webroot ``` Note: If downloading fails half-way(time-out or disconnected). Get into the already downloaded hris folder and continue downloading with composer update: ``` php composer.phar update ``` ##### Hris depends on php5-intl for internationalization [](#hris-depends-on-php5-intl-for-internationalization) On Systems running Linux Operating systems run ``` sudo apt-get install php5-intl ``` On Systems running Mac OSX Operating systems run ``` brew install icu4c ``` Set date time zone of your server in php.ini, e.g in Dar-es-salaam, Tanzania ``` date.timezone = 'Africa/Dar_es_Salaam' ``` Turn off short\_open\_tag inside php.ini to disable detection of PHP codes between for better PHP >=5.3 Experience ``` short_open_tag = Off ``` Clear cache and logs and give Hris's Web directory readwrite access to cache and log directory in your hris directory. To enjoy both user and web read-write access in linux use the following commands: (We assume you're inside hris directory) ``` rm -rf app/cache/* rm -rf app/logs/* ``` On Mac and Systems supporting chmod +a, you can give readwrite permission via ``` sudo chmod +a "www-data allow delete,write,append,file_inherit,directory_inherit" app/cache app/logs sudo chmod +a "`whoami` allow delete,write,append,file_inherit,directory_inherit" app/cache app/logs ``` On Linux and Systems that don't support chmod +a, you can give readwrite permission via ``` sudo setfacl -R -m u:www-data:rwx -m u:`whoami`:rwx app/cache app/logs sudo setfacl -dR -m u:www-data:rwx -m u:`whoami`:rwx app/cache app/logs ``` Database configuration can be found from hris/app/config/parameters.yml. The parameters.yml is autogenerated everytime composer updates dependencies. Use it to set your database connection settings. ### Parameters.yml: [](#parametersyml) ``` database_driver: pdo_pgsql database_host: %databasehost% database_port: %portnumber% database_name: %databasename% database_user: %databaseuser% database_password: %userpassowrd% mailer_transport: smtp mailer_host: %mailerhost% mailer_user: null mailer_password: null locale: en secret: %secret_generated_key% database_path: null ``` Note: Make sure php data base connector is installed, for ubuntu it's php5-pgsql for PostgreSQL and php5-mysql for MySQL, for improved performance, php5-memcache, php5-memcached may come in handy. 3. Other useful tools for configuration and development ------------------------------------------------------- [](#3-other-useful-tools-for-configuration-and-development) Hris is built based on symfony2, thus all the utilies of symfony2 works on hris Below are some of useful tools during confiuration(we assume you're inside hris project) ### 3.1 Generating database [](#31-generating-database) ``` app/console doctrine:database:drop --force #Drops Database if it exist app/console doctrine:database:create #Creates Fresh new database app/console doctrine:schema:update --force #Updates Database schema app/console doctrine:fixtures:load #Load dummy data(users and hris metadata) ``` ### 3.2 Creating, Activating,Changing password, deactivate, demote & promote login-user from commandline [](#32-creating-activatingchanging-password-deactivate-demote--promote-login-user-from-commandline) ``` app/console fos:user:create #Create User account app/console fos:user:activate #Activate a user app/console fos:user:change-password #Change the password of a user. app/console fos:user:create #Create a user. app/console fos:user:deactivate #Deactivate a user app/console fos:user:demote #Demote a user by removing a role app/console fos:user:promote #Promotes a user by adding a role ``` ### 3.3 Regenerating assets [](#33-regenerating-assets) ``` app/console assetic:dump php app/console assets:install web ``` ### 3.4 Running development server (Works with php 5.5 or higher) [](#34-running-development-server-works-with-php-55-or-higher) ``` app/console server:run #Runs development server on port 8000 ``` ### Health Score 25 — LowBetter than 35% of packages Maintenance5 Infrequent updates — may be unmaintained Popularity21 Limited adoption so far Community28 Small or concentrated contributor base Maturity45 Maturing project, gaining track record Bus Factor2 2 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Community Maintainers ![](https://avatars.githubusercontent.com/u/250626?v=4)[John Francis Mukulu](/maintainers/mukulu)[@mukulu](https://github.com/mukulu) ![](https://avatars.githubusercontent.com/u/209589459?v=4)[hrisproject](/maintainers/hrisproject)[@HRISProject](https://github.com/HRISProject) --- Top Contributors [![mukulu](https://avatars.githubusercontent.com/u/250626?v=4)](https://github.com/mukulu "mukulu (602 commits)")[![fabpot](https://avatars.githubusercontent.com/u/47313?v=4)](https://github.com/fabpot "fabpot (576 commits)")[![yusuphk](https://avatars.githubusercontent.com/u/1510910?v=4)](https://github.com/yusuphk "yusuphk (157 commits)")[![ismailkoleleni](https://avatars.githubusercontent.com/u/3175406?v=4)](https://github.com/ismailkoleleni "ismailkoleleni (63 commits)")[![senyoni](https://avatars.githubusercontent.com/u/3169850?v=4)](https://github.com/senyoni "senyoni (63 commits)")[![leompande](https://avatars.githubusercontent.com/u/7592476?v=4)](https://github.com/leompande "leompande (46 commits)")[![Seldaek](https://avatars.githubusercontent.com/u/183678?v=4)](https://github.com/Seldaek "Seldaek (33 commits)")[![kelvinmbwilo](https://avatars.githubusercontent.com/u/2929755?v=4)](https://github.com/kelvinmbwilo "kelvinmbwilo (28 commits)")[![Tobion](https://avatars.githubusercontent.com/u/610090?v=4)](https://github.com/Tobion "Tobion (22 commits)")[![lepebina](https://avatars.githubusercontent.com/u/4909605?v=4)](https://github.com/lepebina "lepebina (17 commits)")[![brikou](https://avatars.githubusercontent.com/u/383212?v=4)](https://github.com/brikou "brikou (17 commits)")[![stealth35](https://avatars.githubusercontent.com/u/196110?v=4)](https://github.com/stealth35 "stealth35 (14 commits)")[![stof](https://avatars.githubusercontent.com/u/439401?v=4)](https://github.com/stof "stof (14 commits)")[![vicb](https://avatars.githubusercontent.com/u/248818?v=4)](https://github.com/vicb "vicb (11 commits)")[![chubwa](https://avatars.githubusercontent.com/u/6983368?v=4)](https://github.com/chubwa "chubwa (10 commits)")[![schmittjoh](https://avatars.githubusercontent.com/u/197017?v=4)](https://github.com/schmittjoh "schmittjoh (9 commits)")[![kriswallsmith](https://avatars.githubusercontent.com/u/33886?v=4)](https://github.com/kriswallsmith "kriswallsmith (9 commits)")[![weaverryan](https://avatars.githubusercontent.com/u/121003?v=4)](https://github.com/weaverryan "weaverryan (7 commits)")[![jalliot](https://avatars.githubusercontent.com/u/387904?v=4)](https://github.com/jalliot "jalliot (5 commits)")[![gajdaw](https://avatars.githubusercontent.com/u/676675?v=4)](https://github.com/gajdaw "gajdaw (5 commits)") ### Embed Badge ![Health badge](/badges/hrisproject-hris/health.svg) ``` [![Health](https://phpackages.com/badges/hrisproject-hris/health.svg)](https://phpackages.com/packages/hrisproject-hris) ``` ### Alternatives [oxid-esales/personalization-module Econda Personalization & Analytics module for the OXID eShop 174.8k](/packages/oxid-esales-personalization-module) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)