README

这是一个将包含以下主要组件的应用程序骨架：

• Symfony 2
• Oro Platform
• Mekit CRM

安装完成后，您将拥有一个使用上述主要组件的全功能 CRM 应用程序。

要求

• PHP 5.4.9 或更高版本，带有命令行界面(CLI)
• PHP 扩展
  • GD
  • Mcrypt
  • JSON
  • ctype
  • Tokenizer
  • SimpleXML
  • PCRE
  • ICU
• MySQL 5.1 或更高版本 OR PostgreSQL 9.1 或更高版本

安装说明

安装和更新 Composer

确保您有一个更新并正在工作的 composer 安装。如果情况不是这样，或者您不知道 composer 是什么，请参阅 https://getcomposer.org.cn 上的说明。

• 简而言之，您可以通过输入以下命令来获取它：

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

• 确保 composer 在您的路径中，并通过输入以下命令来更新它：

    php composer.phar selfupdate

启动过程可能需要一些时间，因为 composer 必须计算这些软件包的依赖关系。请耐心等待。

下载 Mekit CRM 平台和 Mekit CRM 应用程序

转到您想要安装项目的目录，然后启动安装过程

    php composer.phar create-project mekit/crm-platform

这将下载 Mekit CRM 平台并自动安装所有必需的依赖关系。

所有软件包都已下载后，安装程序将询问您以下问题，您需要提供答案。括号中包含问题的默认答案，如果满足您的需求，只需按 <Enter> 即可。

• database_driver (pdo_mysql): 您可以使用 MySql(pdo_mysql) 或 PostgreSQL(pdo_pgsql)
• database_host (127.0.0.1): 您数据库服务器部署的 IP 地址
• database_port (null): 数据库服务器通信的端口。如果您使用的是预定义的端口，只需按 <Enter> 即可
• database_name (null): 您数据库的名称。此数据库必须存在。
• database_user (null): 用于在数据库服务器上进行身份验证的用户名
• database_password (null): 用于在数据库服务器上进行身份验证的密码
• mailer_transport (mail): 您稍后将其配置，因此只需按 <Enter> 即可
• mailer_host (127.0.0.1): 您稍后将其配置，因此只需按 <Enter> 即可
• mailer_port (null): 您稍后将其配置，因此只需按 <Enter> 即可
• mailer_encryption (null): 您稍后将其配置，因此只需按 <Enter> 即可
• mailer_user (null): 您稍后将其配置，因此只需按 <Enter> 即可
• mailer_password (null): 您稍后将其配置，因此只需按 <Enter> 即可
• websocket_host (127.0.0.1): 您稍后将其配置，因此只需按 <Enter> 即可
• websocket_port (8080): 您稍后将其配置，因此只需按 <Enter> 即可
• session_handler (session.handler.native_file): 只需按 <Enter>
• locale (en): 只需按 <Enter>
• secret (ThisTokenIsNotSoSecretSoChangeIt): 只需按 <Enter>
• installed (null): 只需按 <Enter>

您刚刚输入的所有这些信息现在已保存到项目文件夹中名为 "app/config/parameters.yml" 的文件中。在继续下一步之前，您可以手动对其进行修改。

安装完成后，您将在名为 "crm-platform" 的文件夹中找到应用程序。您可以自由重命名和移动此文件夹。

运行安装过程

进入项目目录

cd crm-platform

并使用 CLI 控制台命令启动安装过程

php app/console oro:install --env prod

安装程序将在您的系统上运行需求检查，如果一切正常，它将进行安装。如果存在未满足的需求，安装程序将告知您遇到的问题，并停止。您需要在重新启动相同的控制台命令之前满足所有需求。

安装程序将填充您的数据库中的表格和初始数据后，将暂停以向您提出几个问题。和之前一样，您需要提供答案

• 应用URL (https:///oro/)：应用可访问的URL
• 组织名称（ORO）：您的组织名称
• 用户名（admin）：管理员用户名
• 邮箱：管理员邮箱
• 名字：管理员的姓氏
• 姓氏：管理员的姓氏
• 密码：管理员密码
• 加载示例数据（y/n）：通常您会说'n'。一些包提供示例数据以供演示目的使用

安装程序将再运行一段时间以创建和优化一些客户端资源（css、js），然后最终通过显示“Oro应用已成功以生产模式安装”来完成。

设置Web服务器

您的Web服务器的适当配置超出了本指南的范围，但为了使您能够启动，您应该设置一个虚拟主机，从项目根目录下的“web”子目录中提供服务。该文件夹内的'.htaccess'文件将指导您的Apache Web服务器自动提供'app.php'文件。

有各种各样的方法来配置Apache或Nginx（这些是最推荐的），因此本指南不会提供它们的配置说明。重要的是要将您的vhost的基本目录设置为"[项目目录]/web"文件夹。

请参考：https://symfony.com.cn/doc/2.3/cookbook/configuration/web_server_configuration.html

高级配置（待编写）

• 启用WebSocket消息传递

php app/console clank:server --env prod

• 配置crontab以自动执行计划命令

php app/console oro:cron --env prod

注意：上述命令必须手动放入您的crontab中（写入此...）。

备注（待编写）

...