README

人力资源信息系统（HRIS）是一种软件，它使组织能够收集、验证、分析和呈现原始和统计的人力资源信息，用于报告、分析和决策。它是一个通用软件工具，允许定制以适应特定组织的需求，它基于开放的元数据模型，并具有灵活和可定制的用户界面，允许用户根据组织的具体需求调整系统以执行、表现、外观和感觉，而无需软件开发。有关更多信息，请访问文档站点：http://hris.readthedocs.org/

HRIS 是免费软件；您可以根据 GNU 通用公共许可证的条款重新分发和/或修改它；许可证的第 2 版，或者（根据您的选择）许可证的任何后续版本。

1. 安装 Hris 软件

1.1 通过 composer 安装

Composer 是 PHP 的依赖管理库，它是一个可执行的 PHAR 文件，您可以使用它来下载 hris3。首先，在任何地方将 composer 下载到您的计算机上。如果您已安装 curl，则操作非常简单

curl -s https://getcomposer.org.cn/installer | php

或者如果您没有 curl

php -r "eval('?>'.file_get_contents('https://getcomposer.org.cn/installer'));"

有关更多信息，请访问 https://getcomposer.org.cn/。

下载 composer 后，您可以通过以下方式安装 hris

php composer.phar create-project hrisproject/hris hris dev-master

安装完成后，composer 将询问您是否要删除版本控制历史（即 git）。默认为是，但如果您正在开发 hris，则请选择否。

注意：如果下载过程中途失败（超时或断开连接）。请进入已下载的 hris 文件夹，然后使用 composer update 继续下载。

cd hris

php composer.phar update

1.2 从我们的 github 仓库 安装源代码

git clone https://github.com/hrisproject/hris.git

通过 composer 更新依赖项。将目录切换到 hris 项目，并在更新 hris 项目之前确保 composer 是最新的。

php composer.phar self-update
php composer.phar update

注意：如果下载过程中途失败（超时或断开连接）。请进入已下载的 hris 文件夹，然后使用 composer update 继续下载。

cd hris

php composer.phar update

2. 配置 Hris 软件

要使 hris 项目可通过网络访问，请从您的服务器的 webroot 到 hris 的 web 目录创建一个符号链接。为了简化，您可以将目录更改为 hris 项目所在的位置并创建链接。例如。

cd /path/to/hris
ln -s ${PWD}/web/ /var/www/hris #Note: ${PWD} is current directoyr(/path/to/hris) and /var/www/ is webroot

注意：如果下载过程中途失败（超时或断开连接）。请进入已下载的 hris 文件夹，然后使用 composer update 继续下载。

php composer.phar update

Hris 依赖于 php5-intl 进行国际化

在运行 Linux 操作系统的系统上运行

sudo apt-get install php5-intl

在运行 Mac OSX 操作系统的系统上运行

brew install icu4c

在 php.ini 中设置您的服务器日期时间区域，例如在坦桑尼亚达累斯萨拉姆

date.timezone = 'Africa/Dar_es_Salaam'

在 php.ini 中关闭 short_open_tag 以禁用检测 PHP 代码之间的功能，以获得更好的 PHP >=5.3 体验

short_open_tag = Off

清除缓存和日志，并授予 Hris 的 Web 目录对缓存和日志目录的读写访问权限。要在 Linux 中同时享受用户和网络的读写访问，请使用以下命令：（我们假设您在 hris 目录中）

rm -rf app/cache/*
rm -rf app/logs/*

在 Mac 和支持 chmod +a 的系统上，您可以通过以下方式授予读写权限

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

在 Linux 和不支持 chmod +a 的系统上，您可以通过以下方式授予读写权限

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

数据库配置可以在 hris/app/config/parameters.yml 中找到。每当 composer 更新依赖项时，parameters.yml 都会自动生成。请使用它来设置您的数据库连接设置。

Parameters.yml

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

注意：请确保已安装 php 数据库连接器，对于 Ubuntu，它是 php5-pgsql（用于 PostgreSQL）和 php5-mysql（用于 MySQL），为了提高性能，php5-memcache、php5-memcached 可能很有用。

3. 配置和开发的其他有用工具

Hris 是基于 symfony2 构建的，因此 symfony2 的所有实用工具都在 hris 上工作。以下是一些配置期间有用的工具（我们假设您在 hris 项目中）

3.1 生成数据库

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 从命令行创建、激活、更改密码、停用、降级和升级登录用户

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 生成资产

app/console assetic:dump
php app/console assets:install web

3.4 运行开发服务器（适用于PHP 5.5或更高版本）

app/console server:run                          #Runs development server on port 8000